captcha-mcp — MCP server for Claude Code
MCP server with tools to embed proof-of-work CAPTCHA into agent auth flows. No API keys or payments required — or pay via Lightning for trusted clients.
no license 4,324 installs updated 2026-05-10
claude mcp add --transport http captcha-mcp https://captcha-mcp--zekebuilds.run.toolsWhat captcha-mcp does
captcha-mcp exposes three tools: challenge requests a fresh PoW challenge with salt, difficulty and signature; verify checks the solution and returns a 5-minute HMAC token; status reports server health, solve statistics, and Lightning skip pricing. The agent computes a nonce where SHA-256(salt + nonce) has enough leading zero bits, then submits it to verify.
Stateless design: nothing persists between requests, tokens are validated via POST to /api/token/verify. Free tier requires only computation; L402 Lightning lets trusted clients skip PoW if they pay.
What it helps with
- embed proof-of-work verification into an agent's auth flow
- check a CAPTCHA solution and receive a signed token
- discover server status and Lightning skip price in satoshis
- provide free protection without managing API keys
Example prompts for the agent
- Request a fresh PoW challenge using the
challengetool - Verify the solution with
verifyand get a token back - Check server health and satoshi pricing with
status
How to install captcha-mcp
Platform CLI: remote server
claude mcp add --transport http captcha-mcp https://captcha-mcp--zekebuilds.run.toolsPlatform CLI: remote server
codex mcp add captcha-mcp --url https://captcha-mcp--zekebuilds.run.toolsConfig file
{
"mcpServers": {
"captcha-mcp": {
"url": "https://captcha-mcp--zekebuilds.run.tools"
}
}
}Config file
{
"servers": {
"captcha-mcp": {
"type": "http",
"url": "https://captcha-mcp--zekebuilds.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http captcha-mcp https://captcha-mcp--zekebuilds.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about captcha-mcp
How do I install captcha-mcp in Claude Code?
Run claude mcp add --transport http captcha-mcp https://captcha-mcp--zekebuilds.run.tools.
What does captcha-mcp do?
Provides tools to embed proof-of-work CAPTCHA into auth flows. Your agent requests a challenge, computes a solution, and submits it for verification; the server returns a signed token.
Do I need an API key to use the PoW path?
No — the PoW path is completely free and requires no keys. L402 Lightning is available for trusted clients who want to skip the PoW step.