LatAm Data

LatAm Data MCP

一个 MCP 服务，让 Agent 能够可靠地访问拉丁美洲数据。这些数据原本分散各处、缺少文档或仅提供西班牙语版本：涵盖 12 个国家的税号验证、实时经济指标、汇率（包括阿根廷的蓝美元汇率和哥伦比亚具有法律约束力的 TRM）、巴西企业查询、节假日和工作日计算。

工具（20 个）

身份、银行与企业

工具	功能
validate_tax_id	使用真实的校验位算法验证 15 个国家的国家税号：🇨🇱 RUT、🇦🇷 CUIT/CUIL、🇲🇽 RFC、🇧🇷 CPF/CNPJ（包括 2026 年推出的字母数字 CNPJ）、🇨🇴 NIT、🇵🇪 RUC、🇺🇾 RUT、🇪🇨 cédula/RUC、🇵🇾 RUC、🇻🇪 RIF、🇬🇹 NIT、🇩🇴 RNC、🇵🇦 RUC+DV、🇨🇷 cédula、🇧🇴 NIT。返回标准格式，并识别个人、企业或公共实体。
validate_bank_account	使用校验位算法验证银行间账户代码：🇲🇽 CLABE（18 位）、🇦🇷 CBU/CVU（22 位，包括 Mercado Pago 虚拟账户）。解析银行、分行和账户信息——汇款前验证收款账户。
validate_pix_key	验证 🇧🇷 PIX 密钥（CPF、CNPJ、电子邮件、+55 电话号码或随机 UUID），并识别其类型；针对 CPF/CNPJ 使用完整的校验位算法。
validate_phone_number	验证并标准化 15 个国家的电话号码 → E.164、国家格式，并识别移动电话/固定电话。支持巴西的第 9 位数字、墨西哥的 10 位号码、阿根廷的 9/15 位号码和智利的 9 前缀。
brazil_bank_lookup	根据 COMPE 代码查询 🇧🇷 银行（名称、ISPB）。
brazil_company_lookup	根据 CNPJ 查询任意巴西企业的完整联邦注册信息：法定名称、状态、规模、主要业务、资本、地址和合作伙伴。
costa_rica_company_lookup	根据 cédula 查询 🇨🇷 纳税人信息：名称、税制、业务和 Hacienda 提供的合规状态（moroso/omiso），适用于 KYC/AML。

资金与市场

工具	功能
chile_indicators	以 CLP 计价的 UF、UTM、USD、EUR 等。
argentina_exchange_rates	USD/EUR 官方汇率与蓝美元汇率。
brazil_market_rates	SELIC、CDI、IPCA。
colombia_official_trm	具有法律约束力的 USD/COP 汇率，并提供有效日期。
brazil_historical_series	按日期范围查询 SELIC/CDI/IPCA/USD 历史数据，并提供最小值、最大值、平均值和变化量，适用于趋势分析和回测。
colombia_trm_history	按日期范围查询 USD/COP（TRM）历史数据。
costa_rica_exchange_rate	🇨🇷 官方 USD/EUR 对科朗汇率。
currency_convert	按实时汇率转换任意两种货币之间的金额。
latam_exchange_rates	一次调用即可获取全部 18 种拉丁美洲货币兑 USD 的汇率。

时间与日历

工具	功能
public_holidays	查询任意年份中 20 个拉丁美洲国家的官方节假日。
next_holidays	查询从今天起即将到来的节假日。
long_weekends	查询长周末，并分析连休调休日。
business_days	计算日期之间的工作日天数，并考虑节假日，适用于 SLA、薪资、物流和结算计算。

安装（免费 — 在你的计算机上运行）

无需注册，无需 API 密钥。只需两步：

1. 安装 uv（运行器），如果你还没有安装：

brew install uv                              # macOS
# or, any platform:
curl -LsSf https://astral.sh/uv/install.sh | sh

2. 将服务添加到你的 MCP 客户端配置中（mcpServers 区块）：

{
  "mcpServers": {
    "latam-data": {
      "command": "uvx",
      "args": ["latam-data-mcp"]
    }
  }
}

• Claude Desktop： ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）— 然后退出并重新打开应用。
• Cursor / Claude Code / 其他客户端： 在各自的配置中添加相同的 mcpServers 区块。

然后只需询问你的 Agent：“智利 RUT 60.910.000-1 有效吗？” — 就完成了。需要 Python 3.10+（uv 会处理）。

macOS 注意事项： 如果服务没有显示，请将 uvx 的完整路径用作 command（运行 which uvx → 例如 /opt/homebrew/bin/uvx）。图形界面应用不一定 会继承你的 shell PATH。首次启动时，uv 获取软件包需要几秒钟；之后即可立即启动。

查看实际效果

连接后，只需用自然语言询问你的 Agent：

“墨西哥 CLABE 646180110400000007 有效吗？属于哪家银行？” → ✅ 有效 · Banco STP · 分行 180 · 账户 …

“验证巴西 CNPJ 00.000.000/0001-91，并告诉我对应的机构。” → ✅ Banco do Brasil S.A. · 正常营业 · Brasília-DF

“智利的 UF 和今天的美元汇率是多少？再把 2,500,000 CLP 换算成 BRL。”

“2026-09-01 到 2026-09-30 之间，智利有多少个工作日？” → 会考虑节假日的工作日计数（跳过 Fiestas Patrias）

无需编写胶水代码 — Agent 会选择合适的工具并调用它。

Pro — 合规与数据层

上述工具永久免费。Pro 增加了团队实际愿意付费使用的合规与数据功能 — 这些内容无法通过免费的公共 API 获取：

• 🛡️ OFAC 制裁名单 / 观察名单筛查 — 模糊姓名匹配（可识别别名、姓名顺序颠倒和重音符号），用于 KYC/AML 入驻审核
• 🏢 通过税号查询公司信息 — 目前支持 🇨🇱 智利；即将支持 🇦🇷 阿根廷、🇵🇪 秘鲁、🇲🇽 墨西哥 — 名称、状态、业务活动、合规标记
• 📋 批量验证 — 单次调用最多验证 10,000 个 ID，适用于入驻流程和 CRM 清理
• 即将推出： PEP 筛查、变更监控 Webhook、扩展历史数据

以托管、始终在线的托管端点形式交付（无需自托管），并提供更高的速率限制和优先支持。

💳 $19.99/mo — → 订阅 Pro

正在为团队开发，或者需要优先支持某个国家 / 数据源？ 提交 issue — 告诉我你的 使用场景，我会为你提供提前体验权限。

开发

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

测试

.venv/bin/pytest              # offline suite: validators + MCP protocol layer
.venv/bin/pytest -m live      # integration tests against the real upstream APIs

验证器已通过与 python-stdnum 的参考算法以及公共机构的真实 ID（Banco do Brasil、SUNAT、DIAN、UTE、U. de Chile）进行比对验证。

数据来源

全部为免费的公共 API，无需密钥：gael.cloud（智利）、Bluelytics（阿根廷）、 BrasilAPI（巴西）、datos.gov.co（哥伦比亚）、open.er-api.com（区域外汇）、 Nager.Date（节假日）。税号验证完全通过本地数学运算完成 — 零依赖、零延迟，无故障风险。

路线图

• 历史序列（UF、USD、TRM）
• 部署免费版 + 目录上架（Smithery、PulseMCP、mcp.so）
• 免费版有周活跃用户后，通过 MCPize 实现变现（85% 收入分成）
• 各国电子发票要求（静态知识工具）