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

39 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 — 22 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 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).

Escritura — 17 herramientas

Estas modifican algo: añaden un sitio, planifican un calendario, escriben, traducen, publican o eliminan. La mayoría requieren confirmación previa (abajo); todas están limitadas a tu propia cuenta.

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_focuspide confirmación
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_articlepide confirmación
Permanently delete one article, or every non-primary translation of a group.
generate_articlepide confirmación
Write ONE article now for a site (inline, ~30-60s).
generate_articles_bulkpide confirmación
Enqueue many background article-generate jobs at once (returns immediately).
generate_calendarpide confirmación
Plan a content calendar for one of your sites.
launch_localepide confirmación
Re-run native content 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-crawl it and refresh the crawl-derived brand profile and brand colors.
refresh_locale_keywordspide confirmación
Refresh a non-primary locale's keyword ideas: purge unscheduled backlog keywords and re-discover fresh native ones.
refresh_og_imagespide confirmaciónsolo admin
ADMIN ONLY.
reschedule_item
Move a PLANNED calendar item to a new publish date.
research_keywordspide confirmaciónsolo admin
ADMIN ONLY.
translate_articlepide confirmación
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 que algo cambie

Cada acción te pide confirmación primero.

Las herramientas que consumen créditos o modifican tu sitio usan un flujo de dos llamadas. La primera llamada no cambia nada — devuelve una vista previa de exactamente lo que sucedería y una indicación de que se requiere confirmación. Solo una segunda llamada que incluya confirm:true ejecuta el trabajo. Tu asistente te muestra la vista previa en el intermedio, para que un agente no pueda publicar ni gastar silenciosamente en tu nombre.

Lo que devuelve la primera llamada

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

Un grupo reducido de herramientas de escritura no requieren confirmación previa porque son de bajo impacto y reversibles: añadir un sitio, volver a rastrearlo, editar su perfil o mover un elemento del calendario. Nada que publique o consuma créditos está en ese grupo.

Consigue tu token

Genera un token, una sola vez.

Cada cliente de abajo se autentica con lo mismo: un token personal que limita el acceso a tu cuenta. Aquí es donde 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 cuenta, y solo la tuya

Un token está vinculado a una sola cuenta. Cada herramienta toma los IDs de sitio de tu propia cuenta y ninguna herramienta acepta un ID de cuenta como argumento, por lo que un cliente que tenga tu token no puede acceder a los datos de nadie más — ni siquiera solicitándolo.

Las escrituras requieren confirmación, no están bloqueadas

Esta no es una integración de solo lectura: 17 de las 39 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.

Gestiona tu SEO desde tu editor.