{
  "markdown": "# 🌮 MadTaco — MCP Server\n\n**npm:** [`@madtaco/mcp`](https://www.npmjs.com/package/@madtaco/mcp)\n\n[![smithery badge](https://smithery.ai/badge/madtaco/madtaco-mcp)](https://smithery.ai/servers/madtaco/madtaco-mcp)\n\nVerification and utility API for AI agents. Validate tax IDs, screen sanctions, verify companies, inspect domains — prepaid USD credits. Failed checks are never charged.\n\nThis package is a **stdio [MCP](https://modelcontextprotocol.io) server** that wraps the public MadTaco API at `https://api.madtaco.dev/v1`. Every response includes `credits_charged` (0 for free operations). Prefer remote HTTP instead? See [HTTP MCP](#remote-http) below.\n\n## Docs\n\n- [madtaco.dev](https://madtaco.dev) — product site\n- [Setup guide](https://madtaco.dev/mcp) — Cursor, Claude, Smithery\n- [API docs](https://madtaco.dev/docs) — OpenAPI reference\n- [Agent skill](https://madtaco.dev/skills/madtaco-api) — integration guide (MCP + REST)\n- [llms.txt](https://madtaco.dev/llms.txt) — full endpoint catalog\n- [pricing.json](https://madtaco.dev/pricing.json) — per-operation prices\n- [Health](https://api.madtaco.dev/v1/health) — API status\n- [Server card](https://api.madtaco.dev/.well-known/mcp/server-card.json) — tool metadata\n\n## Quick start (stdio)\n\n```bash\nnpx @madtaco/mcp\n```\n\n### Claude Desktop / Cursor\n\n**Claude Desktop config:** `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows).  \n**Cursor:** `.cursor/mcp.json` in your project or global MCP settings.\n\n```json\n{\n  \"mcpServers\": {\n    \"madtaco\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@madtaco/mcp\"],\n      \"env\": {\n        \"MADTACO_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n**Without an API key:** `validate_tax_id`, `validate_iban`, `lookup_instrument`, `validate_email` (syntax), `validate_phone` (format), `create_account`, `verify_account`.\n\n**With an API key (tier registered):** `get_usage`, `propose_check`.\n\n**Funded account required (tier 2):** paid screening/verification tools and `validate_email`/`validate_phone` full modes. Top up via `POST /v1/billing/checkout` or [madtaco.dev](https://madtaco.dev) billing.\n\n**Rate limits:** 50 req/day anonymous (per IP), 100 req/day registered (per API key), 500/day included once funded — see [llms.txt](https://madtaco.dev/llms.txt).\n\n### Try it\n\n> Validate the Chilean RUT `11.111.111-1` using MadTaco.\n\n> Check whether IBAN `DE89370400440532013000` is valid.\n\n> Look up ticker `CMG` on exchange `US`.\n\n## Remote HTTP\n\nStreamable HTTP MCP on the API subdomain — no npm install required:\n\n```json\n{\n  \"mcpServers\": {\n    \"madtaco\": {\n      \"url\": \"https://api.madtaco.dev/mcp\",\n      \"headers\": { \"X-Api-Key\": \"your_api_key_here\" }\n    }\n  }\n}\n```\n\nAuthenticate with `X-Api-Key` or `Authorization: Bearer`. Same 13 tools as this stdio package.\n\n## Environment\n\n| Variable | Required | Default |\n| --- | --- | --- |\n| `MADTACO_API_KEY` | For authenticated and paid tools | — |\n| `MADTACO_API_BASE` | No | `https://api.madtaco.dev/v1` |\n\nOverride for staging or local dev:\n\n```json\n\"env\": { \"MADTACO_API_BASE\": \"https://api.madtaco.dev/v1\" }\n```\n\n## Tools\n\nAll paths are relative to `MADTACO_API_BASE` (default `https://api.madtaco.dev/v1`).\n\n| Tool | API endpoint | Credits |\n| --- | --- | --- |\n| `validate_tax_id` | `POST /validate/tax-id` | 0 |\n| `validate_iban` | `POST /validate/iban` | 0 |\n| `lookup_instrument` | `POST /lookup/instrument` | 0 |\n| `validate_email` | `POST /validate/email` | 0 (syntax) / 0.005 (full, tier 2) |\n| `validate_phone` | `POST /validate/phone` | 0 (format) / 0.005 (full, tier 2) |\n| `screen_sanctions` | `POST /screen/sanctions` | 0.10 |\n| `verify_company` | `POST /verify/company` | 0.15 |\n| `inspect_domain` | `POST /inspect/domain` | 0.05 |\n| `screen` | `POST /screen` + optional `GET /screens/{id}?wait=60` | sum of completed checks |\n| `propose_check` | `POST /propose` | pledge hold only |\n| `create_account` | `POST /accounts` | 0 |\n| `verify_account` | `POST /accounts/verify` | 0 |\n| `get_usage` | `GET /usage` | 0 |\n\n## Not in MCP (REST only)\n\nCall these directly against the API — see [llms.txt](https://madtaco.dev/llms.txt):\n\n- `GET /data/cl/{indicator}` — Chilean indicators (UF, UTM, USD, EUR, IPC)\n- `GET /balance` — credit balance (`get_usage` includes balance)\n- `GET /evidence/{id}` — signed evidence URLs\n- `GET /health` — uptime check\n\n## Agent onboarding flow\n\n1. `create_account` with an email → `account_id` + `pending_verification`\n2. Human or agent reads the 6-digit code from email\n3. `verify_account` → `api_key` (tier `registered`)\n4. Fund the account via [madtaco.dev](https://madtaco.dev) billing or `POST /v1/billing/checkout`\n5. Set `MADTACO_API_KEY` and run paid checks\n\nCredentials never transit through MCP responses for human dashboard access — use `POST /v1/accounts/invite-human` when needed.\n\n## Development\n\nStdio transport only — this server calls the public HTTP API; no database or secrets beyond an optional API key.\n\n```bash\ngit clone https://github.com/madtaco-dev/mcp.git\ncd mcp\nnpm install\nnpm test\nnpm run build\nMADTACO_API_KEY=... npm run dev\n```\n\nNew tools ship as minor npm releases as the API grows. See [llms.txt](https://madtaco.dev/llms.txt) for the current tool list.\n\n## License\n\nMIT © 🌮 MadTaco · Built for agents, literally.\n",
  "bytes": 5340,
  "sha": "99232ab470dd7b57bc7d2c324b34d6c587c6520b584e39e42751677462ddda90",
  "repo_slug": "madtaco-dev/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_dev_madtaco_mcp_28dfca5c/readme"
}