SEO MCP Server for Claude, ChatGPT and Cursor

Install the SEOmatic MCP server for me.

Server: https://app.seomatic.ai/api/mcp
Transport: Streamable HTTP (stateless JSON-RPC 2.0)
Auth: OAuth 2.1 - the client discovers it automatically, no API key needed.
      (Headless setups can instead send: Authorization: Bearer smk_live_...)

What to do:
1. If you can edit MCP config or run commands in this client, install it
   yourself now. Reference configs:
   - Claude Code:  claude mcp add --transport http seomatic https://app.seomatic.ai/api/mcp
   - Cursor (mcp.json):
     { "mcpServers": { "seomatic": { "url": "https://app.seomatic.ai/api/mcp" } } }
   - Cline (cline_mcp_settings.json; the type is required):
     { "mcpServers": { "seomatic": { "type": "streamableHttp", "url": "https://app.seomatic.ai/api/mcp" } } }
   - Devin Desktop / CLI (mcp_config.json, or: devin mcp add seomatic https://app.seomatic.ai/api/mcp):
     { "mcpServers": { "seomatic": { "url": "https://app.seomatic.ai/api/mcp" } } }
2. If you cannot, give me the exact clicks for THIS client instead
   (for Claude: Customize, then Connectors, then + Add, then Add custom
   connector with the URL above, and switch it on in a chat from the +
   button under Connectors; for ChatGPT on the web (Business, Enterprise
   or Edu for full use, read-only on Pro): Plugins, then +, then Add
   custom MCP server with the URL above, OAuth, tick I understand and
   want to continue, Create as a plugin, then type @ in a chat and pick
   SEOmatic; for the Gemini app: Settings, then Connected Apps, then Custom apps,
   then Add a custom app with the URL above. Gemini custom apps need a
   personal Google account in the US; elsewhere use Gemini CLI or
   Antigravity, see the docs link below).
3. Tell me to finish the OAuth login when the SEOmatic screen appears, and
   to pick the site I want connected.
4. In a NEW chat, check the tools menu and confirm SEOmatic is enabled for
   that conversation (in the Gemini app, type @ and pick SEOmatic). This
   step is the one people miss.
5. Then prove it works by calling tools/list and running one read-only tool,
   and show me what came back.

Docs if you need them: https://seomatic.ai/developers/mcp

{
  "mcpServers": {
    "seomatic": {
      "url": "https://app.seomatic.ai/api/mcp",
      "headers": { "Authorization": "Bearer smk_live_..." }
    }
  }
}

curl -s https://app.seomatic.ai/api/mcp \
  -H "Authorization: Bearer smk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

curl -s https://app.seomatic.ai/api/mcp \
  -H "Authorization: Bearer smk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{
    "name":"gsc_performance",
    "arguments":{"action":"top_queries","days":28,"limit":10}}}'

gsc_performanceRead-onlyFreeInteractive

Google Search Console performance for the connected site: clicks, impressions, CTR and position by query, page or period (data lags 2 to 3 days). Use for 'how is my site / this page / this query doing in Google'. One page's queries: dimension_breakdown with filterPage. Diagnosis (cannibalization, CTR outliers) is gsc_insights; weekly position history is rank_tracking_read.

Cost: FREE - reads your connected/stored data, no AI credits.

gsc_indexingRead-onlyFree

Is a URL in Google's index, and why not (coverage, crawl, robots, canonical). Use this for any 'is this page indexed' question; batch_inspect takes up to 50 URLs. To get a page indexed, follow next_step in the result (stage an index_request with task_manage). Google cannot be made to crawl a normal page: never promise it.

Cost: FREE - reads your connected/stored data, no AI credits.

gsc_insightsRead-onlyFree

Diagnoses over the site's Search Console history: cannibalization, brand vs non-brand, CTR outliers (pages under-earning their position), rich results, seasonality, sitemap health. Use to find what to fix; raw numbers are gsc_performance.

Cost: FREE - reads your connected/stored data, no AI credits.

rank_trackingCan stage changesBills AI credits

