MCP connector

Connect Claude, Cursor or any Model Context Protocol client to our SEO tools. The endpoint speaks JSON-RPC 2.0 over HTTP - no SDK required.

Endpoint

POST /api/mcp

Public tools (no key)

rank_check

A domain's live Google organic position for a keyword.

ai_presence

Whether a domain appears in / is cited by Google AI Overview and AI Mode.

page_meta

A URL's title, meta description, H1 and headings.

Workspace tools (content API key)

Send a content API key (create one on a project's Publishing page) as Authorization: Bearer sbk_... or X-API-Key. These tools then appear in tools/list, scoped to what that key can see: one project, or one workspace, never another.

list_projects

The projects this key can see, with the grade of each one's latest finished audit.

list_articles

Generated articles, newest first. Same fields as GET /api/v1/articles.

generate_article

Start writing an article for a keyword (optional title and brief). Spends credits; returns a job to poll.

get_article_status

Where a generation job stands: queued, drafting, revising, done (article_id set) or failed.

list_integrations

A project's publishing connections with id, health and draft-vs-live default.

publish_article

Publish an article through one connection. Reports the recorded publish event and whether the page is verified live.

get_latest_audit

The latest finished audit: score, grade, verdict, check totals, category scores, top recommendations.

rank_history

Per-keyword Google positions over time for the project's domain.

Example: list tools

curl -X POST https://searchblueprint.io/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Example: call a tool

curl -X POST https://searchblueprint.io/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"rank_check","arguments":{"domain":"example.com","keyword":"seo audit","country":"sg"}}}'

Example: start an article (keyed)

curl -X POST https://searchblueprint.io/api/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sbk_YOUR_KEY" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"generate_article","arguments":{"keyword":"bridal gown alterations singapore"}}}'

Claude Code

claude mcp add --transport http searchblueprint https://searchblueprint.io/api/mcp --header "Authorization: Bearer sbk_YOUR_KEY"

Supports initialize, tools/list and tools/call. Public tools: 30 calls a minute per IP. Workspace tools: 60 calls a minute per key, counted separately. Public lookups use the same live SERP data as the rest of the suite; the full reference is in the MCP guide. For prompts written against these tools, with a paste-first brief and a cadence for each, see the Claude SEO playbook.