MCP Server

SurfRank inside every AI agent

The Model Context Protocol (MCP) is an open standard for giving AI assistants access to external tools. SurfRank's MCP server exposes every platform capability — 24+ tools — to any MCP-compatible client: Claude Desktop, Cursor, Claude Code, Windsurf, ChatGPT, Perplexity.

1

Talk to your agent

"Run an AI visibility report for acme.com and tell me where we're losing."

2

Agent calls SurfRank

Your agent picks the right tool (`trigger_report`) and runs it with your API key.

3

Results flow back

Scores, competitors, recommendations — inside the agent conversation.

Install in 60 seconds

Best for Claude Desktop, Cursor, Claude Code, and Windsurf. Runs via npx — no install required.

{
  "mcpServers": {
    "surfrank": {
      "command": "npx",
      "args": ["-y", "@surfrank/mcp-server"],
      "env": { "SURFRANK_API_KEY": "sr_your_key_here" }
    }
  }
}

Paste into claude_desktop_config.json (or the equivalent for your client) and restart.

Available tools (24+)

One MCP tool per SurfRank endpoint. Your agent discovers and invokes them automatically — no manual wiring.

Projects

list_projects

get_project

create_project

update_project

delete_project

Keywords

list_keywords

add_keyword

add_keywords_bulk

delete_keyword

Reports

list_reports

get_report

trigger_report

get_latest_analyses

Quick Tests

run_quick_test

list_quick_tests

get_quick_test

select_quick_test_keywords

Research

research_keyword

list_keyword_research

get_keyword_research

Competitors & Opportunities

list_competitors

add_competitor

delete_competitor

list_opportunities

Example prompts

"Create a SurfRank project for acme.com and track these 10 keywords."

"What did my latest AI visibility report show? Which engines are missing my brand?"

"Run a quick test for competitor.com and compare it to my visibility score."

"List my top 5 content opportunities and draft articles for the highest-impact ones."

Ready to wire it up?

Grab your API key and follow the full setup guide for your client.

Get API key npm package