De workflow waarvoor dit bedoeld is
Audit → fix-prompt → je coding-agent.
get_fix_prompt retourneert een instructie geschreven voor een coding-agent, geen menselijke checklist: wat de bevinding betekent, hoe je het oplost, en de ernst en het gebied waarop het betrekking heeft. Je assistent leest een bevinding uit je audit, vraagt om de fix-prompt en past deze toe op de repo die al geopend is — de audit en de code verlaten je editor nooit.
- 1
- 2
Verbind de MCP-server met je token (hieronder).
- 3
Vraag je assistent om een bevinding en de bijbehorende fix-prompt op te halen en toe te passen.
Goed om te weten
Audits worden gestart in het dashboard — geen enkele MCP-tool start er een. Via MCP lees je de runs en hun bevindingen. Een fix-prompt is een richtlijn voor je agent per type bevinding; het is geen patch, en je agent moet de wijziging nog steeds zelf maken en controleren.
Wat je krijgt
41 tools die je assistent kan aanroepen.
Eenmaal verbonden kan je AI-coding-CLI UPGeoSEO vragen om je sites, audits en fixes — en hiernaar handelen. De onderstaande lijst wordt gegenereerd vanaf de server zelf, dus dit is wat er vandaag daadwerkelijk geregistreerd staat, geen samenvatting die ooit eens geschreven is.
Lezen — 27 tools
Deze bekijken alleen gegevens. Ze retourneren je eigen gegevens en wijzigen niets.
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.
Schrijven — 14 tools
Deze wijzigen iets: ze voegen een site toe, plannen een kalender, publiceren of verwijderen. De meeste vragen eerst om bevestiging (hieronder); ze zijn allemaal beperkt tot de sites die je kunt openen.
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_focusvraagt eerstConcentrate the next days on a new feature (other articles of that language mention it) or a newly launched language, without adding articles.
delete_articlevraagt eerstPermanently delete one article, or every non-primary translation of a group.
generate_calendarvraagt eerstPlan a content calendar for one of your sites.
launch_localevraagt eerstRe-run market research for one of this site's already-enabled languages.
publish_articlevraagt eerstPublish a DRAFT article to the site's connected destination.
publish_translationsvraagt eerstCascade-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_keywordsvraagt eerstRefresh 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.
Voordat er iets verandert
Elke actie vraagt het je eerst.
De tools die je site aanpassen of een deel van je maandelijkse tegoed verbruiken, werken via een proces met twee aanroepen. De eerste aanroep wijzigt niets — deze toont een voorbeeld van wat er precies zou gebeuren, en de melding dat bevestiging vereist is. Alleen een tweede aanroep met confirm:true voert het werk uit. Je assistent toont je het voorbeeld tussendoor, zodat een agent niet stilletjes namens jou kan publiceren of je tegoed kan verbruiken.
Wat de eerste aanroep retourneert
{
"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."
}Een handvol schrijftools vereist geen bevestiging omdat ze goedkoop en omkeerbaar zijn — het toevoegen van een site, het opnieuw crawlen van een site, het bewerken van een profiel of het verplaatsen van een kalenderitem. Niets dat publiceert valt in die groep.
Haal je token
Genereer één keer een token.
Elke client hieronder authenticeert zich met hetzelfde: een persoonlijk token dat namens jou optreedt. Hier lees je waar je het ophaalt.
Log in op je UPGeoSEO-account (of maak er een — beginnen is gratis).
Open Dashboard → Je profiel en zoek de kaart API access (MCP).
Klik op Generate token. Kopieer het nu — het begint met ugs_live_ en wordt maar één keer getoond.
Verbind je client
Richt je AI-coding-CLI op de server.
UPGeoSEO spreekt standaard MCP over Streamable HTTP met bearer-auth, dus het werkt met elke client die een remote HTTP-server en een eigen header ondersteunt. Kies hieronder de jouwe en vervang YOUR_TOKEN door het token dat je hebt gegenereerd.
Claude Code (CLI)
Eén commando voegt het toe — voer het van overal uit:
claude mcp add --transport http upgeoseo \
https://app.upgeoseo.com/api/mcp \
--header "Authorization: Bearer YOUR_TOKEN"Cursor
Voeg een item toe aan ~/.cursor/mcp.json (globaal) of .cursor/mcp.json in je project:
// ~/.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
Voeg het toe aan Windsurfs mcp_config.json met dezelfde url + headers-vorm:
// Windsurf → mcp_config.json
{
"mcpServers": {
"upgeoseo": {
"url": "https://app.upgeoseo.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}Let op: sommige Windsurf-versies noemen het veld serverUrl in plaats van url. Als url niet werkt, hernoem die ene sleutel — al het andere blijft gelijk.
Cline en andere VS Code-MCP-extensies
Voeg een server toe aan je .mcp.json (of de MCP-instellingen van de extensie), url + headers zoals gewoonlijk:
// .mcp.json (or your MCP extension's settings)
{
"mcpServers": {
"upgeoseo": {
"url": "https://app.upgeoseo.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}Elke andere MCP-client — de kale feiten
Als je client een remote HTTP-MCP-server met eigen headers ondersteunt, werkt het. De enige drie dingen die hij nodig heeft:
- Transport: Streamable HTTP
- Endpoint:
https://app.upgeoseo.com/api/mcp - Auth: HTTP-header
Authorization: Bearer <token>
De exacte paden van configuratiebestanden en veldnamen verschillen per client en per versie. De constante is altijd dezelfde: de URL hierboven, plus de Authorization: Bearer-header met je token.
Probeer het
Eenmaal verbonden, vraag het gewoon.
Je roept de tools niet bij naam aan — je praat met je assistent en die kiest ze. Een paar dingen om te proberen:
“Toon mijn sites.”
“Toon de open bevindingen voor example.com.”
“Haal de fix-prompt voor h1_missing en pas hem toe op deze repo.”
Beveiliging
Beperkt tot jou, bevestiging vereist, herroepbaar.
Jouw toegang, en alleen die van jou
Een token treedt op namens jou: het heeft toegang tot elke site die je al in het dashboard kunt openen, in je eigen account en in elk account waar je lid van bent, met de rol die je daarin hebt. Geen enkele tool accepteert een account-id als argument, dus een client met jouw token heeft geen toegang tot de gegevens van iemand anders, zelfs niet door erom te vragen.
Schrijfacties vereisen goedkeuring, niet geblokkeerd
Dit is geen alleen-lezen-integratie: 14 van de 41 tools wijzigen iets. Wat je beschermt is de bevestigingsstap, de maandelijkse limieten van je abonnement en het feit dat publiceren dezelfde controles doorloopt als het dashboard.
Trek altijd in
Verwijder een token vanaf dezelfde kaart API access (MCP) wanneer je wilt. Eenmaal ingetrokken stopt elke client die het nog heeft meteen met werken.
Eén keer getoond
We tonen een nieuw token één keer, bij het genereren. Raak je het kwijt, dan haal je het niet terug — je genereert een nieuw en wisselt het in.
