autorank-mcp
io.github.RyanKramer/autorank-mcp
Documentation
AutoRank MCP
Technical SEO tools for AI agents. Generate and validate structured data, build meta tags and crawl directives, check how a result will actually render in Google, and analyse copy — all from inside Claude, Cursor, or any MCP client.
No API key. No account. No network calls. Every tool is a pure function, so the server does its job offline and installs in one line.
Browser versions of these tools live at autorank.so/free-tools.
Install
Claude Desktop — add to claude_desktop_config.json:
{
"mcpServers": {
"autorank": {
"command": "uvx",
"args": ["autorank-mcp"]
}
}
}
Or with pip:
pip install autorank-mcp
Then point your client at the autorank-mcp command. No environment variables
are required.
Tools
Structured data
| Tool | What it does |
|---|---|
generate_faq_schema | FAQPage JSON-LD from question/answer pairs |
generate_article_schema | Article JSON-LD with author and dates |
generate_breadcrumb_schema | BreadcrumbList JSON-LD |
generate_local_business_schema | LocalBusiness JSON-LD with postal address |
validate_json_ld | Parses a block, checks required fields per type, flags risky patterns |
Meta and crawl directives
| Tool | What it does |
|---|---|
generate_meta_tags | Full head block: title, description, canonical, OG, Twitter Card |
generate_robots_meta | Robots meta tag from directives, with a plain-English explanation |
generate_robots_txt | robots.txt, optionally blocking the major AI crawlers |
validate_robots_txt | Validates syntax and surfaces the mistakes that cause real damage |
generate_hreflang | hreflang tags, with the return-link requirement spelled out |
SERP and copy
| Tool | What it does |
|---|---|
check_title_length | Pixel-width truncation check for titles |
check_description_length | Pixel-width truncation check for descriptions |
serp_preview | How the whole result renders, breadcrumb included |
keyword_density | Word and phrase frequency with a stuffing warning |
readability_score | Flesch Reading Ease and grade level |
Utilities
| Tool | What it does |
|---|---|
build_utm_link | UTM-tagged tracking URLs, warns on case-inconsistency |
slugify | Clean URL slugs from titles |
autorank_free_tools | Lists the web-only tools that need live crawling |
Design notes
Title checks measure pixels, not characters. Google truncates on rendered
width, and character counts mislead badly — sixty capital Ws and sixty is
occupy very different space. Titles are the most common cause of a rewritten
snippet, so the check approximates width instead.
The schema tools will not help you lie. validate_json_ld flags
aggregateRating whenever it appears, because fabricated ratings are a
documented cause of manual actions, and generate_faq_schema states plainly
that the answers must already be visible on the page. Structured data that
disagrees with rendered content is a spam signal, not a shortcut.
Some tools are deliberately absent. Anything needing live crawling or a
keyword corpus — broken-link checking, keyword difficulty, sitemap extraction,
duplicate-content detection — is not a pure function, so it stays on the web
where it belongs. autorank_free_tools lists those.
robots.txt controls crawling, not indexing. validate_robots_txt says so in
its output, because conflating the two is the single most common way sites
accidentally leave pages in the index.
Development
git clone https://github.com/RyanKramer/autorank-mcp
cd autorank-mcp
pip install -e .
autorank-mcp
About
Built by AutoRank — AI SEO content automation. The web versions of these tools, plus about thirty more, are free at autorank.so/free-tools.
MIT licensed.
