SmashSERP/ DocsGet your API key
Model Context Protocol

Connect your AI to SmashSERP

SmashSERP exposes an MCP server so you can research keywords, generate AI-citable articles, and run SEO audits directly from Claude Code, Cursor, Claude Desktop, or a ChatGPT custom connector. Everything runs against your own workspace.

1. Get your API key

Open Integrations, scroll to Connect your AI (MCP), and click New key. Copy it, it is shown once. Each key is scoped to one workspace; switch workspaces to generate keys for other brands.

Endpoint:  https://YOUR-DOMAIN/api/mcp
Auth:      Authorization: Bearer ssk_your_key

2. Add the server to your AI

Claude Code (CLI)
claude mcp add --transport http smashserp \
  "https://YOUR-DOMAIN/api/mcp" \
  --header "Authorization: Bearer ssk_your_key"
Cursor / Claude Desktop (mcp config JSON)
{
  "mcpServers": {
    "smashserp": {
      "url": "https://YOUR-DOMAIN/api/mcp",
      "headers": { "Authorization": "Bearer ssk_your_key" }
    }
  }
}
ChatGPT (custom connector)

Add a custom connector pointing at https://YOUR-DOMAIN/api/mcp with the Authorization: Bearer header above. ChatGPT will discover the tools automatically.

3. Available tools

research_keyword(keyword)

Pull the live Google SERP + AI Overview and return a content brief (intent, meta title/description, outline, questions, entities, competitors).

generate_article(topic)

Generate a full 2,500-3,500 word AI-citable article and save it as a draft in your workspace. Returns the title, slug, word count, and draft id.

audit_page(url)

Run a 30+ point technical + GEO on-page audit. Returns a 0-100 score and the failing checks with fixes.

list_articles(-)

List your workspace's recent articles (title, status, word count).

get_content_plan(-)

Return your content strategy: pillars and their planned blog titles.

Try it

Once connected, just ask your AI in plain language:

“Research the keyword local seo for dentists with SmashSERP.”
“Generate a SmashSERP article on metal roof vs shingles.”
“Audit https://mysite.com/services and list the fixes.”

Protocol notes

  • Transport: Streamable HTTP. Send JSON-RPC 2.0 requests via POST.
  • Methods: initialize, tools/list, tools/call, ping.
  • Authentication is per request via the Bearer API key. Revoke a key anytime in Integrations.
  • Generated articles are saved as drafts in your workspace for review before publishing.
Back to SmashSERPGet your API key