O ciclo para o qual isso foi feito

Auditoria → prompt de correção → seu agente de programação.

get_fix_prompt retorna uma instrução escrita para um agente de programação, e não um checklist humano: o que o resultado significa, como corrigi-lo e a gravidade e área afetadas. Seu assistente lê um resultado da sua auditoria, solicita seu prompt de correção e o aplica ao repositório que já está aberto — a auditoria e o código nunca saem do seu editor.

1
Execute uma auditoria gratuita no seu site — nenhuma conta necessária.
2
Conecte o servidor MCP com seu token (abaixo).
3
Peça ao seu assistente para extrair um resultado e seu prompt de correção, e aplicá-lo.

Importante saber

As auditorias são iniciadas no painel — nenhuma ferramenta MCP inicia uma. Via MCP, você lê as execuções e seus resultados. Um prompt de correção é uma orientação para seu agente, por tipo de resultado; não é um patch pronto, e seu agente ainda precisa fazer e verificar a alteração.

O que você recebe

39 ferramentas que seu assistente pode chamar.

Depois de conectado, seu CLI de programação com IA pode solicitar ao UPGeoSEO seus sites, auditorias e correções — e agir sobre eles. A lista abaixo é gerada pelo próprio servidor, portanto é o que está realmente registrado hoje, e não um resumo escrito no passado.

Leitura — 22 ferramentas

Estas apenas consultam. Elas retornam seus próprios dados e não alteram nada.

detect_locales
Show the languages detected on one of your sites.
get_ai_visibility
The site's most recent completed AI-visibility probe cycle rates.
get_analytics
Google Analytics 4 report for one of your sites.
get_analytics_realtime
GA4 realtime active users, by country and page.
get_article
Look up one article by id: its title, language, status, whether it is the PRIMARY or a translation, slug, live URL, image refs, SEO score, and its whole translation group.
get_article_impact
SEO + GEO impact deltas/trend for one article vs.
get_audit_findings
PAGINATED — returns at most `limit` findings (default 50, max 200) with `page.hasMore` and `page.nextOffset`; read `summary` for totals by severity and type, then page with `offset`.
get_bing_performance
Bing Webmaster traffic, per-page stats, and crawl stats for one of your sites.
get_calendar
PAGINATED — the content calendar for one of your sites: each slot's scheduled date, TARGET KEYWORD (with its volume/competition), locale, role, intent, and the article it produced.
get_fix_prompt
Get a ready-to-paste remediation prompt for a finding type.
get_geo_summary
Live GA4 rollup of AI-assistant referral traffic (ChatGPT, Perplexity, Gemini, Claude, Copilot, You.com).
get_impact_report
The site's impact report: clicks/impressions/avg position for the last 28 days vs.
get_index_status
Stored Google/Bing index verdicts for one of your sites' articles.
get_indexnow_setup
Show the IndexNow verification file one of your sites must serve so Bing, Yandex, Seznam and Naver accept the URLs we submit on your behalf.
get_integration_schemas
Get JSON Schema for everything UPGeoSEO emits to your own systems (Article, WebhookPublishPayload, RssItem, StructuredData, TranslationGroup) plus the MCP tool index and per-channel integration guides.
get_keyword_metrics
The STORED search metrics for one keyword on one of your sites (volume, competition, CPC, difficulty, market, source, measured-at).
get_keywords
PAGINATED — the keywords discovered for one of your sites, with volume, competition, difficulty, intent, source, and whether each is already scheduled on the calendar.
get_search_performance
Google Search Console performance for one of your sites (clicks, impressions, CTR, position).
get_site_speed
The last stored PageSpeed Insights check (mobile + desktop).
get_usage
Show this month's action usage for one of your sites — what each limit counts, used/total, reset date.
list_audits
List recent audit runs for one of your sites.
list_sites
List the sites in your account, with each site's id, URL, and latest audit scores (foundation + AI-readiness).

Gravação — 17 ferramentas

Estas alteram algo: adicionam um site, planejam um calendário, escrevem, traduzem, publicam ou excluem. A maioria exige confirmação (abaixo); todas estão limitadas à sua própria conta.

add_site
Add a new site to your account by its URL: crawls it and builds its brand profile.
connect_publish
Add a publish destination for a site: a WordPress site or a webhook.
create_focuspede confirmação
Concentrate promotion on a new feature (sourced through real demand; the feature name is never the keyword; other articles of that language mention it) or a newly launched language, without adding articles.
delete_articlepede confirmação
Permanently delete one article, or every non-primary translation of a group.
generate_articlepede confirmação
Write ONE article now for a site (inline, ~30-60s).
generate_articles_bulkpede confirmação
Enqueue many background article-generate jobs at once (returns immediately).
generate_calendarpede confirmação
Plan a content calendar for one of your sites.
launch_localepede confirmação
Re-run native content research for one of this site's already-enabled languages.
publish_articlepede confirmação
Publish a DRAFT article to the site's connected destination.
publish_translationspede confirmação
Cascade-publish a whole translation group: the primary plus every draft sibling.
recrawl_site
Re-learn one of your sites: re-crawl it and refresh the crawl-derived brand profile and brand colors.
refresh_locale_keywordspede confirmação
Refresh a non-primary locale's keyword ideas: purge unscheduled backlog keywords and re-discover fresh native ones.
refresh_og_imagespede confirmaçãoapenas admin
ADMIN ONLY.
reschedule_item
Move a PLANNED calendar item to a new publish date.
research_keywordspede confirmaçãoapenas admin
ADMIN ONLY.
translate_articlepede confirmação
Translate an existing article into the site's other enabled languages (background jobs).
update_site_profile
Complete or edit a site's onboarding / brand profile and (admin-only) its publishing schedule.

