UPGeoSEO

Integración MCP

Gestiona tu SEO desde tu editor.

Lleva tus resultados y prompts de solución listos para pegar a cualquier CLI de programación con IA mediante MCP y, cuando quieras, deja que también haga el trabajo: planificar el calendario, publicar un artículo, gestionar tus sitios. Cada acción que cambie algo te pedirá confirmación primero.

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. 1

    Ejecuta una auditoría gratuita en tu sitio — no se necesita cuenta.

  2. 2

    Conecta el servidor MCP con tu token (abajo).

  3. 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_locales

    Show the languages detected on one of your sites.

  • get_ai_visibility

    The 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_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. its pre-publish baseline.

  • 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_content_plan

    A 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_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. the prior 28 days, counting ONLY the URLs of articles this account published (never a customer's pre-existing pages).

  • get_index_status

    Stored Google 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_rivals

    The rivals YOU named (up to 10) and how you compare over the last four weeks of AI answers.

  • list_sites

    List 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_questions

    The 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_rival

    Stop comparing with a rival.

  • remove_tracked_question

    Stop 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_rival

    Name 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_site

    Add 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_question

    Track one more question in AI answers for a language of the site.

  • connect_publish

    Add 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ón

    Concentrate 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ón

    Permanently delete one article, or every non-primary translation of a group.

  • generate_calendarpide confirmación

    Plan a content calendar for one of your sites.

  • launch_localepide confirmación

    Re-run market research for one of this site's already-enabled languages.

  • publish_articlepide confirmación

    Publish a DRAFT article to the site's connected destination.

  • publish_translationspide confirmación

    Cascade-publish a whole translation group: the primary plus every draft sibling.

  • recrawl_site

    Re-learn one of your sites: re-read it and refresh its brand profile and brand colors.

  • refresh_locale_keywordspide confirmación

    Refresh a non-primary language's keyword ideas: replace the ones not yet on your calendar with freshly researched ones.

  • reschedule_item

    Move a PLANNED calendar item to a new publish date.

  • update_site_profile

    Complete 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.

1

Inicia sesión en tu cuenta de UPGeoSEO (o crea una — empezar es gratis).

2

Abre Panel → Tu perfil y busca la tarjeta API access (MCP).

3

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.

Corrige lo que la auditoría encuentra — sin salir de tu editor.

Crea una cuenta, genera un token y apunta tu CLI de codificación con IA a UPGeoSEO. Tus hallazgos y prompts de corrección, justo donde escribes código.