The Rank Tracker: track searches daily from a city on mobile/desktop (track, quoted first, confirm: true after the user's yes), stop tracking (untrack, deletes history: confirm: true), run a city grid for one tracked search (grid, billed: quoted first, confirm: true after the user's yes), ranking alerts (alerts); also a blog project's keyword list (add_keywords, remove_keywords). Reads, including the latest grid (grid_latest), are rank_tracking_read.

Cost: reads are FREE (stored data), grid_latest included. track adds daily checks paid from the AI credit pool at vendor cost (about 350 to 550 credits a check): it quotes the monthly credits and saves only with confirm: true. grid bills one run from the AI credit pool (200 credits a point plus 700 to place the business: about 2,500 for 3x3, 5,700 for 5x5, 10,500 for 7x7): without confirm it only returns the latest grid and the quote. untrack, add_keywords and remove_keywords are FREE configuration changes.

keyword_researchRead-onlyBills AI credits

Keyword demand: volume, difficulty, CPC, intent, ideas, Google Trends and Google Ads keyword data, from a live vendor (never invented; a gap is said plainly). Use to decide what to target; who ranks today is serp_competitors.

Cost: metrics and suggestions bill AI credits (live vendor data at actual cost); trends, related_queries, compare and performance are FREE (Google Trends / your connected Google Ads).

keyword_clustersRead-onlyFree

The site's stored keyword-cluster map from its Search Console queries (pillar, cannibalization, gap, covered). Use for topic structure; live demand is keyword_research.

Cost: FREE - reads your connected/stored data, no AI credits.

backlink_profileRead-onlyBills AI credits

Backlinks of the site or any competitor: referring domains, anchors, velocity, links gained or lost, link prospects. Use for authority and link questions.

Cost: bills AI credits per call (live vendor data at actual cost); reads of your own stored data elsewhere are free.

serp_competitorsRead-onlyBills AI credits

The live search results landscape: SERP features for a keyword, a domain's rankings and visibility, its competitors and top pages. Use for who ranks and why.

Cost: bills AI credits per call (live vendor data at actual cost); reads of your own stored data elsewhere are free.

ai_citationsRead-onlyFree

How AI engines cite this site: citations seen in real logged-in AI answers (observed_citations), the brand facts the site publishes for AI (brand_facts), and the latest AI-visibility scan (scan_results: where the brand was missed and who won). Use for AI search visibility questions.

Cost: FREE - reads your connected/stored data, no AI credits.

traffic_analyticsRead-onlyFree

Google Analytics 4 traffic and Google Ads performance: overview, sources, landing pages, any GA4 report, realtime, key events (conversions), Ads campaigns and search terms, plus AI-referred visits per page. Each action names a missing connection instead of returning empty data. Search clicks are gsc_performance.

Cost: FREE - reads your connected/stored data, no AI credits.

local_presenceRead-onlyBills AI credits

Local search presence: Business Profile locations, local rankings for money keywords, reviews. Use for map-pack and local questions.

Cost: list_locations and reviews read your connected Business Profile and are FREE; visibility bills AI credits (live local SERP data at actual cost).

business_profileRead-onlyFree

The Google Business Profile, read-only: calls, direction requests and website clicks with the agent's changes, the Google Maps top 3 vs the businesses above, category advice, Ask Maps readiness, duplicates (overview); reviews with drafted replies (reviews); completeness, edits waiting and updates (updates); the review link (review_link); drafted Ask Maps answers (ask_maps).

Cost: FREE. Stored data synced daily from Google; never calls Google per question.

business_profile_manageCan stage changesBills AI credits

Stage Google Business Profile work as approval cards (never published directly; approve with task_manage decide): this week's update from a job note and photo (draft_update), a review reply (redraft_reply), a profile edit (propose_edit; name, address and primary category only with confirm: true after the user asked for exactly that), settings (auto-reply to 4-5 star reviews, off by default), review requests by email to the customers the user lists (send_review_requests: preview, then confirm: true), a refresh from Google now with the Google Maps comparison (refresh: quote, then confirm: true). With several listings and none named, an action answers chooseListing: ask the user which one.

Cost: draft_update and redraft_reply bill a small AI credit charge for the draft; refresh bills about 700 credits per listing, up to 4,700 per listing (quoted first, runs only with confirm: true); propose_edit, settings and send_review_requests are FREE.

visibility_manageCan stage changesBills AI credits

