@useagentstore/solve-mcp

MCP server that exposes CAPTCHA solving as a tool to any MCP-enabled AI agent (Claude Desktop, Claude Agent SDK, Cursor, Windsurf, etc.).

Pluggable in seconds. Auto-signup on first use — 100 free calls, no account required.

Install & connect

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "solve": {
      "command": "npx",
      "args": ["-y", "@useagentstore/solve-mcp"]
    }
  }
}

Restart Claude Desktop. Your agent now has a solve_turnstile tool.

Claude Agent SDK (TypeScript)

import { Agent } from '@anthropic-ai/claude-agent-sdk';

const agent = new Agent({
  mcpServers: {
    solve: {
      command: 'npx',
      args: ['-y', '@useagentstore/solve-mcp'],
    },
  },
});

Cursor / Windsurf

Same mcpServers block structure — drop it in their MCP settings.

Persisting your API key

On first run the server auto-signs-up and logs the generated key to stderr:

[solve-mcp] auto-signed-up. To persist, set SOLVE_API_KEY=sk_... in your MCP server config.

Copy that key into your config to survive restarts:

{
  "mcpServers": {
    "solve": {
      "command": "npx",
      "args": ["-y", "@useagentstore/solve-mcp"],
      "env": { "SOLVE_API_KEY": "sk_..." }
    }
  }
}

Tool

solve_turnstile

Solves a Cloudflare Turnstile challenge and returns a valid token.

Input:

| Param | Type | Required | |---|---|---| | url | string | yes — the page URL where Turnstile is embedded | | sitekey | string | yes — the widget's data-sitekey |

Output: JSON SolveResult with { success, token, backend, solvedInMs, confidence } or { success: false, error }.

License

MIT