SEO Toolkit MCP

MCP server for Ahrefs free-tool data: backlinks, keyword research, keyword difficulty, and traffic estimation.

Requirements

• Bun 1.3 or newer
• A CapSolver API key

Setup

bun install
CAPSOLVER_API_KEY="your-capsolver-api-key" bun run build

Run the server:

CAPSOLVER_API_KEY="your-capsolver-api-key" bun run src/index.ts

Usage with MCP clients

Installed from npm

{
  "mcpServers": {
    "SEO Toolkit MCP": {
      "command": "bunx",
      "args": ["@qexle/seo-mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "your-capsolver-api-key"
      }
    }
  }
}

Local build

{
  "mcpServers": {
    "SEO Toolkit MCP": {
      "command": "bun",
      "args": ["/absolute/path/to/seo-mcp/dist/index.js"],
      "env": {
        "CAPSOLVER_API_KEY": "your-capsolver-api-key"
      }
    }
  }
}

Tools

• get_backlinks_list(domain)
• keyword_generator(keyword, country = "us", search_engine = "Google")
• get_traffic(domain_or_url, country = "None", mode = "subdomains")
• keyword_difficulty(keyword, country = "us")

Tools cache signatures to signature_cache.json in the working directory.

Development

bun test          # fails if coverage drops below 100%
bun run typecheck
bunx oxlint .
bun run build

License

MIT. See LICENSE.