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
Voer een gratis audit uit op je site — geen account nodig.
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

39 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 — 22 tools

Deze bekijken alleen gegevens. Ze retourneren je eigen gegevens en wijzigen niets.

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

Schrijven — 17 tools

Deze wijzigen iets: ze voegen een site toe, plannen een kalender, schrijven, vertalen, publiceren of verwijderen. De meeste vereisen bevestiging (zie hieronder); ze zijn allemaal beperkt tot je eigen account.

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_focusvraagt eerst
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_articlevraagt eerst
Permanently delete one article, or every non-primary translation of a group.
generate_articlevraagt eerst
Write ONE article now for a site (inline, ~30-60s).
generate_articles_bulkvraagt eerst
Enqueue many background article-generate jobs at once (returns immediately).
generate_calendarvraagt eerst
Plan a content calendar for one of your sites.
launch_localevraagt eerst
Re-run native content research for one of this site's already-enabled languages.
publish_articlevraagt eerst
Publish a DRAFT article to the site's connected destination.
publish_translationsvraagt eerst
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_keywordsvraagt eerst
Refresh a non-primary locale's keyword ideas: purge unscheduled backlog keywords and re-discover fresh native ones.
refresh_og_imagesvraagt eerstalleen admin
ADMIN ONLY.
reschedule_item
Move a PLANNED calendar item to a new publish date.
research_keywordsvraagt eerstalleen admin
ADMIN ONLY.
translate_articlevraagt eerst
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.

Voordat er iets verandert

Elke actie vraagt het je eerst.

De tools die credits verbruiken of je site wijzigen, gebruiken een tweestapsaanroep. De eerste aanroep wijzigt niets — het toont een voorbeeld van wat er precies zou gebeuren, en een melding dat bevestiging vereist is. Alleen een tweede aanroep met confirm:true voert het werk uit. Je assistent toont je tussendoor het voorbeeld, zodat een agent niet stilletjes namens jou kan publiceren of credits kan uitgeven.

Wat de eerste aanroep retourneert

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

Een handvol schrijftools vereist geen bevestiging omdat ze risicoloos en omkeerbaar zijn — een site toevoegen, opnieuw crawlen, het profiel bewerken, een kalenderitem verplaatsen. Niets wat publiceert of credits verbruikt valt in die groep.

Haal je token

Genereer één keer een token.

Elke client hieronder authenticeert met hetzelfde: een persoonlijk token dat de toegang tot je account afbakent. Hier haal je het.

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 account, en alleen het jouwe

Een token is gekoppeld aan één account. Elke tool haalt site-id's op uit je eigen account en geen enkele tool accepteert een account-id als argument, dus een client met jouw token kan nooit bij andermans gegevens — zelfs niet door erom te vragen.

Schrijfacties vereisen goedkeuring, niet geblokkeerd

Dit is geen alleen-lezen-integratie: 17 van de 39 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.

Beheer je SEO vanuit je editor.