{
  "markdown": "<p align=\"center\">\n  <img src=\"https://raw.githubusercontent.com/svkbogislav/latam-data-mcp/main/assets/banner.png\" alt=\"LatAm Data MCP — the Latin American data layer your AI agent is missing\" />\n</p>\n\n<!-- mcp-name: io.github.svkbogislav/latam-data-mcp -->\n\n# LatAm Data MCP\n\nAn MCP server that gives agents reliable access to LatAm data that is\notherwise scattered, undocumented, or Spanish-only: tax-ID validation\nfor 12 countries, live economic indicators, exchange rates (including\nArgentina's blue rate and Colombia's legally binding TRM), Brazilian\ncompany lookups, holidays, and business-day math.\n\n## Tools (20)\n\n### Identity, banking & companies\n\n| Tool | What it does |\n|---|---|\n| `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. |\n| `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. |\n| `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. |\n| `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. |\n| `brazil_bank_lookup` | Resolves a 🇧🇷 bank by COMPE code (name, ISPB). |\n| `brazil_company_lookup` | Full federal-registry data for any Brazilian company by CNPJ: legal name, status, size, main activity, capital, address, partners. |\n| `costa_rica_company_lookup` | 🇨🇷 taxpayer by cédula: name, regime, activities, and **compliance status** (moroso/omiso) from Hacienda — for KYC/AML. |\n\n### Money & markets\n\n| Tool | What it does |\n|---|---|\n| `chile_indicators` | UF, UTM, USD, EUR and more, in CLP. |\n| `argentina_exchange_rates` | Official vs **blue** rate for USD/EUR. |\n| `brazil_market_rates` | SELIC, CDI, IPCA. |\n| `colombia_official_trm` | The legally binding USD/COP rate with validity dates. |\n| `brazil_historical_series` | Historical SELIC/CDI/IPCA/USD over a date range, with min/max/avg/change — for trend analysis and backtesting. |\n| `colombia_trm_history` | Historical USD/COP (TRM) over a date range. |\n| `costa_rica_exchange_rate` | 🇨🇷 official USD/EUR colón rate. |\n| `currency_convert` | Convert any amount between two currencies at the live rate. |\n| `latam_exchange_rates` | All 18 LatAm currencies vs USD in one call. |\n\n### Time & calendars\n\n| Tool | What it does |\n|---|---|\n| `public_holidays` | Official holidays for 20 LatAm countries, any year. |\n| `next_holidays` | Upcoming holidays from today. |\n| `long_weekends` | Long weekends with bridge-day analysis. |\n| `business_days` | Working-day count between dates, holiday-aware — for SLA, payroll, logistics, settlement math. |\n\n## Install (free — runs on your machine)\n\nNo signup, no API keys. Two steps:\n\n**1. Install `uv`** (the runner) if you don't already have it:\n\n```bash\nbrew install uv                              # macOS\n# or, any platform:\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\n**2. Add the server to your MCP client config** (`mcpServers` block):\n\n```json\n{\n  \"mcpServers\": {\n    \"latam-data\": {\n      \"command\": \"uvx\",\n      \"args\": [\"latam-data-mcp\"]\n    }\n  }\n}\n```\n\n- **Claude Desktop:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n  (macOS) — then quit and reopen the app.\n- **Cursor / Claude Code / other clients:** same `mcpServers` block, in their config.\n\nThen just ask your agent *\"Is Chilean RUT 60.910.000-1 valid?\"* — done. Requires\nPython 3.10+ (uv handles it).\n\n> **macOS gotcha:** if the server doesn't show up, use the **full path** to uvx as\n> the `command` (run `which uvx` → e.g. `/opt/homebrew/bin/uvx`). GUI apps don't\n> always inherit your shell's PATH. First launch takes a few seconds while uv\n> fetches the package; instant after that.\n\n## See it work\n\nOnce connected, just ask your agent in plain language:\n\n> *\"Is the Mexican CLABE `646180110400000007` valid, and which bank is it?\"*\n> → ✅ valid · Banco STP · branch 180 · account …\n\n> *\"Validate Brazilian CNPJ `00.000.000/0001-91` and tell me who it is.\"*\n> → ✅ Banco do Brasil S.A. · active · Brasília-DF\n\n> *\"What's the UF and the dollar today in Chile? And convert 2,500,000 CLP to BRL.\"*\n\n> *\"How many business days between 2026-09-01 and 2026-09-30 in Chile?\"*\n> → holiday-aware working-day count (skips Fiestas Patrias)\n\nNo glue code — the agent picks the right tool and calls it.\n\n## Pro — the compliance & data tier\n\nThe tools above are **free forever**. **Pro** adds the compliance and data\nfeatures teams actually pay for — the stuff you can't get from a free public API:\n\n- 🛡️ **OFAC sanctions / watchlist screening** — fuzzy name matching (catches\n  aliases, reordered names, accents) for KYC/AML onboarding\n- 🏢 **Company lookup by tax ID** — 🇨🇱 Chile today; 🇦🇷 Argentina, 🇵🇪 Peru,\n  🇲🇽 Mexico coming — name, status, activities, compliance flags\n- 📋 **Bulk validation** — validate up to 10,000 IDs in one call, for onboarding\n  pipelines and CRM cleanups\n- *coming:* PEP screening, change-monitoring webhooks, extended historical data\n\nDelivered as a managed, always-on hosted endpoint (no self-hosting), with higher\nrate limits and priority support.\n\n### 💳 $19.99/mo — [→ Subscribe to Pro](https://latam-data-mcp.lemonsqueezy.com/checkout/buy/f75c3532-a919-4cab-a121-a9278066fe4e)\n\n**Building for a team, or need a specific country/data source first?**\n[Open an issue](https://github.com/svkbogislav/latam-data-mcp/issues/new) — tell me\nyour use case and I'll get you early access.\n\n## Develop\n\n```bash\npython3.11 -m venv .venv\n.venv/bin/pip install -e \".[dev]\"\n.venv/bin/python server.py     # stdio; set PORT=8000 for Streamable HTTP\n```\n\n## Tests\n\n```bash\n.venv/bin/pytest              # offline suite: validators + MCP protocol layer\n.venv/bin/pytest -m live      # integration tests against the real upstream APIs\n```\n\nValidators are verified against python-stdnum's reference algorithms and\nreal IDs of public institutions (Banco do Brasil, SUNAT, DIAN, UTE, U. de Chile).\n\n## Data sources\n\nAll free public APIs, no keys: gael.cloud (Chile), Bluelytics (Argentina),\nBrasilAPI (Brazil), datos.gov.co (Colombia), open.er-api.com (regional FX),\nNager.Date (holidays). Tax-ID validation is pure local math — zero\ndependencies, zero latency, nothing to break.\n\n## Roadmap\n\n- [ ] Historical series (UF, USD, TRM)\n- [ ] Deploy free tier + directory listings (Smithery, PulseMCP, mcp.so)\n- [ ] Monetization via MCPize (85% rev share) once free tier has weekly active users\n- [ ] Electronic invoicing requirements per country (static knowledge tool)\n",
  "bytes": 7096,
  "sha": "00e0b4878b72c5123f9e123143948063fe4c93d58453494f18e72637daa430e2",
  "repo_slug": "svkbogislav/latam-data-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_svkbogislav_latam_data_mcp_80670dc7/readme"
}