Skip to main content

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)

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)

Source distribution for latam-data-mcp 0.6.1
File Size Uploaded
latam_data_mcp-0.6.1.tar.gz 33.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for latam-data-mcp 0.6.1
File Interpreter ABI Platform
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 log

Release 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

Release history Release notifications | RSS feed

This release

0.6.1 This release

2 release files

0.6.0

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.0

2 release files

0.2.1

2 release files

0.2.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page