madtaco

🌮 MadTaco — MCP サーバー

npm: @madtaco/mcp

AI エージェント向けの検証・ユーティリティ API です。税務 ID の検証、制裁対象者のスクリーニング、企業の検証、ドメインの調査を、USD のプリペイドクレジットで利用できます。チェックに失敗した場合、料金は一切発生しません。

このパッケージは、公開 MadTaco API https://api.madtaco.dev/v1 をラップするstdio MCP サーバーです。すべてのレスポンスに credits_charged が含まれます（無料の操作では 0）。リモート HTTP をお求めですか？以下のHTTP MCPをご覧ください。

ドキュメント

• madtaco.dev — 製品サイト
• セットアップガイド — Cursor、Claude、Smithery
• API ドキュメント — OpenAPI リファレンス
• エージェントスキル — 統合ガイド（MCP + REST）
• llms.txt — 全エンドポイント一覧
• pricing.json — 操作ごとの料金
• ヘルス — API ステータス
• サーバーカード — ツールのメタデータ

クイックスタート（stdio）

npx @madtaco/mcp

Claude Desktop / Cursor

Claude Desktop の設定： ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）。
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 の請求ページから入金してください。

レート制限： 匿名ユーザーは 1 日あたり 50 リクエスト（IP ごと）、登録ユーザーは 1 日あたり 100 リクエスト（API キーごと）、入金後は 1 日あたり 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 — 稼働状況の確認

エージェントのオンボーディングフロー

1. メールアドレスを使って create_account を実行 → account_id + pending_verification
2. 人間またはエージェントがメールから6桁のコードを読み取ります
3. verify_account を実行 → api_key（tier 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 · 文字どおり、エージェントのために構築。