Skip to main content

​
August 2026

​
MCP: modern protocol support, new endpoint URL, and traffic tools

New canonical endpoint The MCP server now lives at https://app.ranked.ai/api/mcp. The previous URL (/api/mcp/sse) keeps working forever — existing connections don’t need to change. Use the new URL for new setups. Modern protocol support The server now speaks the current MCP revisions alongside the legacy ones:
  • Supports the stateless 2026-07-28 revision, including server/discover
  • Negotiates the protocol version your client requests (2025-03-26 through 2026-07-28; legacy 2024-11-05 clients are unaffected)
  • Fixes connection failures in clients that rolled out the 2026 spec — most visibly Claude custom connectors, which could complete OAuth but never finish connecting
New tools
  • ranked_get_search_console_metrics — Google Search Console impressions, clicks, CTR, and top queries over any window (trailing days or exact dates)
  • ranked_get_analytics_metrics — Google Analytics sessions, users, page views, and channel breakdown over any window
The MCP integration is now 21 tools (11 read, 10 write). Faster and smoother
  • ranked_get_project_overview answers several times faster (its queries now run in parallel)
  • The server returns usage instructions with the handshake, so connected AI tools use the right call order on the first try
  • Rate limiting no longer applies to connection handshakes, only to tool calls

​
May 2026

​
v1.0 — Initial Release

The Ranked AI REST API, MCP integration, and webhook system are now available. API Endpoints
  • 21 REST API endpoints covering keywords, AI visibility, audits, backlinks, content, reports, and webhooks
  • Bearer token authentication with read-only and read+write API key scopes
  • Rate limiting: 200/min, 5,000/hr, 50,000/day per key
  • Pagination up to 1,000 results per request
Keywords
  • Positions across Desktop, Mobile, AI Mode, and Google Maps
  • Net change calculation across all four channels
  • Position history with date range filtering
AI Visibility
  • Brand visibility tracking across ChatGPT, Claude, Gemini, Perplexity, Grok, and Meta Llama
  • Per-model response history with full citations
  • AI search volume estimates
Audits
  • Latest audit results with issue counts by severity
  • Issue details with affected page counts
Backlinks
  • Referring domains with domain rank and follow status
  • Anchor text analysis
  • Daily new/lost history
Content
  • Content calendar with status and scheduling
  • Full article content retrieval
  • Content preference management
Reports
  • Create shareable report links with preset or custom date ranges
  • List and manage existing reports
Webhooks
  • 8 event types: content.created, content.status_changed, audit.started, audit.completed, keywords.updated, prompts.updated
  • HMAC-SHA256 signature verification
  • Automatic retry with exponential backoff
  • SSRF protection on webhook URLs
MCP Integration
  • 18 MCP tools (10 read, 8 write)
  • Compatible with ChatGPT, Claude, Cursor, and other MCP clients
  • OAuth 2.0 authentication
Security
  • API keys hashed at rest (SHA-256)
  • Scope enforcement on all write endpoints
  • Private IP blocklist on webhook URLs
  • Fail-closed rate limiting