MadTaco — Claude Code MCP server: checks and setup
MadTaco lets an agent query an API for tax ID, company, sanctions, and domain checks. Paid checks need a funded account.
claude mcp add --env MADTACO_API_BASE=<MADTACO_API_BASE> --env MADTACO_API_KEY=<MADTACO_API_KEY> --transport stdio madtaco -- npx -y @madtaco/mcpWhat MadTaco does
This stdio MCP server sends requests to the public MadTaco API. Its 13 tools cover tax IDs, IBANs, email and phone checks, instrument lookups, company verification, domain inspection, and sanctions screening. Agents can also create accounts and read usage data.
Some checks work without an API key. Authenticated and paid tools need MADTACO_API_KEY; paid screening and full email or phone checks also require a funded tier 2 account. Failed checks are not charged. Anonymous access is limited to 50 requests per day per IP.
Claude Code runs the server with npx over stdio, while the server calls MadTaco’s HTTP API. A funded account is required for paid checks, so those tools cannot complete their work on an unfunded account.
What it helps with
- validate a tax ID or IBAN
- screen a company against the API
- inspect a domain
- check a name against sanctions lists
- review account credit usage
Example prompts for the agent
- Check whether this IBAN is valid.
- Screen this company using its registration details.
- Inspect this domain and return the screening result.
How to install MadTaco
Platform CLI
claude mcp add --env MADTACO_API_BASE=<MADTACO_API_BASE> --env MADTACO_API_KEY=<MADTACO_API_KEY> --transport stdio madtaco -- npx -y @madtaco/mcpReplace <…> with your own values
Platform CLI
codex mcp add madtaco --env MADTACO_API_BASE=<MADTACO_API_BASE> --env MADTACO_API_KEY=<MADTACO_API_KEY> -- npx -y @madtaco/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"madtaco": {
"command": "npx",
"args": [
"-y",
"@madtaco/mcp"
],
"env": {
"MADTACO_API_BASE": "<MADTACO_API_BASE>",
"MADTACO_API_KEY": "<MADTACO_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"madtaco": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@madtaco/mcp"
],
"env": {
"MADTACO_API_BASE": "<MADTACO_API_BASE>",
"MADTACO_API_KEY": "<MADTACO_API_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e MADTACO_API_BASE=<MADTACO_API_BASE> -e MADTACO_API_KEY=<MADTACO_API_KEY> madtaco npx -y @madtaco/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about MadTaco
How do I install MadTaco in Claude Code?
Run claude mcp add mcp -e MADTACO_API_KEY=<MADTACO_API_KEY> -- npx -y @madtaco/mcp. Paid tools require an API key and a funded account.
What does MadTaco do?
It connects an agent to verification APIs for tax IDs, IBANs, companies, domains, and sanctions screening.
Can I use MadTaco without an API key?
Some checks work without one. Authenticated and paid tools need MADTACO_API_KEY; paid screening also needs a funded tier 2 account.
