MCP server
Use Autoranko from your AI assistant (MCP)
Autoranko runs a remote MCP server, so assistants such as Claude, ChatGPT, Claude Code, Cursor and VS Code can audit pages, research keywords and write or publish articles on your account. Claude and ChatGPT sign in with OAuth; other clients can use an API token.
- About 5 minutes to connect (estimate)
- Last verified November 8, 2026
How it connects
The Model Context Protocol (MCP) lets an AI assistant call tools on another service. Autoranko’s MCP server is remote, so there’s nothing to install: your client sends requests over Streamable HTTP to https://autoranko.com/api/mcp, signed in through OAuth or with an API token in the Authorization header, and the server answers with tool results.
The tools are generated from the same reference as the REST API and the OpenAPI file, so they always match what the API can do. Tools that save results put them in Dashboard → Settings → API & Apps → Saved results; tools that create or publish articles act on your real sites and use your plan’s allowances.
Connect your assistant
- 1
Choose how it signs in
Claude and ChatGPT sign in with OAuth: you approve access on an Autoranko consent screen and choose what the app may do, read-only if you prefer. For Claude Code, Cursor or VS Code you can instead create a token in Dashboard → API & Apps, limited to the scopes and sites it needs.
- 2
Add the server to your client
In Claude, add a custom connector with the URL https://autoranko.com/api/mcp (Customize → Connectors). In ChatGPT, add it as a custom MCP server with OAuth. Token clients add a remote (HTTP) server with the same URL and an Authorization header with Bearer and the token; in Claude Code that’s one claude mcp add command. The MCP docs have the exact steps.
- 3
Check the connection
Ask the assistant which Autoranko account it’s connected to: it calls whoami and shows your account and plan. If the tools don’t appear, see the troubleshooting section below.
- 4
Ask for real work
Ask it to audit a page, find keyword ideas for a connected site, or write an article and keep it in review. Ask before publishing: publish_job changes your live site.
What your assistant can do
The MCP server exposes 34 tools, generated from the same reference as the REST API:
whoamiGet the current accountlist_sitesList sitesget_siteGet a site with usagelist_articlesList synced articlesget_articleGet an articlelist_article_jobsList jobscreate_article_jobCreate a jobget_article_jobGet a jobpublish_jobPublish a jobsite_keyword_researchResearch keywordsgeo_list_promptsList tracked promptsgeo_add_promptsAdd promptsgeo_start_runStart a rungeo_list_runsList runsgeo_get_runGet a run with its answersgeo_statsGet visibility metricsgeo_competitorsList the names AI answers givegeo_ai_trafficGet AI-assistant traffic (GA4)seo_analyzeAudit a pageseo_keyword_researchResearch keywords for any siteseo_write_articleWrite a long-form articleseo_write_short_articleWrite a short articleseo_meta_tagsWrite title and meta description variantsseo_open_graphGenerate Open Graph and Twitter tagsseo_schemaGenerate JSON-LD structured dataseo_headingsPlan the heading structureseo_content_briefCreate a content briefseo_rewriteRewrite copy for SEOseo_alt_textsWrite image alt textrobots_sitemapGenerate robots.txt and a sitemapserp_previewPreview a Google resultlist_seo_analysesList saved analysesget_seo_analysisGet a saved analysislist_ai_modelsList AI models
Limits and honest caveats
Apps signed in with OAuth get only the permissions you approve, and you can disconnect them at any time in Dashboard → API & Apps. Clients that only run local (stdio) servers need a bridge to a remote server; our own npm package isn’t published yet.
Requests are rate-limited per token, like the REST API. Long tasks such as writing a full article take a few minutes, during which the assistant waits for the tool or polls the job. Keyword metrics returned by the tools are AI estimates and are labeled as such.
Troubleshooting
The messages below are exactly what Autoranko shows in the dashboard or returns from the API, with what they mean and how to fix them.
missing_token- The request reached the server without credentials. OAuth clients start the sign-in from this answer; token clients must send Authorization: Bearer ar_live_…
invalid_token- The token is malformed, revoked, expired or mistyped. Reconnect the app, or create a new token in Dashboard → API & Apps and update the client’s configuration.
rate_limited- The assistant sent too many requests in a short time. Wait for the number of seconds in the Retry-After header, and ask for fewer parallel calls if it keeps happening.
- The client lists no Autoranko tools
- Make sure the server is configured as a remote HTTP (Streamable HTTP) server, not as a local command, and that the URL ends in /api/mcp. Restart the client after editing its configuration.
Questions
Which assistants work?+
Is it safe to give an assistant access?+
Does it cost extra?+
Go deeper
Related integrations
Connect your site in minutes
Start on the free plan — no card — and publish your first article to your own platform.