{"_id":"@captcha-la/mcp","name":"@captcha-la/mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@captcha-la/mcp","version":"1.0.0","description":"Model Context Protocol server for CaptchaLa — search the docs and validate/issue tokens from Claude Desktop, Cursor, and other MCP clients.","type":"module","bin":{"captchala-mcp":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"keywords":["captchala","captcha","mcp","model-context-protocol","claude","cursor"],"license":"MIT","homepage":"https://captcha.la","repository":{"type":"git","url":"git+https://github.com/Captcha-La/captchala-mcp.git"},"engines":{"node":">=18"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","zod":"^3.23.0"},"devDependencies":{"typescript":"^5.5.0","@types/node":"^20.0.0"},"_id":"@captcha-la/mcp@1.0.0","gitHead":"6630976950637e4efc7e66b66e687883adc3786a","bugs":{"url":"https://github.com/Captcha-La/captchala-mcp/issues"},"_nodeVersion":"22.17.1","_npmVersion":"10.9.2","dist":{"integrity":"sha512-4yB61OHM0nEmnA7g7NZSckVNBKyGvA/Xu3BzgwNYBKmKgTMv8WxiCKy7F2Myy0RcAhn4f9G8/w+NGq7z+4zKrQ==","shasum":"8027f9e7f5551999faa71516c71e88c388949278","tarball":"https://registry.npmjs.org/@captcha-la/mcp/-/mcp-1.0.0.tgz","fileCount":4,"unpackedSize":9839,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC62OBcveui8GniwmmyQCfq9lzuKC2pPt8k4sbJUJbO6gIhAL8U18ciHLlyJ0z2KnNI0s68GCXCsn7Pemhpc4hCEI+F"}]},"_npmUser":{"name":"captcha_la","email":"support@captcha.la"},"directories":{},"maintainers":[{"name":"captcha_la","email":"support@captcha.la"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_1.0.0_1782042216863_0.5404658724001046"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-21T11:43:36.716Z","1.0.0":"2026-06-21T11:43:36.988Z","modified":"2026-06-21T11:43:37.195Z"},"maintainers":[{"name":"captcha_la","email":"support@captcha.la"}],"description":"Model Context Protocol server for CaptchaLa — search the docs and validate/issue tokens from Claude Desktop, Cursor, and other MCP clients.","homepage":"https://captcha.la","keywords":["captchala","captcha","mcp","model-context-protocol","claude","cursor"],"repository":{"type":"git","url":"git+https://github.com/Captcha-La/captchala-mcp.git"},"bugs":{"url":"https://github.com/Captcha-La/captchala-mcp/issues"},"license":"MIT","readme":"# @captcha-la/mcp\n\nA [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for [CaptchaLa](https://captcha.la). It lets MCP clients such as **Claude Desktop**, **Cursor**, and others search the CaptchaLa documentation and validate or issue CaptchaLa tokens directly from your assistant.\n\nThe server speaks MCP over **stdio** transport.\n\n## Tools\n\n| Tool | Description | Credentials |\n| --- | --- | --- |\n| `search_captchala_docs` | Search the CaptchaLa docs and return the most relevant sections for a query. | Not required |\n| `get_captchala_doc` | Fetch a specific documentation page by path (e.g. `getting-started`). | Not required |\n| `validate_captcha_token` | Validate a pass token against the CaptchaLa API. | App Key + Secret |\n| `issue_server_token` | Issue a server-side challenge token for an action. | App Key + Secret |\n\nThe documentation tools work without any credentials. The `validate_captcha_token` and `issue_server_token` tools require a CaptchaLa **App Key** and **App Secret**, supplied either per call (as tool arguments) or via the `CAPTCHALA_APP_KEY` and `CAPTCHALA_APP_SECRET` environment variables.\n\n## Install\n\nInstall globally:\n\n```bash\nnpm install -g @captcha-la/mcp\n```\n\nOr run on demand with `npx`:\n\n```bash\nnpx @captcha-la/mcp\n```\n\n## Claude Desktop configuration\n\nAdd the server to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"captchala\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@captcha-la/mcp\"],\n      \"env\": {\n        \"CAPTCHALA_APP_KEY\": \"your-app-key\",\n        \"CAPTCHALA_APP_SECRET\": \"your-app-secret\"\n      }\n    }\n  }\n}\n```\n\nIf you only need the documentation tools, you can omit the `env` block.\n\n## Cursor\n\nCursor supports MCP servers as well. Add the same `command`/`args`/`env` entry under Cursor's MCP settings (Settings → MCP → Add server). The stdio transport is used automatically.\n\n## Example prompts\n\n- \"Search the CaptchaLa docs for how server-side validation works.\"\n- \"Fetch the CaptchaLa getting-started doc.\"\n- \"Validate this CaptchaLa pass token: `<token>` for client IP 1.2.3.4.\"\n- \"Issue a CaptchaLa server token for the `login` action.\"\n\n## Environment variables\n\n| Variable | Purpose |\n| --- | --- |\n| `CAPTCHALA_APP_KEY` | Your CaptchaLa App Key (sent as `X-App-Key`). |\n| `CAPTCHALA_APP_SECRET` | Your CaptchaLa App Secret (sent as `X-App-Secret`). |\n\n## License\n\nMIT © CaptchaLa &lt;supply@captcha.la&gt;\n","readmeFilename":"README.md","_rev":"1-a2ccd3962f09299d6d746ec4e60918fd"}