Model Context Protocol server

Connect Seonio SEO data to compatible AI assistants.

One MCP server, 25 SEO tools — keyword metrics, suggestions, clustering, SERPs, scraping, traffic, rankings, backlinks, audits and authority data.

Mirrors the REST capability catalog and adds account balance. Matching actions use the same prices and Starter balance.

Start Your Starter Trial

7-day no-charge trial · payment method required

How to Connect

assistant

"How much organic traffic does moz.com get, and what does it rank for?"

Tool call

website_traffic(domain_name="moz.com")
website_ranking(domain_name="moz.com")

moz.com draws ~2.7M monthly organic visits, led by "domain authority checker" and "keyword research" — 42% of its keywords sit in positions 1–3.

MCP server URL

Authentication

Two ways in: OAuth for browser assistants (ChatGPT, Claude — sign in, nothing to paste), or the header Authorization: Bearer <apikey> for developer tools.

25 SEO tools, one connection

The REST capability catalog is exposed through MCP, with the same prices plus an account-balance tool.

$0.001 / keyword

Keyword metrics

keywords_global

Search volume, CPC, competition and 12-month trend for up to 100 keyword phrases.

$0.25 / call

Keyword clustering

keywords_clustering

Group a seed keyword's universe into topic clusters by SERP overlap — for content silos and pillar pages.

$0.02 / call

Keyword suggestions

keywords_suggestions

Expand one seed keyword into up to 100 related keyword ideas, each with full metrics.

$0.01 / request + $0.001 / started 10 keywords

Keyword metrics by country

keywords_country

Localized volume, CPC, competition, difficulty and trend for up to 1000 keywords in one country.

$0.001 / call

Google SERP

serp_api

The Google search-results page for one keyword in a given country.

$0.001 / request + $0.001 / scraped URL

SERP + scrape to markdown

serp_scraper

Run a search then scrape the top organic results to clean, LLM-ready markdown.

$0.002 / call

Scrape URL to markdown

scraper

Scrape one known URL to clean, LLM-ready markdown (or raw HTML) — title, meta and content.

$0.002 / call

URL SEO stats

url_stats

Page and domain authority, spam score and linking-domain counts for a full URL.

$0.002 / call

Domain SEO stats

website_stats

Domain authority, spam score and linking-domain counts for a bare domain.

$0.01 / call

Domain organic traffic

website_traffic

A domain's estimated monthly organic search traffic over time.

$0.02 / call

Domain keyword rankings

website_ranking

Ranked keywords and pages, distributions and movers for a domain.

$0.02 / call

Domain backlinks

backlink_website

Top inbound links pointing at a whole domain — source pages and anchor text.

$0.02 / call

URL backlinks

backlink_url

Top inbound links pointing at one specific page URL — source pages and anchor text.

$0.01 / call

Keyword countries

keywords_countries

The countries with the highest search volume for one keyword.

$0.02 / call

Keyword difficulty

keywords_difficulty

Organic ranking difficulty for one keyword and country.

$0.001 / call

Keyword intent

keywords_intent

Navigational, informational, transactional or commercial intent.

$0.01 / call

Keyword demographics

keywords_demographics

Age and gender audience distributions for one keyword.

$0 / call

Website category

website_category

Classify a domain in the Seonio website taxonomy. Starter entitlement required.

$0.10 / call

Website competitors

website_competitors

Organic competitors and overlap scores for a domain.

$0.001 / call

Similar websites

website_similar

Related websites in the same category, ordered by traffic.

$0.02 / call

Backlink history

backlink_history

Historical backlink observations for a domain.

$0.02 / call

Backlink table

backlink_table

Detailed backlink rows for a domain or full URL.

$0.02 / call

URL keywords

url_keywords

Ranked keywords, volume and position for one URL.

$0.005 / call

SEO page checker

page_checker

On-page SEO findings, assets and response timing. Starter entitlement required.

$0 / call

Account balance

account_balance

Return included usage, Extra Usage and total balance. Authenticated account tool.

