Skip to main content

Connect OrbiRank to Windsurf

Ask Windsurf's Cascade AI to audit your site, check rankings, and surface SEO priorities — live data from your OrbiRank account, inside your Windsurf workspace.

How to connect in 3 steps

1
Generate your OrbiRank token

Sign in to OrbiRank and go to Settings → AI / MCP Access → click Generate token. Copy it immediately — it is shown only once. (A one-step CLI login is coming soon via @orbirank/cli.)

https://orbirank.com/Settings#mcp
Generate your OrbiRank token — screenshot
2
Add OrbiRank to Windsurf

In Windsurf: Settings (gear icon) → Cascade → MCP Servers → Add. Paste the config below and click Add.

{
  "mcpServers": {
    "orbirank": {
      "url": "https://orbirank.com/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}
Add OrbiRank to Windsurf — screenshot
3
Ask in Windsurf's Cascade panel

Open Windsurf's Cascade AI panel. Ask:

Ask in Windsurf's Cascade panel — screenshot
"Show my keyword rankings and tell me which keywords I'm close to ranking on page 1 for."

What you can ask Windsurf to do

list_projects

See all your sites and their current SEO health scores at a glance.

get_project_status

Instant health score, open issues count, and next recommended action.

run_audit

Trigger a full technical audit — 20+ checks including Core Web Vitals.

get_audit_issues

Prioritised issues filterable by severity (Critical / High / Medium / Low).

get_rank_positions

Current keyword positions with 7-day and 30-day trend deltas.

get_keyword_opportunities

Content gaps where competitors rank but your site has no coverage.

Frequently asked questions

Do I need a paid OrbiRank plan to use the AI integration?
No — the free audit and basic SEO question tools work without an account. For project tracking, ranking history, and content features, a paid plan is needed.
Is my data secure when I connect to my AI assistant?
Yes. OrbiRank uses OAuth 2.1 — your AI assistant is granted limited, revocable permission. Revoke access anytime from Settings → MCP Access.
Can I connect multiple AI tools at once?
Yes — generate a separate token for each client from Settings → MCP Access. Each token can be revoked independently.

Ready to connect?

Generate your MCP token in seconds — no credit card, no setup fees.