Docs/MCP Server

MCP Server

Solve CAPTCHAs directly from Claude Desktop, Cursor, Windsurf, and any MCP-compatible tool.

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external tools. With the GateSolve MCP server, any MCP-compatible AI tool can solve CAPTCHAs using x402 micropayments.

Quick Start

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "gatesolve": {
      "command": "npx",
      "args": ["@gatesolve/mcp-server"]
    }
  }
}

Cursor / Windsurf

Add to your project's .cursor/mcp.json or MCP settings:

{
  "mcpServers": {
    "gatesolve": {
      "command": "npx",
      "args": ["@gatesolve/mcp-server"]
    }
  }
}

From Source

git clone https://github.com/arsonx-dev/gatesolve-mcp.git
cd gatesolve-mcp
npm install
npm run build
npm start

Available Tools

solve_captchaCORE

Solve any supported CAPTCHA type. Handles the full x402 payment flow.

type — cloudflare-turnstile | recaptcha-v2 | recaptcha-v3 | hcaptcha
siteKey — the CAPTCHA widget key
pageUrl — URL of the page with the CAPTCHA
paymentToken — x402 payment proof (optional, returns pricing if omitted)
list_captcha_types

Discover supported types, pricing, accuracy, and required fields.

check_gatesolve_status

Check API health, service status, and solve metrics.

Example Conversation

You

I need to solve the Cloudflare Turnstile on example.com. The site key is 0x4AAAAAAABkMYinukE8nzYS.

AI

I'll solve that for you. The CAPTCHA requires a payment of 0.02 USDC on Base network.

[Uses solve_captcha tool → returns token in 2.3s]

Open Source

MIT licensed. Contributions welcome.

View on GitHub