Generate hreflang annotations for multilingual pages and return them as HTML <link> tags, an HTTP Link header, and an XML sitemap block, plus validation issues (invalid URL, language, or region code, duplicate language-region pairs, missing x-default). Pass one page group as variants, or several as groups.
This page documents the MCP tool findutils:hreflang_tag_generator. See the REST reference →
Call it over MCP
Tool name findutils:hreflang_tag_generator
· no API keys · 120 requests/min per IP
Claude Code
claude mcp add findutils --transport http https://mcp.findutils.com/ Claude Desktop — claude_desktop_config.json
{
"mcpServers": {
"findutils": {
"url": "https://mcp.findutils.com/"
}
}
} Raw JSON-RPC (any MCP client) — verified example
curl -X POST https://mcp.findutils.com/ \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "hreflang_tag_generator",
"arguments": {
"variants": [
{
"language": "en",
"region": "US",
"url": "https://example.com/en-us/",
"x_default": true
},
{
"language": "de",
"url": "https://example.com/de/"
}
]
}
}
}' Input schema
| Argument | Type | Required | Description |
|---|---|---|---|
| variants | array | no | Shortcut for a single page group: array of { language, region?, url, x_default? }. language is an ISO 639-1 code (en, de, tr); region is an ISO 3166-1 alpha-2 code (US, GB). |
| groups | array | no | Several page groups: array of { base_url?, variants: [...] }. Each group is one page and its translations. |
| format | string (all | html | http | xml) | no | Which output to fill. "all" fills html, http_headers, and xml_sitemap; a single format leaves the others empty. Default "all". Default: "all". |
Example arguments (verified)
{
"variants": [
{
"language": "en",
"region": "US",
"url": "https://example.com/en-us/",
"x_default": true
},
{
"language": "de",
"url": "https://example.com/de/"
}
]
} Also a REST endpoint
The same tool answers plain HTTP at
POST /api/tools/hreflang-tag-generator/execute — no key, 60 requests/min.
More Seo tools
Bot Crawl Checker
Return which of 24 well-known crawlers (Googlebot, BingBot, GPTBot, ClaudeBot, PerplexityBot, AhrefsBot, Twitterbot and more) are allowed or
Domain Rating Checker
Return the Ahrefs Domain Rating (0-100) for up to 25 domains in one call, with a per-domain status.
Faq Schema Generator
Generate FAQPage JSON-LD structured data from question-answer pairs, and return the JSON-LD string, a ready <script> tag, the schema object,
Form To Json Schema
Returns a form schema object ({ formId, method, action, fields, submitText }) extracted from HTML form markup.
Geo Analyzer
Return a Generative Engine Optimization (GEO) report for a public web page: an overall 0-100 score, per-category scores (technical, content,
Graphql Schema Validator
Validate a GraphQL SDL schema and return errors, naming-convention warnings, and counts of types, queries, mutations, and subscriptions.
Heading Structure Analyzer
Analyze the H1-H6 heading hierarchy of an HTML document and return every heading, SEO warnings (missing or multiple H1, skipped levels, empt
Json Ld Generator
Generate JSON-LD structured data for 12 schema.org types (Article, BlogPosting, Product, Organization, LocalBusiness, Person, Event, FAQPage