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
| 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)
Metadata
Release files for latam-data-mcp 0.6.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| latam_data_mcp-0.6.1.tar.gz | 33.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| latam_data_mcp-0.6.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 60.9 kB
Release files / latam_data_mcp-0.6.1.tar.gz
| Download URL | latam_data_mcp-0.6.1.tar.gz |
|---|---|
| Size | 33.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0fd6696a2ae266dda6ed45e3a9247984529964253c93709b70e90c2fc59da8a1
|
|
BLAKE2b-256 checksum How to use checksums |
4ec5edc2dfe61ca0e31935ce7b4486f6af47f527251fb11538d0c6168223c73e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 14, 2026.
Transparency logRelease files / latam_data_mcp-0.6.1-py3-none-any.whl
| Download URL | latam_data_mcp-0.6.1-py3-none-any.whl |
|---|---|
| Size | 27.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7bdaaa920570a54523de1178dca66af11a345af88ab7c6d4adada137c88874ca
|
|
BLAKE2b-256 checksum How to use checksums |
1184a1a1ac1f21394c8ca7feb76f3aa26f1f70dd6a8c1ef59dec68e604366e12
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 14, 2026.
Transparency log