Changelog

September 2026

SEO Software projects, productMode, and POST /projects

Ranked AI now has a self-serve tier: SEO Software projects the account runs itself (rank tracking, AI visibility prompts, audits, backlinks, heatmaps, integrations, reports), billed as prepaid blocks of $4.99/month per 100 tracked keywords or 100 AI prompts, one plan per account. Managed-service projects are unchanged, and their plans include the whole software suite at no extra cost.

REST API

• Every project payload carries productMode: managed or software
• GET /projects accepts ?product_mode=managed|software
• New POST /projects creates a software project from a website URL (write key). No plan or payment is needed to create it; the response says whether the account's software plan is active and where to add one, and carries an addServiceUrl for upgrading the project to the managed service later
• Content endpoints return no items for software projects (there is no content pipeline without the service)

MCP

• New write tool ranked_create_software_project
• ranked_get_project_overview reports each project's productMode; accounts with software projects also get softwarePlan and, per software project, addServiceUrl
• The content tools (ranked_request_topic, ranked_approve_content, ranked_request_revision, ranked_update_content_preferences, ranked_update_publishing_preferences) explain the managed-service upgrade on software projects instead of acting

The MCP integration is now 22 tools (11 read, 11 write).

Docs

• The developer docs moved from dev.ranked.ai to www.ranked.ai/developers. Old URLs redirect one-to-one, including the agent files: llms.txt, llms-full.txt, per-page .md, the OpenAPI spec and the agent skill

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