Antes de qualquer alteração

Toda ação pede sua confirmação primeiro.

As ferramentas que gastam créditos ou alteram seu site usam um fluxo de duas chamadas. A primeira chamada não altera nada — ela retorna uma prévia exata do que aconteceria e um aviso de que a confirmação é necessária. Somente uma segunda chamada contendo confirm:true executa o trabalho. Seu assistente mostra a prévia nesse intervalo, para que nenhum agente publique ou gaste silenciosamente em seu nome.

O que a primeira chamada retorna

{
  "confirm_required": true,
  "message": "This will generate 1 article for example.com …
              Call generate_article again with confirm:true to proceed."
}

Algumas ferramentas de gravação não exigem confirmação por serem simples e reversíveis — adicionar um site, rastreá-lo novamente, editar seu perfil, mover um item do calendário. Nada que publique ou gaste créditos está nesse grupo.

Obtenha seu token

Gere um token, apenas uma vez.

Todos os clientes abaixo se autenticam da mesma forma: um token pessoal que define o acesso à sua conta. Veja onde obtê-lo.

Entre na sua conta UPGeoSEO (ou crie uma — é grátis para começar).

Abra Painel → Seu perfil e localize o card Acesso à API (MCP).

Clique em Gerar token. Copie agora — ele começa com ugs_live_ e é exibido apenas uma vez.

Conecte seu cliente

Aponte seu CLI de programação com IA para o servidor.

O UPGeoSEO utiliza o padrão MCP sobre Streamable HTTP com autenticação bearer, funcionando com qualquer cliente que suporte um servidor HTTP remoto e cabeçalho customizado. Escolha o seu abaixo e substitua YOUR_TOKEN pelo token gerado.

Claude Code (CLI)

Um único comando para adicionar — execute de qualquer lugar:

claude mcp add --transport http upgeoseo \
  https://app.upgeoseo.com/api/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Cursor

Adicione uma entrada em ~/.cursor/mcp.json (global) ou .cursor/mcp.json no seu projeto:

// ~/.cursor/mcp.json  (or .cursor/mcp.json in your project)
{
  "mcpServers": {
    "upgeoseo": {
      "url": "https://app.upgeoseo.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Windsurf

Adicione ao mcp_config.json do Windsurf com o mesmo formato de url + headers:

// Windsurf → mcp_config.json
{
  "mcpServers": {
    "upgeoseo": {
      "url": "https://app.upgeoseo.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Nota: algumas versões do Windsurf nomeiam o campo como serverUrl em vez de url. Se url não funcionar, renomeie apenas essa chave — todo o resto permanece igual.

Cline e outras extensões MCP do VS Code

Adicione um servidor ao seu .mcp.json (ou às configurações de MCP da extensão), url + headers como de costume:

// .mcp.json (or your MCP extension's settings)
{
  "mcpServers": {
    "upgeoseo": {
      "url": "https://app.upgeoseo.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Qualquer outro cliente MCP — os detalhes essenciais

Se o seu cliente for compatível com um servidor MCP HTTP remoto com cabeçalhos personalizados, funciona. Ele só precisa de três coisas:

Transporte: Streamable HTTP
Endpoint: https://app.upgeoseo.com/api/mcp
Autenticação: Cabeçalho HTTP Authorization: Bearer <token>

Os caminhos exatos dos arquivos de configuração e os nomes dos campos variam de acordo com o cliente e a versão. A constante é sempre a mesma: a URL acima, mais o cabeçalho Authorization: Bearer com o seu token.

Experimente

Depois de conectado, basta perguntar.

Você não precisa chamar as ferramentas pelo nome — apenas fale com seu assistente, e ele as selecionará. Algumas sugestões para testar:

“Liste os meus sites.”

“Mostre os apontamentos abertos para example.com.”

“Obtenha o prompt de correção para h1_missing e aplique-o a este repositório.”

Segurança

Restrito a você, exige confirmação, revogável.

Sua conta, e apenas sua

Um token está vinculado a uma única conta. Cada ferramenta obtém os IDs de site da sua própria conta e nenhuma ferramenta aceita um ID de conta como argumento, portanto, um cliente com seu token não pode acessar os dados de mais ninguém — mesmo que solicite.

Gravações exigem confirmação, não são bloqueadas

Esta não é uma integração somente leitura: 17 das 39 ferramentas alteram algo. O que protege você é a etapa de confirmação, os limites mensais do seu plano e o fato de que a publicação passa pelas mesmas verificações do painel.

Revogue a qualquer momento

Exclua um token no mesmo card API access (MCP) sempre que desejar. Uma vez revogado, qualquer cliente que ainda o utilize deixará de funcionar imediatamente.

Exibido apenas uma vez

Mostramos o novo token apenas uma vez, na geração. Se você o perder, não será possível recuperá-lo — será necessário gerar um novo e substituí-lo.

Execute seu SEO direto do o seu editor.