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
41 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 — 27 ferramentas
Estas apenas consultam. Elas retornam seus próprios dados e não alteram nada.
detect_localesShow the languages detected on one of your sites.
get_ai_visibilityThe site's AI-visibility report, query by query: per language and engine (Google AI Overviews, Google AI Mode, ChatGPT, Gemini, Perplexity), how often AI answers cite your site or mention your brand over the last 4 weeks (k of n) with a paired trend, plus every tracked query's latest result, cited URLs and history.
get_analyticsGoogle Analytics 4 report for one of your sites.
get_analytics_realtimeGA4 realtime active users, by country and page.
get_articleLook 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_impactSEO + GEO impact deltas/trend for one article vs. its pre-publish baseline.
get_audit_findingsPAGINATED — 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_performanceBing Webmaster traffic, per-page stats, and crawl stats for one of your sites.
get_calendarPAGINATED — 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_content_planA site's content plan: without locale, where each language stands; with locale, that language page by page (the page's own keyword, its topics, what is already scheduled, what was left out and why).
get_fix_promptGet a ready-to-paste remediation prompt for a finding type.
get_geo_summaryLive GA4 rollup of AI-assistant referral traffic (ChatGPT, Perplexity, Gemini, Claude, Copilot, You.com).
get_impact_reportThe site's impact report: clicks/impressions/avg position for the last 28 days vs. the prior 28 days, counting ONLY the URLs of articles this account published (never a customer's pre-existing pages).
get_index_statusStored Google index verdicts for one of your sites' articles.
get_indexnow_setupShow 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_schemasGet 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_metricsThe STORED search metrics for one keyword on one of your sites (volume, competition, CPC, difficulty, market, source, measured-at).
get_keywordsPAGINATED — 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_performanceGoogle Search Console performance for one of your sites (clicks, impressions, CTR, position).
get_site_speedThe last stored PageSpeed Insights check (mobile + desktop).
get_usageShow this month's action usage for one of your sites — what each limit counts, used/total, reset date.
list_auditsList recent audit runs for one of your sites.
list_rivalsThe rivals YOU named (up to 10) and how you compare over the last four weeks of AI answers.
list_sitesList every site this token can reach: a token acts as the person who created it, so these are the sites that person can open in the dashboard, across every account they belong to (a restricted teammate sees only the sites shared with them), each with its account, your role there, and its latest audit scores (foundation + AI-readiness).
list_tracked_questionsThe questions YOU asked us to track in AI answers (up to 10 per language), each with its latest result per engine: answered (with whether your brand was mentioned and your site linked) or no answer shown.
remove_rivalStop comparing with a rival.
remove_tracked_questionStop tracking one of your questions.
Gravação — 14 ferramentas
Estas alteram algo: adicionam um site, planejam um calendário, publicam ou excluem. A maioria requer confirmação (abaixo); todas são limitadas aos sites que você pode abrir.
add_rivalName a rival to compare with in AI answers: a name (2 to 60 characters) and optionally its website, reduced to its domain (it may not be your own).
add_siteAdd a new site, by its URL, to the account this token was created in (owner or admin only): crawls it and builds its brand profile.
add_tracked_questionTrack one more question in AI answers for a language of the site.
connect_publishAdd a publish destination for a site: a WordPress site, a webhook, a Ghost site, a Webflow CMS collection, a Shopify store or a Wix site (the last two return an install link).
create_focuspede confirmaçãoConcentrate the next days on a new feature (other articles of that language mention it) or a newly launched language, without adding articles.
delete_articlepede confirmaçãoPermanently delete one article, or every non-primary translation of a group.
generate_calendarpede confirmaçãoPlan a content calendar for one of your sites.
launch_localepede confirmaçãoRe-run market research for one of this site's already-enabled languages.
publish_articlepede confirmaçãoPublish a DRAFT article to the site's connected destination.
publish_translationspede confirmaçãoCascade-publish a whole translation group: the primary plus every draft sibling.
recrawl_siteRe-learn one of your sites: re-read it and refresh its brand profile and brand colors.
refresh_locale_keywordspede confirmaçãoRefresh a non-primary language's keyword ideas: replace the ones not yet on your calendar with freshly researched ones.
reschedule_itemMove a PLANNED calendar item to a new publish date.
update_site_profileComplete or edit a site's onboarding / brand profile, switch Autopilot on or off (publishMode), and (admin-only) set its publishing schedule.
Antes de qualquer alteração
Toda ação pede sua confirmação primeiro.
As ferramentas que alteram seu site ou consomem parte do seu limite mensal 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. Apenas uma segunda chamada com confirm:true executa o trabalho. Seu assistente mostra a prévia entre elas, impedindo que um agente publique ou consuma seu limite silenciosamente.
O que a primeira chamada retorna
{
"confirm_required": true,
"message": "This will publish “How to split rent” to example.com's connected destination.
Call publish_article again with confirm:true to proceed."
}Um pequeno grupo de ferramentas de gravação não exige confirmação por serem leves e reversíveis — adicionar um site, rastreá-lo novamente, editar seu perfil, mover um item do calendário. Nenhuma ferramenta que publica está nesse grupo.
Obtenha seu token
Gere um token, apenas uma vez.
Cada cliente abaixo se autentica com a mesma coisa: um token pessoal que age em seu nome. 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.
Seu acesso, e apenas seu
Um token age em seu nome: ele acessa todos os sites que você já pode abrir no painel, na sua própria conta e em qualquer conta a que pertença, com a função que você possui em cada uma. Nenhuma ferramenta aceita um account id como argumento, portanto um cliente com seu token não pode acessar os dados de mais ninguém, nem mesmo se pedir por eles.
Gravações exigem confirmação, não são bloqueadas
Esta não é uma integração somente leitura: 14 das 41 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.