Prices are in US dollars. Actions priced at $0 still require an entitled verified Starter account. A delivered empty lookup is billed; a failed fetch is not.

Connect in a minute

Browser assistants sign in with OAuth. Developer tools use your API key as a Bearer token.

Browser assistants — OAuth

Add Seonio as a custom connector and authorize in your browser. Nothing to paste.

Requires a paid plan (Plus, Pro, Business, Enterprise or Edu)

01In ChatGPT on the web, open Settings → Apps & Connectors.
02Open Advanced settings, turn on Developer mode, then click Create.
03Name it Seonio, set the MCP server URL to https://seonio.com/mcp, and choose OAuth.
04Submit and sign in through your browser — the Seonio tools appear in the connector.

Developer tools — Bearer key

Point the client at the server and send your API key as an Authorization: Bearer header.

Run in your terminal, or add to .mcp.json

claude mcp add --transport http seonio https://seonio.com/mcp \
  --header "Authorization: Bearer <apikey>"

.cursor/mcp.json

{
  "mcpServers": {
    "seonio": {
      "url": "https://seonio.com/mcp",
      "headers": {
        "Authorization": "Bearer <apikey>"
      }
    }
  }
}

.vscode/mcp.json (Copilot agent mode — you are prompted for the key)

{
  "inputs": [
    {
      "type": "promptString",
      "id": "seonio-api-key",
      "description": "Seonio API Key",
      "password": true
    }
  ],
  "servers": {
    "seonio": {
      "type": "http",
      "url": "https://seonio.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:seonio-api-key}"
      }
    }
  }
}

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "seonio": {
      "serverUrl": "https://seonio.com/mcp",
      "headers": {
        "Authorization": "Bearer <apikey>"
      }
    }
  }
}

cline_mcp_settings.json

{
  "mcpServers": {
    "seonio": {
      "type": "streamableHttp",
      "url": "https://seonio.com/mcp",
      "headers": {
        "Authorization": "Bearer <apikey>"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Raw protocol — list the available tools

curl -X POST https://seonio.com/mcp \
  -H "Authorization: Bearer <apikey>" \
  -H "Accept: application/json, text/event-stream" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Replace <apikey> with the API key from your account and send it through the MCP Bearer header.

One balance across every surface

MCP uses your Starter included usage first, then purchased Extra Usage. Calls have the same prices as matching REST endpoints.

Starter: $10 monthly or $90 yearly

$10 included usage each subscription month. New Extra Usage is valid for one year. Account-wide limit: 20 data requests per second.

See Starter and Extra Usage pricing

FAQ

Connecting Seonio's MCP server to your AI stack.

What is the MCP server and what can it do?

Seonio's Model Context Protocol server lets an AI assistant call the REST SEO capability catalog directly and adds an account-balance tool. It covers keyword metrics, Google SERPs, page and domain authority, organic traffic, rankings, backlinks, scraping and audits.

How do I authenticate?

Two ways. Browser assistants like ChatGPT and Claude use OAuth — you add Seonio as a connector and sign in, with nothing to paste. Developer tools send your API key as an HTTP header: Authorization: Bearer <apikey>.

How is MCP priced?

MCP requires Starter and uses the same balance and per-tool dollar prices as matching REST API actions. Included usage is spent first; Extra Usage expiring soonest is used next. New Extra Usage is valid for one year. The website-only revisit courtesy does not apply to MCP.

Which clients are supported?

Compatible MCP clients. We document ChatGPT and claude.ai over OAuth, and Claude Code, Cursor, VS Code, Windsurf, Cline and raw curl over a Bearer key. The server speaks streamable HTTP at https://seonio.com/mcp.

Does MCP share usage with the website and REST API?

Yes. All three surfaces share one included and Extra Usage balance, one published endpoint catalog, one activity log, and one 20 requests-per-second account limit. Qualifying website revisits are the only surface-specific pricing exception; MCP keeps the published REST prices. All MCP tools are read-only.

Start Your Starter Trial

7-day no-charge trial • Payment method required • $10 included usage

Start Starter trial