LatAm Data

io.github.svkbogislavPublished by GitHub account svkbogislavv0.6.1Updated Oct 24, 2026

Latin American data for AI agents: tax-ID validation, indicators, FX, company lookups, holidays

VerifiedSTDIODesktop onlyFinanceData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Local MCP server giving assistants Latin American tax-ID, bank-account and phone validation, FX and economic indicators, company lookups, and…

What you can do
  • Validate and normalize tax IDs, bank accounts, PIX keys and phone numbers for Latin American countries, with check-digit math and entity-type detection
  • Look up Brazilian companies by CNPJ, Brazilian banks by COMPE code, and Costa Rican taxpayers by cédula
  • Retrieve economic indicators and exchange rates for Chile, Argentina, Brazil, Colombia and Costa Rica, plus all LatAm currencies against USD
  • Convert amounts between currencies and pull historical rate or indicator series over a date range
  • List public holidays, upcoming holidays and long weekends, and count business days between dates
When to use it
Useful when an assistant has to check Latin American identifiers before onboarding, payouts or CRM cleanup, or needs regional FX rates, indicators, company registry data or holiday-aware working-day counts.
Requirements
Runs locally over stdio via uvx from the PyPI package latam-data-mcp; needs uv installed and Python 3.10 or newer (uv handles it). No signup, API keys or environment variables. Network access is needed for the upstream public data APIs; tax-ID validation is local math.
Before you install
Company and taxpayer lookups return registry data such as partners, addresses and compliance status, so results may contain personal or business-sensitive information. Validation tools only check format and check digits and do not prove an ID is real or authorized. A paid Pro tier (hosted endpoint, sanctions screening, bulk validation) is offered separately; the free tools do not require payment.

Installation

In SourceWeft

  1. Open LatAm Data in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[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

ToolWhat it does
validate_tax_idValidates 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_accountValidates 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_keyValidates 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_numberValidates & 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_lookupResolves a 🇧🇷 bank by COMPE code (name, ISPB).
brazil_company_lookupFull 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

ToolWhat it does
chile_indicatorsUF, UTM, USD, EUR and more, in CLP.
argentina_exchange_ratesOfficial vs blue rate for USD/EUR.
brazil_market_ratesSELIC, CDI, IPCA.
colombia_official_trmThe legally binding USD/COP rate with validity dates.
brazil_historical_seriesHistorical SELIC/CDI/IPCA/USD over a date range, with min/max/avg/change — for trend analysis and backtesting.
colombia_trm_historyHistorical USD/COP (TRM) over a date range.
costa_rica_exchange_rate🇨🇷 official USD/EUR colón rate.
currency_convertConvert any amount between two currencies at the live rate.
latam_exchange_ratesAll 18 LatAm currencies vs USD in one call.

Time & calendars

ToolWhat it does
public_holidaysOfficial holidays for 20 LatAm countries, any year.
next_holidaysUpcoming holidays from today.
long_weekendsLong weekends with bridge-day analysis.
business_daysWorking-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:

bash
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):

json
{  "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 mcpServers block, 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 (run which 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 646180110400000007 valid, and which bank is it?" → ✅ valid · Banco STP · branch 180 · account …

"Validate Brazilian CNPJ 00.000.000/0001-91 and 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

bash
python3.11 -m venv .venv.venv/bin/pip install -e ".[dev]".venv/bin/python server.py     # stdio; set PORT=8000 for Streamable HTTP

Tests

bash
.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)

Source: README.md at commit a229614

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.6.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts