Le flux prévu
Audit → fix-prompt → votre agent de code.
get_fix_prompt renvoie une instruction rédigée pour un agent de code, pas une checklist humaine : signification de l'anomalie, méthode de correction, niveau de gravité et zone concernée. Votre assistant lit un résultat de votre audit, demande son fix-prompt et l'applique au dépôt déjà ouvert — l'audit et le code ne quittent jamais votre éditeur.
- 1
Lancez un audit gratuit de votre site — aucun compte requis.
- 2
Connectez le serveur MCP avec votre jeton (ci-dessous).
- 3
Demandez à votre assistant de récupérer une anomalie et son fix-prompt, puis de l'appliquer.
Bon à savoir
Les audits sont lancés depuis le tableau de bord — aucun outil MCP n'en démarre un. Via MCP, vous consultez les exécutions et leurs résultats. Un fix-prompt est une directive destinée à votre agent selon le type d'anomalie ; ce n'est pas un patch, et votre agent doit tout de même effectuer et vérifier la modification.
Ce que vous obtenez
41 outils que votre assistant peut appeler.
Une fois connectée, votre CLI de code IA peut interroger UPGeoSEO pour obtenir vos sites, audits et correctifs — et agir en conséquence. La liste ci-dessous est générée par le serveur lui-même : elle reflète fidèlement ce qui est enregistré aujourd'hui, et non un résumé rédigé autrefois.
Lecture — 27 outils
Ces outils se contentent de consulter. Ils renvoient vos propres données sans rien modifier.
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.
Écriture — 14 outils
Ces outils modifient des éléments : ils ajoutent un site, planifient un calendrier, publient ou suppriment. La plupart demandent confirmation (ci-dessous) ; ils sont tous limités aux sites que vous pouvez ouvrir.
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_focusdemande confirmationConcentrate the next days on a new feature (other articles of that language mention it) or a newly launched language, without adding articles.
delete_articledemande confirmationPermanently delete one article, or every non-primary translation of a group.
generate_calendardemande confirmationPlan a content calendar for one of your sites.
launch_localedemande confirmationRe-run market research for one of this site's already-enabled languages.
publish_articledemande confirmationPublish a DRAFT article to the site's connected destination.
publish_translationsdemande confirmationCascade-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_keywordsdemande confirmationRefresh 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.
Avant toute modification
Chaque action vous demande d'abord confirmation.
Les outils qui modifient votre site ou consomment une partie de votre quota mensuel utilisent un flux en deux étapes. Le premier appel ne change rien — il renvoie un aperçu exact de ce qui se produirait, accompagné d’une mention indiquant qu’une confirmation est requise. Seul un second appel avec confirm:true exécute le travail. Votre assistant vous affiche l’aperçu entre les deux, évitant ainsi qu’un agent ne publie ou n’utilise votre quota en douce.
Ce que renvoie le premier appel
{
"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."
}Quelques outils d’écriture ne nécessitent pas de confirmation car ils sont peu coûteux et réversibles — ajouter un site, en relancer l’exploration, modifier son profil, déplacer un élément du calendrier. Aucun outil de publication ne fait partie de ce groupe.
Obtenez votre jeton
Générez un jeton, une seule fois.
Chaque client ci-dessous s’authentifie avec le même élément : un jeton personnel qui agit en votre nom. Voici où l’obtenir.
Connectez-vous à votre compte UPGeoSEO (ou créez-en un — c’est gratuit pour commencer).
Ouvrez Tableau de bord → Votre profil et trouvez la carte API access (MCP).
Cliquez sur Generate token. Copiez-le maintenant — il commence par ugs_live_ et n’est affiché qu’une seule fois.
Connectez votre client
Pointez votre CLI de codage IA vers le serveur.
UPGeoSEO parle le MCP standard en Streamable HTTP avec authentification bearer, il fonctionne donc avec tout client prenant en charge un serveur HTTP distant et un en-tête personnalisé. Choisissez le vôtre ci-dessous et remplacez YOUR_TOKEN par le jeton que vous avez généré.
Claude Code (CLI)
Une seule commande l’ajoute — exécutez-la depuis n’importe où :
claude mcp add --transport http upgeoseo \
https://app.upgeoseo.com/api/mcp \
--header "Authorization: Bearer YOUR_TOKEN"Cursor
Ajoutez une entrée à ~/.cursor/mcp.json (global) ou .cursor/mcp.json dans votre projet :
// ~/.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
Ajoutez-le au mcp_config.json de Windsurf avec la même structure url + headers :
// Windsurf → mcp_config.json
{
"mcpServers": {
"upgeoseo": {
"url": "https://app.upgeoseo.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}Note : certaines versions de Windsurf nomment le champ serverUrl au lieu de url. Si url ne fonctionne pas, renommez cette seule clé — tout le reste ne change pas.
Cline et autres extensions MCP de VS Code
Ajoutez un serveur à votre .mcp.json (ou aux réglages MCP de l’extension), url + headers comme d’habitude :
// .mcp.json (or your MCP extension's settings)
{
"mcpServers": {
"upgeoseo": {
"url": "https://app.upgeoseo.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}Tout autre client MCP — les faits bruts
Si votre client prend en charge un serveur MCP HTTP distant avec des en-têtes personnalisés, il fonctionne. Les trois seules choses dont il a besoin :
- Transport : Streamable HTTP
- Point d’accès :
https://app.upgeoseo.com/api/mcp - Auth : En-tête HTTP
Authorization: Bearer <token>
Les chemins exacts des fichiers de configuration et les noms de champs varient selon le client et la version. La constante reste toujours la même : l’URL ci-dessus, plus l’en-tête Authorization: Bearer portant votre jeton.
Essayez
Une fois connecté, il suffit de demander.
Vous n’appelez pas les outils par leur nom — vous parlez à votre assistant, et il les choisit. Quelques idées à essayer :
“Liste mes sites.”
“Montre les problèmes ouverts pour example.com.”
“Récupère le prompt de correction pour h1_missing et applique-le à ce dépôt.”
Sécurité
Limité à votre compte, avec confirmation, révocable.
Votre accès, et uniquement le vôtre
Un jeton agit en votre nom : il accède à chaque site que vous pouvez déjà ouvrir dans le tableau de bord, dans votre propre compte et dans tout compte auquel vous appartenez, avec le rôle que vous y détenez. Aucun outil n’accepte d’identifiant de compte comme argument, de sorte qu’un client disposant de votre jeton ne peut accéder aux données de personne d’autre, y compris en les demandant.
Les écritures sont encadrées, pas bloquées
Il ne s'agit pas d'une intégration en lecture seule : 14 des 41 outils modifient des éléments. Ce qui vous protège, c'est l'étape de confirmation, les limites mensuelles de votre forfait et le fait que la publication passe par les mêmes vérifications que dans le tableau de bord.
Révoquez à tout moment
Supprimez un jeton depuis la même carte API access (MCP) quand vous voulez. Une fois révoqué, tout client qui le détient encore cesse de fonctionner immédiatement.
Affiché une seule fois
Nous montrons un nouveau jeton une seule fois, à sa génération. Si vous le perdez, vous ne le récupérez pas — vous en générez un nouveau et le remplacez.
