LatAm Data

io.github.svkbogislav由 GitHub 账号 svkbogislav 发布v0.6.1更新于 Oct 24, 2026

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

概览

AI 生成的概览

本地 MCP 服务器,让助手校验拉美各国税号、银行账号与电话,查询汇率与经济指标、企业信息,并计算节假日与工作日。

可以做什么
  • 校验并规范化拉美多国税号、银行账号、PIX 密钥和电话号码,含校验位计算与个人/企业类型识别
  • 按 CNPJ 查询巴西企业、按 COMPE 代码查询巴西银行、按身份证号查询哥斯达黎加纳税人
  • 获取智利、阿根廷、巴西、哥伦比亚和哥斯达黎加的经济指标与汇率,以及全部拉美货币对美元汇率
  • 在两种货币间换算金额,并按日期区间获取历史汇率或指标序列
  • 列出公共假日、即将到来的假日和长周末,并计算两个日期之间的工作日数
适用场景
适合在开户审核、付款或 CRM 数据清理前核对拉美标识信息,或需要区域汇率、经济指标、企业登记数据和考虑节假日的工作日计算时使用。
运行要求
通过 uvx 从 PyPI 包 latam-data-mcp 以 stdio 在本地运行;需安装 uv,Python 3.10 及以上(由 uv 处理)。无需注册、API 密钥或环境变量。访问上游公开数据接口需要网络;税号校验为本地计算。
安装前请注意
企业与纳税人查询会返回合伙人、地址、合规状态等登记信息,结果可能包含个人或商业敏感数据。校验工具只检查格式与校验位,不能证明该号码真实存在或已获授权。另有付费 Pro 版本(托管端点、制裁名单筛查、批量校验),免费工具无需付费。

安装

在 SourceWeft 中

  1. 打开 控制台中的 LatAm Data,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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)

来源:README.md,提交 a229614

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.6.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分