Change the AI-visibility monitor: create it (scans bill credits: confirm: true after the user agreed to the quoted cost), add, edit or remove tracked prompts, set cadence and engines (spend levers, only on the user's ask). Reading the monitor and crawler setup is visibility_manage_read; results are ai_citations.

Cost: all actions are FREE config changes; create_monitor starts scans that bill credits (it quotes the per-scan cost first), each ACTIVE prompt raises the recurring scan cost when scans run, cadence 'daily' is ~7x weekly spend, and each tracked engine adds its per-question cost - disclose before setting.

site_pagesRead-onlyFree

Page-level analysis of the live site: on-page SEO score and issues for a URL, crawl metadata, PageSpeed (lab and field), structured-data validation, and the stored page inventory. Use to diagnose a page before proposing a fix.

Cost: FREE - reads your connected/stored data, no AI credits.

dataset_libraryRead-onlyFree

Read the dataset library and page templates behind programmatic pages (datasets, sample rows, templates). Editing is dataset_manage.

Cost: FREE - reads your connected/stored data, no AI credits.

strategy_insightsRead-onlyFree

The agent's own diagnosis for this site: snapshot, current strategy, raw signals, AI-search content scores, the monthly client report and proof links. Use to explain what the agent sees and plans.

Cost: FREE - reads your connected/stored data, no AI credits.

task_manageCan stage changesBills AI creditsInteractive

Act on the task board: stage proposals (create, up to 5; nothing runs), approve or dismiss them (decide, decide_batch), run an approved task (execute), undo live changes (rollback, undo_all), and the related site changes. Every decision is the user's: never approve, confirm or undo on your own judgment. Reading tasks is the tasks tool.

Cost: every action but preview is FREE to call (preview drafts with AI credits: the estimate first, confirm: true); approved work (decide, decide_batch, execute) bills AI credits when it runs (a title/meta/H1 fix is typically a few hundred credits). rollback, undo_all and apply_site_change change the live site. Inspecting tasks never triggers re-analysis.

slack_settingsCan stage changesFree

Slack notifications for this site: connection, card mode, weekly report, the channel it posts to; change them or get the install link. Organization owner only.

Cost: FREE - reads your connected/stored data, no AI credits.

workspacesRead-onlyFree

The workspaces (sites) the user can open: list them, the steps to switch this connection to another one, and white-label clients. Creating or renaming is workspaces_manage.

Cost: FREE - reads your connected/stored data, no AI credits.

workspaces_manageCan stage changesFree

Create or rename a workspace, and manage white-label clients (invite, allowance, reports), each after the user confirms. Deleting a workspace stays in Settings. Admins and the owner.

Cost: FREE - reads your connected/stored data, no AI credits.

eventsCan stage changesFree

What happened in this workspace: the event list, poll for new events, wait for the next one, and register targets (a routine or webhook) that receive them.

Cost: FREE - reads your connected/stored data, no AI credits.

campaign_manageCan stage changesBills AI credits

Act on campaigns: approve, pause, resume or abandon (manage), release held waves (expand), revert a campaign's live changes (undo), and stage new campaigns (page scale, location pages, content sweeps, bulk edits, articles). Approving, expanding, undoing and publishing are the user's decision, never yours. Reading campaigns is the campaigns tool.

Cost: list is FREE and staging spends nothing. Approving or expanding bills AI credits per page as the work runs; expand without confirm: true spends nothing. undo is FREE but changes the live site.

connectionsCan stage changesFree

Change connections (the connect link itself comes from connections_read connect: show it to the user VERBATIM, a one-time browser step), choose the Search Console, Analytics, Ads or Business Profile property, test or disconnect, and set publishing, sitemaps, market, IndexNow and vendor keys (confirm: true where the user must say yes). Checking what is connected is connections_read.

Cost: FREE - reads stored status and changes settings, no AI credits.

agent_settingsCan stage changesBills AI creditsInteractive

Change the agent controls: on or off, autonomy mode (approval, assisted, auto), daily credit cap and publish-gate floors. Anything that lets work run or spend with less approval needs confirm: true after the user explicitly asked. Admin or owner. Reading them is agent_settings_read.

Cost: get and set are FREE config changes; a wider mode or a higher cap lets approved work spend more credits later - disclose before setting.

dataset_manageCan stage changesBills AI credits

Edit datasets as the dashboard does: rows, cells and columns, find and replace, AI fill, generate rows, create, attach, fork, copy, share, rename, delete and restore a snapshot. Long work returns a job id to poll.

Cost: reads and edits are FREE. ai_fill, add_fill_column and generate_rows bill AI credits: without confirm they return the estimate, with confirm: true they reserve it and run.

site_audit_deepCan stage changesFree

Start or cancel a whole-site technical audit that crawls in the background (up to 2,000 pages). Reading its progress, results, comparisons and history is site_audit_deep_read. A quick 30-page audit inside one call is site_audit.

Cost: FREE - crawls with SEOmatic's own crawler in the background, no AI credits. start creates an audit run; nothing on the site changes.

brand_profileCan stage changesFree

Change the brand profile and Trust Profile: company facts, voices and references, brand kit, autofill from the site, copy from another workspace, trust facts and expertise questions. Writers omit what is empty instead of inventing it. Deletes, copy, kit and autofill need the user's yes (confirm: true). Reading it is brand_profile_read.

Cost: FREE except autofill, which bills AI credits (the estimate first, confirm: true); an expertise answer queues a page upgrade that bills when it runs.

page_projectsCan stage changesBills AI credits

Page and blog projects as the dashboard runs them: configure projects and fields, edit and regenerate pages, generate content, and publish (one page, bulk or drip). Credit-billing actions return the estimate until confirm: true; publishing and deletes need the user's yes.

Cost: reads, settings, fields, keywords, exports, deletes and publishing are FREE in AI credits (a metrics retry uses the keyword data allowance). regenerate, generate, generate_posts, preview, spin_content, regenerate_outline and refresh_baseline bill AI credits: the estimate first, run only with confirm: true.

articlesCan stage changesBills AI credits

Change articles: edit a pay-as-you-go article, schedule weekly articles, run auto-optimize on a blog article, and leave feedback. Reading scores and downloads is articles_read; writing a new one is generate_article.

Cost: edit, download, scores and feedback are FREE. schedule is free to set; each weekly run uses one prepaid unit. auto_optimize start bills AI credits: the estimate first, confirm: true.

billingRead-onlyFree

The owner's plan as on the Billing tab: status, renewal date, free questions left, invoices and invoice details. Owner only; the payment method stays on the billing page. Plan changes and credit packs are billing_manage.

Cost: FREE - reads your connected/stored data, no AI credits.

billing_manageCan stage changesFree

Plan changes and credits for the owner: take the save offer, buy a credit pack (a Stripe Checkout link paid in the browser), set invoice details after the owner says yes. Previews of plan changes, pause, cancel and resume are billing_manage_read; they always finish in the browser.

Cost: FREE. Nothing is charged from the chat: plan changes are confirmed on the Plans or Billing page, and a credit pack is paid on its checkout page.

teamRead-onlyFree

The team as the Team tab shows it: members and invitations, redacted API keys (keys are created and revoked on the dashboard; a secret is never returned), and the person's own email preferences. Ownership transfer stays in Settings. Changes are team_manage.

Cost: FREE - reads your connected/stored data, no AI credits.

team_manageCan stage changesFree

Change the team (admins and the owner): invite, change roles, resend or revoke invitations, email preferences, each after the user confirms; removals and admin changes return the Team tab link.

Cost: FREE - reads your connected/stored data, no AI credits.

get_startedRead-onlyFreeInteractive

The first answer about your own site: whether Google can index it, Search Console clicks and the near-page-one queries worth pushing (when connected), market data in the site's own country, a one-line verdict, the top 3 actions ranked by impact with the numbers behind them, what could not be checked, and one next step. The same answer on free and paid plans.

Cost: FREE for the reads; the one market-data lookup uses the free monthly allowance or AI credits, like any keyword question.

get_ai_visibilityRead-onlyFree

Read the latest completed AI-search visibility scan: per-engine brand visibility (ChatGPT, Claude and Google AI Overviews by default, plus any engine the monitor tracks: Perplexity, Google AI Mode, Copilot, Gemini, Grok), the prompts where the brand was missed and who won them, top competitors, and the sources engines cite.

Cost: FREE - reads your connected/stored data, no AI credits.

run_ai_visibility_scanActs or spendsPaidInteractive

Start a fresh AI-search visibility scan: queries the live AI engines with buyer-intent prompts and measures whether the brand appears. Scans your own site by default, or any competitor domain via the domain parameter. Returns a scanId immediately; results arrive in a few minutes via get_ai_visibility. Limited to one assistant-triggered scan per hour.

Cost: bills AI credits from the workspace pool (comparable to generating a few articles). Reading an existing scan with get_ai_visibility is free.

site_auditRead-onlyFree

Site-wide technical SEO audit: crawls up to 30 pages and aggregates cross-page issues a single-page check cannot see - duplicate titles and metas, thin content, noindex leaks, canonical mismatches, slow pages, broken internal links, HTTPS and mixed content, and the mobile viewport. For the whole site (up to 2000 pages, in the background, with history and comparison) use site_audit_deep.

Cost: FREE - crawls with SEOmatic’s own crawler at call time, no AI credits.

get_credit_usageRead-onlyFree

Where the workspace’s AI credits went in the current billing period: customer-language groups plus the raw per-feature ledger with event counts. Totals reconcile with the plan meter; refunds show as negative credits.

Cost: FREE - reads your connected/stored data, no AI credits.

estimate_costRead-onlyFree

What a tool call will cost before you make it: free, credits at the actual vendor cost (with the ceiling the product reserves), credits, or one prepaid unit, plus the remaining balance and, on the free plan, the free questions left. Pass the tool and action you plan to call.

Cost: FREE - reads your connected/stored data, no AI credits.

get_referral_linkRead-onlyFree

Your personal SEOmatic Refer and earn link: the share URL, how many people you referred and how many became paying, and the extra AI credits you get every month from friends who pay. Give credits, get credits. Your friend gets 500K extra AI credits every month, and you get 500K more every month once they become a customer. Nothing is earned at signup.

Cost: FREE - reads your connected/stored data, no AI credits.

generate_articleActs or spendsPaidInteractive

Write one in-depth SEO article on a topic, research-grounded against live rankings, quality-gated, delivered as markdown and HTML. Generation is async: returns an article_id to poll with get_article. With no prepaid units it returns the price and a buy link instead of failing.

Cost: consumes 1 prepaid pay-as-you-go article unit ($9 each, never expires); no subscription required.

get_articleRead-onlyFree

Fetch a pay-as-you-go article by id (poll after generate_article), or omit the id to list recent articles and the prepaid balance. A ready article carries both markdown and HTML.

Cost: FREE - reads your connected/stored data, no AI credits.

pay_for_articlesActs or spendsPaid

Pay for prepaid units with a Stripe Shared Payment Token, for agent platforms whose users approve spends in a Link wallet (Meta Muse, ChatGPT agentic checkout). Products: articles ($9, default), question packs ($5 for 50 assistant questions), AI-visibility scans of your own site ($19), and competitor scans ($19). The token is single-use and amount-capped by Stripe; prices are fixed server-side. Hosts that cannot mint SPTs use the buy links from the payment_required payloads instead.

Cost: charges the approved payment method (product-priced); consumes no AI credits.

upload_csvActs or spendsFreeInteractive

Stage CSV text so it can be imported as a dataset. Exists because MCP has no file transport: in MCP Apps hosts a file-picker widget reads the file in the browser and passes its text here, minting the same attachmentId a chat upload would. Pass that id to import_attachment_as_dataset.

Cost: FREE - stages the file text, no AI credits.

show_trust_facts_cardRead-onlyFreeInteractive

Render the Trust Profile card: harvested-but-unconfirmed business facts with one-tap Confirm buttons (MCP Apps hosts), or an Open-settings link when the profile is empty. Confirmed facts are the only credentials/experience/review claims the agent's writers may make - an empty profile means humbler content, never invented authority.

Cost: FREE - reads your connected/stored data, no AI credits.

confirm_trust_factActs or spendsFree

Record the USER'S confirmation of one harvested trust fact, allowing writers to claim it. The click is the consent: call ONLY when the user explicitly confirmed that exact fact (the widget's Confirm button is the intended caller). Never confirm on your own judgment.

