# MadTaco

> Verification and utility API for AI agents. Validate tax IDs, IBANs, emails and phones; screen entities against sanctions lists; verify companies; inspect domains; read Chilean economic indicators. Credits are USD-denominated. Failed or inconclusive checks are never charged. The full lifecycle — signup, verification, payment, usage — is machine-completable.

Auth: `X-Api-Key` header (free operations work unauthenticated). Every response includes `credits_charged` (0 for free operations); authenticated calls also include `balance_remaining`. Rate limits: 50 req/day anonymous (per IP), 100 req/day with a free account (per API key), 500/day included once funded — then automatic overage at $0.20 per 1,000 requests against your balance (`X-RateLimit-Limit` / `-Remaining` / `-Reset`). Credits last 12 months — any top-up renews your full balance.

## Docs

- [API documentation](https://madtaco.dev/docs): OpenAPI reference (Scalar embed of openapi.yaml)
- [Pricing](https://madtaco.dev/pricing.json): Machine-readable per-operation prices in USD
- [Health check](https://api.madtaco.dev/v1/health): Overall status plus database and cache connectivity (unauthenticated, un-rate-limited)

## Live endpoints

- [Validate tax ID](https://api.madtaco.dev/v1/validate/tax-id): POST — format/checksum validation (CL RUT, MX RFC); body `{"id","country"}`
- [Validate IBAN](https://api.madtaco.dev/v1/validate/iban): POST — checksum validation and parsing; body `{"iban"}`
- [Chilean indicators](https://api.madtaco.dev/v1/data/cl/{indicator}): GET — uf, utm, usd, eur, ipc; daily values with `as_of` (CMF source)
- [Chilean indicators (historical)](https://api.madtaco.dev/v1/data/cl/{indicator}/{date}): GET — historical value for YYYY-MM-DD

## Platform

- [Create account](https://api.madtaco.dev/v1/accounts): POST — agent-native signup; body `{"email","name?"}` → verification code by email
- [Verify account](https://api.madtaco.dev/v1/accounts/verify): POST — body `{"account_id","code"}` → API key (tier registered)
- [Balance](https://api.madtaco.dev/v1/balance): GET — current credit balance (authenticated)
- [Usage](https://api.madtaco.dev/v1/usage): GET — today's free-ops used/included/overage, credits spent, requests by operation; `?period=7d|30d` for daily breakdown (authenticated)

## MCP

- [MCP server](https://github.com/madtaco-dev/mcp): `npx @madtaco/mcp` — screen, validate, propose, create_account, verify_account, get_usage, and more for Claude or any MCP-compatible agent

## Optional

- [Propose a check](https://api.madtaco.dev/v1/propose): POST — request a capability MadTaco does not offer yet; optional credit pledge (authenticated)
- Sanctions screening (OFAC SDN, EU, UK, UN), company verification, domain intelligence, composite trust screen — coming soon
- Email/phone deep validation, FX rates, public holidays, business-day checks — coming soon