linkguard-mcp

A stdio MCP server that gives Claude Desktop and Claude Code access to LinkGuard backlink-analysis tools.

What it does

The server exposes three tools:

All three tools require a LinkGuard API key and call the hosted API at https://linkguard.ai. No data is stored locally.

Getting an API key

1. Create a free account at https://linkguard.ai
2. Make one paid top-up (any amount) — this is a one-time gate that unlocks MCP access. Redirect-check and index-check are then free per call. Backlink-health costs 5 tokens only when a JS-rendered page is encountered.
3. Go to Dashboard → API Keys and create a key. Keys start with lg_.

Claude Desktop setup

Add this to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "linkguard": {
      "command": "uvx",
      "args": ["linkguard-mcp"],
      "env": {
        "LINKGUARD_API_KEY": "lg_your_key_here"
      }
    }
  }
}

Restart Claude Desktop after saving. You should see LinkGuard listed in the tools panel.

Claude Code setup

claude mcp add linkguard -- uvx linkguard-mcp

Then set your API key in the environment before starting a session:

export LINKGUARD_API_KEY=lg_your_key_here

Or add it to your shell profile so it is always available.

Environment variables

Manual run (for testing)

LINKGUARD_API_KEY=lg_your_key_here uvx linkguard-mcp

Or after installing locally:

pip install -e .
LINKGUARD_API_KEY=lg_your_key_here linkguard-mcp

License

MIT