autoranko

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. 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. 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. 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. 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 account
  • list_sitesList sites
  • get_siteGet a site with usage
  • list_articlesList synced articles
  • get_articleGet an article
  • list_article_jobsList jobs
  • create_article_jobCreate a job
  • get_article_jobGet a job
  • publish_jobPublish a job
  • site_keyword_researchResearch keywords
  • geo_list_promptsList tracked prompts
  • geo_add_promptsAdd prompts
  • geo_start_runStart a run
  • geo_list_runsList runs
  • geo_get_runGet a run with its answers
  • geo_statsGet visibility metrics
  • geo_competitorsList the names AI answers give
  • geo_ai_trafficGet AI-assistant traffic (GA4)
  • seo_analyzeAudit a page
  • seo_keyword_researchResearch keywords for any site
  • seo_write_articleWrite a long-form article
  • seo_write_short_articleWrite a short article
  • seo_meta_tagsWrite title and meta description variants
  • seo_open_graphGenerate Open Graph and Twitter tags
  • seo_schemaGenerate JSON-LD structured data
  • seo_headingsPlan the heading structure
  • seo_content_briefCreate a content brief
  • seo_rewriteRewrite copy for SEO
  • seo_alt_textsWrite image alt text
  • robots_sitemapGenerate robots.txt and a sitemap
  • serp_previewPreview a Google result
  • list_seo_analysesList saved analyses
  • get_seo_analysisGet a saved analysis
  • list_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?+
Claude and ChatGPT connect with OAuth sign-in. Claude Code, Cursor, VS Code and any client that supports remote Streamable HTTP servers can also use an API token in a custom header.
Is it safe to give an assistant access?+
With OAuth you approve what the app may do, read-only for example, and can disconnect it at any time. A token limited to the scopes and sites an assistant needs is safer than a full-access one: keep it out of shared files and revoke it in Dashboard → API & Apps if it leaks.
Does it cost extra?+
No. MCP calls use the same plan allowances as the dashboard and the API: computed tools are free, AI tools count toward your monthly AI actions, and articles toward your article allowance.

Connect your site in minutes

Start on the free plan — no card — and publish your first article to your own platform.