Skip to content
Reference

MCP server

Connect AI agents to Rankspire with the Model Context Protocol. The server uses the stateless streamable HTTP transport at /api/mcp and authenticates with the same API keys.

Client configuration

Add the server to any MCP-compatible client.

{
  "mcpServers": {
    "rankspire": {
      "type": "http",
      "url": "https://rankspire.tech/api/mcp",
      "headers": { "Authorization": "Bearer rsk_live_…" }
    }
  }
}

Tools

list_websites, add_website, delete_website, list_keywords, add_keywords, remove_keywords, search_console_performance, serp_overview, serp_keywords, ai_visibility, list_campaigns, run_audit, get_audit, submit_urls_for_indexing, indexing_status, generate_report. Read-only keys only see read tools.

Confirmation for destructive actions

delete_website, remove_keywords and submit_urls_for_indexing are annotated as destructive. The first call returns a confirmation request describing the impact. Agents must ask the user and only call again with confirm=true after explicit approval.

→ tools/call delete_website { "websiteId": "cm1…" }
← "Confirmation required: This will permanently delete example.com … call again with \"confirm\": true."