Hreflang Tag Generator

Seo REST API MCP

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 HTTP endpoint POST /api/tools/hreflang-tag-generator/execute. See the MCP reference →

Call it over REST

POST https://api.findutils.com/api/tools/hreflang-tag-generator/execute · no API keys · 60 requests/min per IP

Execute — verified arguments

curl -X POST https://api.findutils.com/api/tools/hreflang-tag-generator/execute \
  -H "Content-Type: application/json" \
  -d '{
    "variants": [
      {
        "language": "en",
        "region": "US",
        "url": "https://example.com/en-us/",
        "x_default": true
      },
      {
        "language": "de",
        "url": "https://example.com/de/"
      }
    ]
  }'

Parameter schema for this endpoint

curl https://api.findutils.com/api/tools/hreflang-tag-generator

Interactive docs · OpenAPI 3.1 spec · All REST tools

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 an MCP tool

Claude, Cursor, and any MCP client can call this tool as findutils:hreflang_tag_generator after one connect command.

Connect once

claude mcp add findutils --transport http https://mcp.findutils.com/
Open the MCP reference for Hreflang Tag Generator →

More Seo tools