MadTaco

dev.madtacoPublished by madtaco.devv1.1.0Updated Oct 24, 2026

Verification and trust checks for AI agents: validate, screen, propose, accounts, usage.

Overview

AI-generated overview

MadTaco is a local stdio MCP server that lets an assistant validate tax IDs, IBANs, emails and phones, screen sanctions, verify companies and inspect domains.

What you can do
Validate identifiers: tax IDs, IBANs, email addresses and phone numbers, plus look up financial instruments by ticker and exchange (free tools). Run paid trust checks: sanctions screening, company verification, domain inspection, and a combined screen that polls for results. Manage an account: create and verify an account, check usage and credit balance, and propose new checks. Every response reports credits charged, and failed checks are not billed.
When to use it
Use it when an assistant needs to check business or financial identifiers, screen a party against sanctions, verify a company or inspect a domain, and you are willing to pay per check from prepaid credits. Free validation tools work without an account.
Requirements
Runs locally via npx with Node.js; desktop only. Optional MADTACO_API_KEY for authenticated and paid tools; MADTACO_API_BASE overrides the API base URL. Paid screening and full email/phone modes need a funded account topped up through billing. Network access to the MadTaco API. Rate limits apply per IP or key.
Before you install
Paid checks draw down prepaid USD credits (for example sanctions screening, company verification, domain inspection); propose_check places a pledge hold. The API key is a secret sent as X-Api-Key and should be kept out of shared configs. Account creation requires an email and a verification code. Requests and the data being checked are sent to the third-party MadTaco API.

Installation

In SourceWeft

  1. Open MadTaco in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

🌮 MadTaco — MCP Server

npm: @madtaco/mcp

[smithery badge]

Verification and utility API for AI agents. Validate tax IDs, screen sanctions, verify companies, inspect domains — prepaid USD credits. Failed checks are never charged.

This package is a stdio MCP 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 below.

Docs

Quick start (stdio)

bash
npx @madtaco/mcp

Claude Desktop / Cursor

Claude Desktop config: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows).
Cursor: .cursor/mcp.json in your project or global MCP settings.

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

Without an API key: validate_tax_id, validate_iban, lookup_instrument, validate_email (syntax), validate_phone (format), create_account, verify_account.

With an API key (tier registered): get_usage, propose_check.

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 billing.

Rate limits: 50 req/day anonymous (per IP), 100 req/day registered (per API key), 500/day included once funded — see llms.txt.

Try it

Validate the Chilean RUT 11.111.111-1 using MadTaco.

Check whether IBAN DE89370400440532013000 is valid.

Look up ticker CMG on exchange US.

Remote HTTP

Streamable HTTP MCP on the API subdomain — no npm install required:

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

Authenticate with X-Api-Key or Authorization: Bearer. Same 13 tools as this stdio package.

Environment

VariableRequiredDefault
MADTACO_API_KEYFor authenticated and paid tools—
MADTACO_API_BASENohttps://api.madtaco.dev/v1

Override for staging or local dev:

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

Tools

All paths are relative to MADTACO_API_BASE (default https://api.madtaco.dev/v1).

ToolAPI endpointCredits
validate_tax_idPOST /validate/tax-id0
validate_ibanPOST /validate/iban0
lookup_instrumentPOST /lookup/instrument0
validate_emailPOST /validate/email0 (syntax) / 0.005 (full, tier 2)
validate_phonePOST /validate/phone0 (format) / 0.005 (full, tier 2)
screen_sanctionsPOST /screen/sanctions0.10
verify_companyPOST /verify/company0.15
inspect_domainPOST /inspect/domain0.05
screenPOST /screen + optional GET /screens/{id}?wait=60sum of completed checks
propose_checkPOST /proposepledge hold only
create_accountPOST /accounts0
verify_accountPOST /accounts/verify0
get_usageGET /usage0

Not in MCP (REST only)

Call these directly against the API — see llms.txt:

  • GET /data/cl/{indicator} — Chilean indicators (UF, UTM, USD, EUR, IPC)
  • GET /balance — credit balance (get_usage includes balance)
  • GET /evidence/{id} — signed evidence URLs
  • GET /health — uptime check

Agent onboarding flow

  1. create_account with an email → account_id + pending_verification
  2. Human or agent reads the 6-digit code from email
  3. verify_account → api_key (tier registered)
  4. Fund the account via madtaco.dev billing or POST /v1/billing/checkout
  5. Set MADTACO_API_KEY and run paid checks

Credentials never transit through MCP responses for human dashboard access — use POST /v1/accounts/invite-human when needed.

Development

Stdio transport only — this server calls the public HTTP API; no database or secrets beyond an optional API key.

bash
git clone https://github.com/madtaco-dev/mcp.gitcd mcpnpm installnpm testnpm run buildMADTACO_API_KEY=... npm run dev

New tools ship as minor npm releases as the API grows. See llms.txt for the current tool list.

License

MIT © 🌮 MadTaco · Built for agents, literally.

Source: README.md at commit cb3c202

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts