LatAm Data MCP

July 14, 2026 Β· View on GitHub

LatAm Data MCP β€” the Latin American data layer your AI agent is missing

LatAm Data MCP

An MCP server that gives agents reliable access to LatAm data that is otherwise scattered, undocumented, or Spanish-only: tax-ID validation for 12 countries, live economic indicators, exchange rates (including Argentina's blue rate and Colombia's legally binding TRM), Brazilian company lookups, holidays, and business-day math.

Tools (20)

Identity, banking & companies

ToolWhat it does
validate_tax_idValidates national tax IDs with real check-digit math for 15 countries: πŸ‡¨πŸ‡± RUT, πŸ‡¦πŸ‡· CUIT/CUIL, πŸ‡²πŸ‡½ RFC, πŸ‡§πŸ‡· CPF/CNPJ (incl. 2026 alphanumeric CNPJs), πŸ‡¨πŸ‡΄ NIT, πŸ‡΅πŸ‡ͺ RUC, πŸ‡ΊπŸ‡Ύ RUT, πŸ‡ͺπŸ‡¨ cΓ©dula/RUC, πŸ‡΅πŸ‡Ύ RUC, πŸ‡»πŸ‡ͺ RIF, πŸ‡¬πŸ‡Ή NIT, πŸ‡©πŸ‡΄ RNC, πŸ‡΅πŸ‡¦ RUC+DV, πŸ‡¨πŸ‡· cΓ©dula, πŸ‡§πŸ‡΄ NIT. Returns canonical formatting and person/company/public-entity detection.
validate_bank_accountValidates interbank account codes with check-digit math: πŸ‡²πŸ‡½ CLABE (18-digit), πŸ‡¦πŸ‡· CBU/CVU (22-digit, incl. Mercado Pago virtual accounts). Decodes bank, branch and account β€” verify a payout destination before sending money.
validate_pix_keyValidates a πŸ‡§πŸ‡· PIX key (CPF, CNPJ, e-mail, +55 phone, or random UUID) and detects its type β€” CPF/CNPJ with full check-digit math.
validate_phone_numberValidates & normalizes phone numbers for 15 countries β†’ E.164, national format, mobile/landline detection. Handles Brazil's 9th digit, Mexico's 10-digit, Argentina's 9/15, Chile's 9-prefix.
brazil_bank_lookupResolves a πŸ‡§πŸ‡· bank by COMPE code (name, ISPB).
brazil_company_lookupFull federal-registry data for any Brazilian company by CNPJ: legal name, status, size, main activity, capital, address, partners.
costa_rica_company_lookupπŸ‡¨πŸ‡· taxpayer by cΓ©dula: name, regime, activities, and compliance status (moroso/omiso) from Hacienda β€” for KYC/AML.

Money & markets

ToolWhat it does
chile_indicatorsUF, UTM, USD, EUR and more, in CLP.
argentina_exchange_ratesOfficial vs blue rate for USD/EUR.
brazil_market_ratesSELIC, CDI, IPCA.
colombia_official_trmThe legally binding USD/COP rate with validity dates.
brazil_historical_seriesHistorical SELIC/CDI/IPCA/USD over a date range, with min/max/avg/change β€” for trend analysis and backtesting.
colombia_trm_historyHistorical USD/COP (TRM) over a date range.
costa_rica_exchange_rateπŸ‡¨πŸ‡· official USD/EUR colΓ³n rate.
currency_convertConvert any amount between two currencies at the live rate.
latam_exchange_ratesAll 18 LatAm currencies vs USD in one call.

Time & calendars

ToolWhat it does
public_holidaysOfficial holidays for 20 LatAm countries, any year.
next_holidaysUpcoming holidays from today.
long_weekendsLong weekends with bridge-day analysis.
business_daysWorking-day count between dates, holiday-aware β€” for SLA, payroll, logistics, settlement math.

Install (free β€” runs on your machine)

No signup, no API keys. Two steps:

1. Install uv (the runner) if you don't already have it:

brew install uv                              # macOS
# or, any platform:
curl -LsSf https://astral.sh/uv/install.sh | sh

2. Add the server to your MCP client config (mcpServers block):

{
  "mcpServers": {
    "latam-data": {
      "command": "uvx",
      "args": ["latam-data-mcp"]
    }
  }
}
  • Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) β€” then quit and reopen the app.
  • Cursor / Claude Code / other clients: same mcpServers block, in their config.

Then just ask your agent "Is Chilean RUT 60.910.000-1 valid?" β€” done. Requires Python 3.10+ (uv handles it).

macOS gotcha: if the server doesn't show up, use the full path to uvx as the command (run which uvx β†’ e.g. /opt/homebrew/bin/uvx). GUI apps don't always inherit your shell's PATH. First launch takes a few seconds while uv fetches the package; instant after that.

See it work

Once connected, just ask your agent in plain language:

"Is the Mexican CLABE 646180110400000007 valid, and which bank is it?" β†’ βœ… valid Β· Banco STP Β· branch 180 Β· account …

"Validate Brazilian CNPJ 00.000.000/0001-91 and tell me who it is." β†’ βœ… Banco do Brasil S.A. Β· active Β· BrasΓ­lia-DF

"What's the UF and the dollar today in Chile? And convert 2,500,000 CLP to BRL."

"How many business days between 2026-09-01 and 2026-09-30 in Chile?" β†’ holiday-aware working-day count (skips Fiestas Patrias)

No glue code β€” the agent picks the right tool and calls it.

Pro β€” the compliance & data tier

The tools above are free forever. Pro adds the compliance and data features teams actually pay for β€” the stuff you can't get from a free public API:

  • πŸ›‘οΈ OFAC sanctions / watchlist screening β€” fuzzy name matching (catches aliases, reordered names, accents) for KYC/AML onboarding
  • 🏒 Company lookup by tax ID β€” πŸ‡¨πŸ‡± Chile today; πŸ‡¦πŸ‡· Argentina, πŸ‡΅πŸ‡ͺ Peru, πŸ‡²πŸ‡½ Mexico coming β€” name, status, activities, compliance flags
  • πŸ“‹ Bulk validation β€” validate up to 10,000 IDs in one call, for onboarding pipelines and CRM cleanups
  • coming: PEP screening, change-monitoring webhooks, extended historical data

Delivered as a managed, always-on hosted endpoint (no self-hosting), with higher rate limits and priority support.

πŸ’³ $19.99/mo β€” β†’ Subscribe to Pro

Building for a team, or need a specific country/data source first? Open an issue β€” tell me your use case and I'll get you early access.

Develop

python3.11 -m venv .venv
.venv/bin/pip install -e ".[dev]"
.venv/bin/python server.py     # stdio; set PORT=8000 for Streamable HTTP

Tests

.venv/bin/pytest              # offline suite: validators + MCP protocol layer
.venv/bin/pytest -m live      # integration tests against the real upstream APIs

Validators are verified against python-stdnum's reference algorithms and real IDs of public institutions (Banco do Brasil, SUNAT, DIAN, UTE, U. de Chile).

Data sources

All free public APIs, no keys: gael.cloud (Chile), Bluelytics (Argentina), BrasilAPI (Brazil), datos.gov.co (Colombia), open.er-api.com (regional FX), Nager.Date (holidays). Tax-ID validation is pure local math β€” zero dependencies, zero latency, nothing to break.

Roadmap

  • Historical series (UF, USD, TRM)
  • Deploy free tier + directory listings (Smithery, PulseMCP, mcp.so)
  • Monetization via MCPize (85% rev share) once free tier has weekly active users
  • Electronic invoicing requirements per country (static knowledge tool)