Guides

hreflang MCP server

The MCP endpoint at https://hreflang.com/mcp gives AI assistants three tools: check_hreflang_cluster, check_hreflang_page and validate_hreflang_code. The server is stateless, speaks protocol revision 2026-07-28 and still accepts the initialize handshake from clients on 2025-11-25, 2025-06-18 and 2025-03-26. No key is needed. The same rate limits as the API apply.

Claude Code

claude mcp add --transport http hreflang https://hreflang.com/mcp

Cursor, VS Code and other clients

{
  "mcpServers": {
    "hreflang": {
      "type": "http",
      "url": "https://hreflang.com/mcp"
    }
  }
}

Long checks

A cluster check inside a tool call waits up to 90 seconds. A larger cluster returns the job status and a report URL, and the report finishes in the background. Support for the MCP Tasks extension follows once clients ship it.

The registry manifest is at /server.json.