Skip to main content
MCP Integration — Advanced Setup

Connect OrbiRank to your AI assistant

OrbiRank supports the Model Context Protocol (MCP) — the open standard that lets AI assistants like Claude, ChatGPT, and Cursor call real tools in your workflow. Run live SEO audits, surface fix recommendations, and track rankings without leaving your AI chat interface.

Guided setup — choose your AI:
Or continue below for the full manual / advanced setup guide.
Claude (Anthropic) Cursor Windsurf Any MCP client

MCP server endpoint

OrbiRank's MCP server speaks Streamable HTTP JSON-RPC 2.0. Point your MCP client to:

https://orbirank.com/mcp

A GET /mcp returns the full tools/list manifest (unauthenticated — no token needed for discovery). Tool calls require an MCP bearer token — see the setup steps below.

Quick setup — Claude Desktop

Add OrbiRank to your claude_desktop_config.json (usually at ~/Library/Application Support/Claude/ on macOS):

{ "mcpServers": { "orbirank": { "url": "https://orbirank.com/mcp", "transport": "http", "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" } } } }

Replace YOUR_MCP_TOKEN with the token from your OrbiRank Settings → MCP Access page.

How to get an MCP token

  1. Sign in to OrbiRank

    Use your email address — OrbiRank authenticates via a one-time passcode, no password required.

  2. Go to Settings → MCP Access

    Navigate to Settings → MCP Access in your OrbiRank account and generate a new token.

  3. Copy the token

    The token is shown once. Copy it and paste it into your MCP client configuration (see examples above and below).

  4. Ask your AI assistant to use OrbiRank

    In Claude, Cursor, or your MCP client, you can now ask things like:
    "Run an SEO audit on example.com", "What are the top fix priorities for my site?", or "Show me keyword rankings for my project."

Available MCP tools

These tools are available via your MCP client once connected. Your AI assistant can call them directly to get real, live data from your OrbiRank account.

list_projects

List all your tracked sites with their current SEO health scores and optimization stage.

get_project_status

Get the current ladder stage, health score, open issues count, and next recommended action for a project.

run_audit

Trigger a full technical audit — 20+ checks including Core Web Vitals, canonicals, hreflang, structured data, and AI-crawler access.

get_audit_issues

Retrieve prioritised issues from the latest audit, filterable by severity (Critical / High / Medium / Low) and fix status.

get_rank_positions

See current keyword positions and trend data vs 7 / 30 days ago — with top-3 / top-10 flags and data-source attribution.

get_keyword_opportunities

Surface content gaps — keywords and topics where competitors rank but your site has no coverage — ordered by priority score.

get_content_brief

Generate an AI-written content brief: H1/H2 outline, semantic keywords, word count, E-E-A-T requirements, and schema type recommendation.

generate_content

Run the 6-stage AI content pipeline (Outline → Sections → Editorial → Quality → E-E-A-T → Information gain) to produce a publish-ready article.

get_backlink_profile

Read-only backlink insights: referring domain count, estimated authority, and top linking domains sourced from Search Console and OpenPageRank.

get_bing_query_stats

Pull Bing Webmaster Tools query performance: clicks, impressions, average position, and CTR for any date range.

The full tool manifest is always available at GET https://orbirank.com/mcp — no token needed. MCP-compatible AI clients discover tools automatically from this endpoint.

OpenAPI description

If your AI client supports OpenAPI rather than MCP, an OpenAPI 3.1 description is available at:

GET https://orbirank.com/mcp/openapi

Start with a free audit — no account needed

Try OrbiRank's live SEO audit before signing up. Paste any URL and get a health score and ranked issue list in ~30 seconds.

Run a free audit