Cost: FREE - reads your connected/stored data, no AI credits.

add_trust_factActs or spendsFree

Add a business fact the user stated in their own words (a credential, years of experience, an award, a review count, a guarantee) to the Trust Profile, confirmed by construction, so the agent's writers may claim it. Admin or owner; the same as adding one in Settings.

Cost: FREE - saves the fact, no AI credits.

get_trust_factsRead-onlyFree

The workspace's Trust Profile: the provenance-tracked, verifiable business facts (credentials, experience, awards, review counts, guarantees) the agent's writers are allowed to claim in E-E-A-T work, each with its source URL and confirmation status. An empty profile means the agent writes around trust claims rather than inventing them.

Cost: FREE - reads your connected/stored data, no AI credits.

import_attachment_as_datasetActs or spendsFree

Promote a spreadsheet uploaded in the conversation (CSV/Excel) into a private dataset in the workspace library, ready to drive a pages-at-scale campaign. Also accepts the Pages export of Search Console's generative AI performance report (Google has no API for it) with its date range, which then shows as Google's own AI Overviews and AI Mode impressions per page in the AI funnel and the diagnosis.

Cost: FREE - writes the dataset, no AI credits.

get_ai_crawler_activityRead-onlyFree

Which AI bots (GPTBot, ChatGPT-User, PerplexityBot, ClaudeBot and more) visited the site, classified by purpose (answer-time retrieval, AI-search indexing, model training), with per-bot trends, top crawled pages, and the crawl-to-citation funnel.

