HrefGate MCP server
Commit Oct 18, 2026Lints hreflang attributes including language codes, x-default, self-references, canonicals, and return links without fetching URLs.
Also known as miketusa-ctrl/hrefgate
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Oct 18, 2026
- License
- MIT
What is HrefGate MCP?
HrefGate lints hreflang attributes including language codes, x-default, self-references, canonicals, and return links without fetching URLs.
Summary generated from the project's README
About HrefGate MCP server
Validating hreflang attributes for SEO accuracy is what HrefGate enables for developers using AI coding assistants. It provides a way to lint language codes, x-default tags, self-references, canonical links, and return links without the server ever fetching the actual URLs. This approach ensures privacy and efficiency during the auditing process.
As a remote MCP server using Streamable HTTP, it connects to clients like Cursor, Windsurf, and Cline via a specific URL. Claude Desktop users can add it as a custom connector or use the mcp-remote bridge for local-only clients. Developers who want to host their own version can deploy it using Node.js 22 and Cloudflare, utilizing Wrangler for local development and deployment.
The service is available through a free plan and provides the lint_hreflang tool to perform these specific SEO checks. Because it operates as a remote service, it avoids the overhead of local environment setup while maintaining specialized focus on hreflang integrity.
What you can do with it
- 1Perform privacy-focused SEO checksRun audits on your site structure without allowing the server to fetch your live URLs.
Written from the project's README. Every use case is checked against a quote from it.
README
View on GitHubHrefGate
Lint hreflang: codes, x-default, self-reference, canonical, return links. Never fetches URLs.
Live service
- Web app and API: https://hrefgate.mike-tusa.workers.dev/
- Plans: Free, no paid plan (https://hrefgate.mike-tusa.workers.dev/)
- Support: digitalpromohub.support@gmail.com
Use it from an AI assistant (MCP)
HrefGate is a remote MCP server (Streamable HTTP) at https://hrefgate.mike-tusa.workers.dev/mcp. Tools: lint_hreflang.
Cursor and Windsurf accept this config:
{
"mcpServers": {
"hrefgate": {
"type": "http",
"url": "https://hrefgate.mike-tusa.workers.dev/mcp"
}
}
}
Cline (MCP Servers > Remote Servers, or cline_mcp_settings.json) needs "type": "streamableHttp":
{
"mcpServers": {
"hrefgate": {
"type": "streamableHttp",
"url": "https://hrefgate.mike-tusa.workers.dev/mcp"
}
}
}
Claude Desktop: open Settings > Connectors, choose "Add custom connector" and paste https://hrefgate.mike-tusa.workers.dev/mcp. Or, for clients that only support local (stdio) servers, use the mcp-remote bridge: npx mcp-remote https://hrefgate.mike-tusa.workers.dev/mcp.
VS Code uses a servers key instead of mcpServers.
The server.json file is the MCP Registry manifest for this server.
Run your own copy
Requires Node.js 22+ and a Cloudflare account.
npm install
npx wrangler@4 dev # local dev server
wrangler.toml is a template: create your own KV namespaces / D1 databases / rate-limit namespaces and replace the <PLACEHOLDER> values before npx wrangler@4 deploy. Any secrets the Worker reads go in wrangler secret put (or .dev.vars locally), never in the repo.
License
MIT (c) Digital Promo Hub. See LICENSE.
HrefGate MCP questions
Does this server fetch URLs?
No, the server never fetches URLs during the linting process.
What can HrefGate lint?
It lints hreflang codes, x-default, self-reference, canonical, and return links.
How do I use HrefGate with Claude Desktop?
You can add it via Settings > Connectors by choosing 'Add custom connector' and pasting the server URL, or use the mcp-remote bridge.