El flujo para el que fue diseñado
Auditoría → fix-prompt → tu agente de código.
get_fix_prompt devuelve una instrucción redactada para un agente de código, no una lista de verificación para humanos: qué significa el hallazgo, cómo solucionarlo, y la gravedad y el área a la que afecta. Tu asistente lee un hallazgo de tu auditoría, solicita su fix-prompt y lo aplica al repositorio que ya tiene abierto — la auditoría y el código nunca salen de tu editor.
- 1
Ejecuta una auditoría gratuita en tu sitio — no se necesita cuenta.
- 2
Conecta el servidor MCP con tu token (abajo).
- 3
Pídele a tu asistente que obtenga un hallazgo y su fix-prompt, y que lo aplique.
Importante saber
Las auditorías se inician en el panel de control — ninguna herramienta MCP inicia una. A través de MCP consultas las ejecuciones y sus hallazgos. Un fix-prompt es una guía para tu agente, por tipo de hallazgo; no es un parche, y tu agente aún debe realizar y verificar el cambio.
Lo que obtienes
41 herramientas que tu asistente puede ejecutar.
Una vez conectado, tu CLI de programación con IA puede consultar a UPGeoSEO sobre tus sitios, auditorías y correcciones — y actuar en consecuencia. La lista que aparece a continuación se genera directamente desde el servidor, por lo que refleja lo que está registrado hoy, no un resumen redactado una sola vez.
Lectura — 27 herramientas
Estas solo consultan. Devuelven tus propios datos y no modifican 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.
Escritura — 14 herramientas
Estas modifican algo: añaden un sitio, planifican un calendario, publican o eliminan. La mayoría pide confirmación (más abajo); todas se limitan a los sitios que puedes 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_focuspide confirmaciónConcentrate the next days on a new feature (other articles of that language mention it) or a newly launched language, without adding articles.
delete_articlepide confirmaciónPermanently delete one article, or every non-primary translation of a group.
generate_calendarpide confirmaciónPlan a content calendar for one of your sites.
launch_localepide confirmaciónRe-run market research for one of this site's already-enabled languages.
publish_articlepide confirmaciónPublish a DRAFT article to the site's connected destination.
publish_translationspide confirmaciónCascade-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_keywordspide confirmaciónRefresh 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 que algo cambie
Cada acción te pide confirmación primero.
Las herramientas que modifican tu sitio o consumen parte de tu cuota mensual usan un flujo de dos llamadas. La primera llamada no cambia nada: devuelve una vista previa exacta de lo que ocurriría y una nota indicando que se requiere confirmación. Solo una segunda llamada que incluya confirm:true ejecuta el trabajo. Tu asistente te muestra la vista previa entre medias, para que ningún agente pueda publicar en silencio ni consumir tu cuota en tu nombre.
Lo que devuelve la primera llamada
{
"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."
}Un puñado de herramientas de escritura no requieren confirmación porque son de bajo coste y reversibles: añadir un sitio, volver a rastrearlo, editar su perfil o mover un elemento del calendario. Nada de lo que publica está en ese grupo.
Consigue tu token
Genera un token, una sola vez.
Todos los clientes que figuran abajo se autentican con lo mismo: un token personal que actúa en tu nombre. Aquí tienes dónde conseguirlo.
Inicia sesión en tu cuenta de UPGeoSEO (o crea una — empezar es gratis).
Abre Panel → Tu perfil y busca la tarjeta API access (MCP).
Haz clic en Generate token. Cópialo ahora — empieza por ugs_live_ y solo se muestra una vez.
Conecta tu cliente
Apunta tu CLI de codificación con IA al servidor.
UPGeoSEO habla MCP estándar sobre Streamable HTTP con auth bearer, así que funciona con cualquier cliente que admita un servidor HTTP remoto y una cabecera personalizada. Elige el tuyo abajo y sustituye YOUR_TOKEN por el token que generaste.
Claude Code (CLI)
Un solo comando lo añade — ejecútalo desde cualquier sitio:
claude mcp add --transport http upgeoseo \
https://app.upgeoseo.com/api/mcp \
--header "Authorization: Bearer YOUR_TOKEN"Cursor
Añade una entrada a ~/.cursor/mcp.json (global) o .cursor/mcp.json en tu proyecto:
// ~/.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
Añádelo al mcp_config.json de Windsurf con la misma estructura url + headers:
// Windsurf → mcp_config.json
{
"mcpServers": {
"upgeoseo": {
"url": "https://app.upgeoseo.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}Nota: algunas versiones de Windsurf llaman al campo serverUrl en vez de url. Si url no funciona, renombra esa única clave — todo lo demás sigue igual.
Cline y otras extensiones MCP de VS Code
Añade un servidor a tu .mcp.json (o a los ajustes MCP de la extensión), url + headers como siempre:
// .mcp.json (or your MCP extension's settings)
{
"mcpServers": {
"upgeoseo": {
"url": "https://app.upgeoseo.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}Cualquier otro cliente MCP — los datos en crudo
Si tu cliente admite un servidor MCP HTTP remoto con cabeceras personalizadas, funciona. Las únicas tres cosas que necesita:
- Transporte: Streamable HTTP
- Endpoint:
https://app.upgeoseo.com/api/mcp - Auth: Cabecera HTTP
Authorization: Bearer <token>
Las rutas exactas de los archivos de configuración y los nombres de campo varían según el cliente y la versión. La constante siempre es la misma: la URL de arriba, más la cabecera Authorization: Bearer que lleva tu token.
Pruébalo
Una vez conectado, solo pregunta.
No llamas a las herramientas por su nombre — hablas con tu asistente y él las elige. Algunas cosas para probar:
“Lista mis sitios.”
“Muestra los hallazgos abiertos de example.com.”
“Consigue el prompt de corrección para h1_missing y aplícalo a este repositorio.”
Seguridad
Restringido a ti, con confirmación previa y revocable.
Tu acceso, y solo el tuyo
Un token actúa en tu nombre: accede a cada sitio que ya puedes abrir en el panel, en tu propia cuenta y en cualquier cuenta a la que pertenezcas, con el rol que tengas en cada una. Ninguna herramienta acepta un account id como argumento, por lo que un cliente que tenga tu token no puede acceder a los datos de nadie más, ni siquiera solicitándolos.
Las escrituras requieren confirmación, no están bloqueadas
Esta no es una integración de solo lectura: 14 de las 41 herramientas realizan cambios. Lo que te protege es el paso de confirmación, los límites mensuales de tu plan y el hecho de que la publicación pasa por las mismas comprobaciones que el panel de control.
Revoca cuando quieras
Elimina un token desde la misma tarjeta API access (MCP) cuando quieras. Una vez revocado, cualquier cliente que aún lo tenga deja de funcionar de inmediato.
Se muestra una vez
Mostramos un token nuevo una sola vez, al generarlo. Si lo pierdes, no lo recuperas — generas uno nuevo y lo sustituyes.