Cost: FREE - reads your connected/stored data, no AI credits.

get_trust_entitiesRead-onlyFree

The trust entities AI engines consult when answering questions about the market, mined from the actual fan-out queries scans capture. Every entity carries the cross of queried vs cited, surfacing the outreach list of sources engines check but never cite the brand from.

Cost: FREE - reads your connected/stored data, no AI credits.

get_ai_funnelRead-onlyFree

The full AI-search funnel per page, joined across the measurements: cited (engines named the page as a source), crawled (AI bots actually fetched it), referred (GA4-measured assistant-referred visitors), and Google's own AI Overviews and AI Mode impressions when a Search Console generative AI report export was uploaded (with its date range), with unmeasured columns flagged honestly rather than shown as zero.

Cost: FREE - reads your connected/stored data, no AI credits.

show_approval_cardsActs or spendsFreeInteractive

Render inline Approve/Dismiss cards for existing proposed tasks and campaigns, bringing the approval decision into the conversation instead of sending the user to the dashboard.

Cost: FREE - reads your connected/stored data, no AI credits.

get_task_rollbackRead-onlyFree

What the pipeline can restore for an executed task: every live edit stores the page’s full pre-edit state before writing. Returns which fields are recoverable, original embed code verbatim, and how to trigger the one-click restore.

