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 分