madtaco

🌮 MadTaco — MCP 服务

npm： @madtaco/mcp

为 AI Agent 提供验证和实用 API。验证税号、筛查制裁名单、核验公司、检查域名 — 使用预付 USD 额度。检查失败不收费。

此软件包是一个 stdio MCP 服务，封装了 MadTaco 公共 API：https://api.madtaco.dev/v1。每个响应都包含 credits_charged（免费操作为 0）。想改用远程 HTTP？请参阅下方的 HTTP MCP。

文档

• madtaco.dev — 产品网站
• Setup guide — Cursor、Claude、Smithery 配置指南
• API docs — OpenAPI 参考文档
• Agent skill — 集成指南（MCP + REST）
• llms.txt — 完整端点目录
• pricing.json — 各操作价格
• Health — API 状态
• Server card — 工具元数据

快速开始（stdio）

npx @madtaco/mcp

Claude Desktop / Cursor

Claude Desktop 配置： macOS 为 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 为 %APPDATA%\Claude\claude_desktop_config.json。
Cursor： 在项目中的 .cursor/mcp.json 或全局 MCP 设置中配置。

{
  "mcpServers": {
    "madtaco": {
      "command": "npx",
      "args": ["-y", "@madtaco/mcp"],
      "env": {
        "MADTACO_API_KEY": "your_api_key_here"
      }
    }
  }
}

无需 API 密钥： validate_tax_id、validate_iban、lookup_instrument、validate_email（语法）、validate_phone（格式）、create_account、verify_account。

需要 API 密钥（已注册层级）： get_usage、propose_check。

需要已充值的账户（层级 2）： 付费筛查／验证工具，以及完整模式下的 validate_email／validate_phone。通过 POST /v1/billing/checkout 或 madtaco.dev 账单页面充值。

速率限制： 匿名用户每天 50 个请求（按 IP 计算），已注册用户每天 100 个请求（按 API 密钥计算），充值后每天包含 500 个请求 — 详见 llms.txt。

试试看

使用 MadTaco 验证智利 RUT 11.111.111-1。

检查 IBAN DE89370400440532013000 是否有效。

查询交易所 US 上的股票代码 CMG。

远程 HTTP

API 子域名上的 Streamable HTTP MCP — 无需安装 npm：

{
  "mcpServers": {
    "madtaco": {
      "url": "https://api.madtaco.dev/mcp",
      "headers": { "X-Api-Key": "your_api_key_here" }
    }
  }
}

使用 X-Api-Key 或 Authorization: Bearer 进行身份验证。与此 stdio 软件包提供相同的 13 个工具。

环境

变量	必填	默认值
MADTACO_API_KEY	用于需要身份验证和付费的工具	—
MADTACO_API_BASE	否	https://api.madtaco.dev/v1

可设置不同值以用于预发布或本地开发：

"env": { "MADTACO_API_BASE": "https://api.madtaco.dev/v1" }

工具

所有路径均相对于 MADTACO_API_BASE（默认值为 https://api.madtaco.dev/v1）。

工具	API 端点	额度
validate_tax_id	POST /validate/tax-id	0
validate_iban	POST /validate/iban	0
lookup_instrument	POST /lookup/instrument	0
validate_email	POST /validate/email	0（语法）/ 0.005（完整，层级 2）
validate_phone	POST /validate/phone	0（格式）/ 0.005（完整，层级 2）
screen_sanctions	POST /screen/sanctions	0.10
verify_company	POST /verify/company	0.15
inspect_domain	POST /inspect/domain	0.05
screen	POST /screen + 可选的 GET /screens/{id}?wait=60	已完成检查的额度总和
propose_check	POST /propose	仅冻结承诺额度
create_account	POST /accounts	0
verify_account	POST /accounts/verify	0
get_usage	GET /usage	0

MCP 中未提供（仅限 REST）

直接向 API 发起调用 — 详见 llms.txt：

• GET /data/cl/{indicator} — 智利指标（UF、UTM、USD、EUR、IPC）
• GET /balance — 额度余额（get_usage 已包含余额）
• GET /evidence/{id} — 签名证据 URL
• GET /health — 正常运行时间检查

Agent 入驻流程

1. 使用邮箱调用 create_account → account_id + pending_verification
2. 由人工或 Agent 从邮件中读取 6 位验证码
3. 调用 verify_account → api_key（层级为 registered）
4. 通过 madtaco.dev 账单页面或 POST /v1/billing/checkout 为账户充值
5. 设置 MADTACO_API_KEY 并运行付费检查

用于人工访问控制面板的凭据绝不会通过 MCP 响应传递；如有需要，请使用 POST /v1/accounts/invite-human。

开发

仅支持 Stdio 传输 — 此服务调用公共 HTTP API；除可选的 API 密钥外，不使用数据库或其他机密信息。

git clone https://github.com/madtaco-dev/mcp.git
cd mcp
npm install
npm test
npm run build
MADTACO_API_KEY=... npm run dev

随着 API 扩展，新工具将通过 npm 次要版本发布。当前工具列表请参阅 llms.txt。

许可证

MIT © 🌮 MadTaco · 专为 Agent 打造，名副其实。