pypi latam-data-mcpstdioMITupdated 1mo ago
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.
O que dá para fazer com LatAm Data?
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 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
mcpServersblock, 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(runwhich 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
646180110400000007valid, and which bank is it?" → ✅ valid · Banco STP · branch 180 · account …
"Validate Brazilian CNPJ
00.000.000/0001-91and 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)
Instalação
Adicione LatAm Data ao seu cliente. Escolha o que você usa.
claude mcp add latam-data-mcp -- uvx latam-data-mcpcodex mcp add latam-data-mcp -- uvx latam-data-mcpamp mcp add latam-data-mcp -- uvx latam-data-mcp{
"mcpServers": {
"latam-data-mcp": {
"command": "uvx",
"args": [
"latam-data-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"latam-data-mcp": {
"command": "uvx",
"args": [
"latam-data-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"latam-data-mcp","command":"uvx","args":["latam-data-mcp"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"latam-data-mcp": {
"command": "uvx",
"args": [
"latam-data-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"latam-data-mcp": {
"command": "uvx",
"args": [
"latam-data-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"latam-data-mcp": {
"command": "uvx",
"args": [
"latam-data-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"latam-data-mcp": {
"type": "local",
"command": "uvx",
"args": [
"latam-data-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"latam-data-mcp": {
"command": {
"path": "uvx",
"args": [
"latam-data-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
uvx latam-data-mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
Pontuação
39 / 100
Incompleta
- Documentação25/25
- Manutenção22/25
- Confiança13/20
- Capacidade0/15
- Instalação12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 48 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Histórico de versões
| Versões | Publicada |
|---|---|
| 0.6.1Mais recente | 14 de jul. de 2026 |
| 0.6.0 | 13 de jul. de 2026 |
| 0.5.0 | 13 de jul. de 2026 |
| 0.4.0 | 13 de jul. de 2026 |
| 0.3.0 | 13 de jul. de 2026 |
| 0.2.1 | 13 de jul. de 2026 |