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

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)

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

latam_data_mcp-0.6.1.tar.gz (33.3 kB view details)

Uploaded Jul 14, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

latam_data_mcp-0.6.1-py3-none-any.whl (27.6 kB view details)

Uploaded Jul 14, 2026 Python 3

File details

Details for the file latam_data_mcp-0.6.1.tar.gz.

File metadata

Download URL: latam_data_mcp-0.6.1.tar.gz
Upload date: Jul 14, 2026
Size: 33.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for latam_data_mcp-0.6.1.tar.gz
Algorithm	Hash digest
SHA256	`0fd6696a2ae266dda6ed45e3a9247984529964253c93709b70e90c2fc59da8a1`
MD5	`96dbc906ff25274df7f3d04b0c1da42f`
BLAKE2b-256	`4ec5edc2dfe61ca0e31935ce7b4486f6af47f527251fb11538d0c6168223c73e`

See more details on using hashes here.

Provenance

The following attestation bundles were made for latam_data_mcp-0.6.1.tar.gz:

Publisher: publish.yml on svkbogislav/latam-data-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: latam_data_mcp-0.6.1.tar.gz
- Subject digest: 0fd6696a2ae266dda6ed45e3a9247984529964253c93709b70e90c2fc59da8a1
- Sigstore transparency entry: 2168119516
- Sigstore integration time: Jul 14, 2026
Source repository:
- Permalink: svkbogislav/latam-data-mcp@7e937c7aee8058652f2eca12502f4815d93f3649
- Branch / Tag: refs/heads/main
- Owner: https://github.com/svkbogislav
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@7e937c7aee8058652f2eca12502f4815d93f3649
- Trigger Event: workflow_dispatch