API for AI agents
MCP server
Connect Claude Code, Claude Desktop, Cursor, or any MCP client to RankPine — your SEO pipeline as native agent tools.
RankPine ships a hosted MCP (Model Context Protocol) server. Point any MCP client at it and your AI agent gets RankPine's capabilities as native tools — no HTTP glue code, no SDK.
- Endpoint:
https://rankpine.com/api/mcp - Transport: Streamable HTTP (stateless)
- Auth: the same API keys as the REST API, sent as
Authorization: Bearer rp_live_…
Setup
Claude Code
claude mcp add rankpine https://rankpine.com/api/mcp \
--transport http \
--header "Authorization: Bearer rp_live_your_key_here"Claude Desktop / claude.ai
Add a custom connector with URL https://rankpine.com/api/mcp and an
Authorization: Bearer rp_live_… header (Settings → Connectors → Add custom
connector).
Cursor
{
"mcpServers": {
"rankpine": {
"url": "https://rankpine.com/api/mcp",
"headers": { "Authorization": "Bearer rp_live_your_key_here" }
}
}
}Any other client
Every MCP client that speaks Streamable HTTP works the same way: URL + authorization header. The server is stateless, so no session juggling.
Available tools
| Tool | What it does |
|---|---|
whoami | Verify the key; list the account's sites + subscription |
list_sites / get_site | Site profiles, settings, and article quota |
list_keywords | The keyword library with volume/difficulty/intent |
import_keywords | Bulk-import up to 500 keywords |
suggest_keywords | Instant AI suggestions (not saved) |
generate_keywords | Queue the full AI keyword research pass |
delete_keywords | Prune the library |
list_articles / get_article | Articles incl. full markdown/HTML + SEO scorecard; filter list_articles by language |
generate_article | Start writing an article for a keyword |
get_search_console_status / sync_search_console | GSC connection + refresh |
get_search_performance / get_top_search_queries | Search analytics |
get_subscription | Billing status + per-site usage |
Things agents should know
- Generation is asynchronous.
generate_articlereturns immediately; a full article takes several minutes. Pollget_articleuntilstatusis"ready". - Credits are real. Each generated article consumes one of the site's ~30
monthly credits — check
get_subscriptionbefore batch-generating. - One generate can produce several articles, but costs one credit. If
get_sitereportsadditional_languages, the article is also localised into each of them — those are covered by a paid add-on, not metered. The versions are separate articles sharing atranslation_group_id;list_articlesreturns one row per version, so filter bylanguageif you want just one. - Rate limits are shared with the REST API (120/min, 10k/day per key).
- Errors come back as tool results, not protocol failures, so your agent can
read the reason (
quota_exceeded,rate_limited, …) and adapt.
Try it: connect the server and ask your agent — “check my RankPine sites and suggest ten keywords for the weakest one, then queue the two best as articles.”