latam-data-mcp 0.6.0

MCP server giving AI agents reliable access to Latin American data: tax-ID validation, indicators, FX, company lookups, holidays

LatAm Data MCP

The Latin American data layer your AI agent is missing.

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

Tool	What it does
validate_tax_id	Validates 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_account	Validates 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_key	Validates 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_number	Validates & 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_lookup	Resolves a 🇧🇷 bank by COMPE code (name, ISPB).
brazil_company_lookup	Full 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

Tool	What it does
chile_indicators	UF, UTM, USD, EUR and more, in CLP.
argentina_exchange_rates	Official vs blue rate for USD/EUR.
brazil_market_rates	SELIC, CDI, IPCA.
colombia_official_trm	The legally binding USD/COP rate with validity dates.
brazil_historical_series	Historical SELIC/CDI/IPCA/USD over a date range, with min/max/avg/change — for trend analysis and backtesting.
colombia_trm_history	Historical USD/COP (TRM) over a date range.
costa_rica_exchange_rate	🇨🇷 official USD/EUR colón rate.
currency_convert	Convert any amount between two currencies at the live rate.
latam_exchange_rates	All 18 LatAm currencies vs USD in one call.

Time & calendars

Tool	What it does
public_holidays	Official holidays for 20 LatAm countries, any year.
next_holidays	Upcoming holidays from today.
long_weekends	Long weekends with bridge-day analysis.
business_days	Working-day count between dates, holiday-aware — for SLA, payroll, logistics, settlement math.

Install (free — runs on your machine)

No download or clone needed. Add this to your MCP client config — uvx fetches and runs the server straight from this repo:

Claude Desktop / Cursor / Claude Code (mcpServers block):

{
  "mcpServers": {
    "latam-data": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/svkbogislav/latam-data-mcp", "latam-data-mcp"]
    }
  }
}

Or install it as a command:

uvx --from git+https://github.com/svkbogislav/latam-data-mcp latam-data-mcp
# or:  pipx install git+https://github.com/svkbogislav/latam-data-mcp

Requires Python 3.10+. No API keys — every data source is free and public.

Hosted (managed) endpoint

A always-on hosted instance is available at https://latam-data.fastmcp.app/mcp (Streamable HTTP, authenticated). Use this if you'd rather not run anything locally.

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)