Cost: FREE - reads your connected/stored data, no AI credits.

resume_page_publishingActs or spendsPaid

Resume a page campaign paused by the scale governor (the drip stops itself when the first published pages earn essentially no search appearances). Requires the resumeToken from the hold, so resuming is always an explicit, informed decision.

Cost: resuming is free; each released page bills AI credits as it generates and publishes, same as campaign execution.

get_target_termsRead-onlyFree

The searches your business says bring it customers, each with the page that should show for it and a priority. Your agents plan around them: when Google shows a different page for a term, the chosen page gets the fix, and low-volume terms are worked too.

Cost: FREE - reads your connected/stored data, no AI credits.

set_target_termsActs or spendsFree

Add, update or remove the searches that bring your business customers, each with the page on your own site that should show for it and a priority. Pages on another site are refused; up to 50 terms per site.

Cost: FREE - saves your settings, no AI credits.

get_store_policiesRead-onlyFree

Your store's return and shipping policy as you stated it, and the summary the agents write into your homepage's Organization markup, Google's recommended place for a store-wide policy. Empty means no policy markup is written.

Cost: FREE - reads your connected/stored data, no AI credits.

set_store_policiesActs or spendsFree

Save or clear your return policy (countries, window in days, method, who pays) and shipping rates (price per country, free-shipping threshold, handling and transit days). Only values you state are saved; the agents never guess a return window or a shipping price. The markup change is then proposed like any other.

Cost: FREE - saves your settings, no AI credits.