mcpField
L
LatAm Data

LatAm Data

ローカル
github.com/svkbogislav金融データ015 週間前に更新

LatAm Data について

LatAm Dataは、ラテンアメリカの本人確認、企業、金融、カレンダーデータを扱うエージェント向けMCPサーバーです。各種検証や検索、為替、祝日を考慮した日数計算をツールとして提供します。

主な機能

  1. 0115か国の納税者番号の検証
  2. 02銀行口座、PIXキー、電話番号の確認
  3. 03企業・銀行情報の検索
  4. 04経済指標と為替レートの取得
  5. 05祝日検索と営業日数の計算

活用シーン

  1. 01顧客の納税者番号と銀行口座の確認
  2. 02ブラジル企業の登記情報の取得
  3. 03為替レートの比較と通貨換算
  4. 04祝日を考慮した営業日数の計算

MCP 対応

ラテンアメリカの本人確認や口座検証、企業検索、経済指標、為替、カレンダー計算のツールをMCPクライアントに公開します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"svkbogislav-latam-data": {
"command": "uvx",
"args": [
"latam-data-mcp"
]
}
}
}
起動コマンドuvx latam-data-mcp

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypilatam-data-mcp0.6.1

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

LatAm Data MCP — AI エージェントに欠けているラテンアメリカのデータレイヤー

LatAm Data MCP

税務 ID の検証(12 か国分)、最新の経済指標、為替レート(アルゼンチンのブルーレートや、法的拘束力のあるコロンビアの TRM を含む)、ブラジル企業の検索、祝日、営業日計算など、各地に散在していたり、文書化されていなかったり、スペイン語のみで提供されていたりするラテンアメリカのデータに、エージェントが確実にアクセスできるようにする MCP サーバーです。

ツール(20)

ID、銀行、企業
ツール機能
validate_tax_id15 か国の国税 ID を実際のチェックディジット計算で検証します:🇨🇱 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_number15 か国の電話番号を検証・正規化し、E.164、国内形式、携帯電話・固定電話の判定結果を返します。ブラジルの 9 桁目、メキシコの 10 桁、アルゼンチンの 9/15、チリの 9 で始まる番号に対応します。
brazil_bank_lookupCOMPE コードから🇧🇷銀行を特定します(名称、ISPB)。
brazil_company_lookupCNPJ を指定して、ブラジルの任意の企業の連邦登録情報を取得します。正式名称、ステータス、規模、主な事業内容、資本金、住所、出資者が含まれます。
costa_rica_company_lookup🇨🇷 納税者番号 cédula から、名称、税制、事業内容、および Hacienda のコンプライアンス状況(moroso/omiso)を取得します。KYC/AML に利用できます。
通貨と市場
ツール機能
chile_indicatorsUF、UTM、USD、EUR などを CLP で取得します。
argentina_exchange_ratesUSD/EUR の公式レートとブルーレートを取得します。
brazil_market_ratesSELIC、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最新レートで任意の金額を 2 種類の通貨間で換算します。
latam_exchange_rates1 回の呼び出しで、ラテンアメリカの全 18 通貨と USD の為替レートを取得します。
時刻とカレンダー
ツール機能
public_holidaysラテンアメリカ 20 か国の公式祝日を、任意の年について取得します。
next_holidays今日以降の祝日を取得します。
long_weekends連休と、祝日に挟まれた平日の分析結果を取得します。
business_days祝日を考慮して、日付間の営業日数を計算します。SLA、給与計算、物流、決済日数の計算に利用できます。

インストール(無料 — お使いのマシンで実行)

サインアップも API キーも不要です。2 ステップで完了します。

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 ブロックを追加します。

あとはエージェントに 「チリの RUT 60.910.000-1 は有効ですか?」 と尋ねるだけです。これで完了です。Python 3.10 以降が必要です(uv が処理します)。

macOS での注意点: サーバーが表示されない場合は、command に uvx のフルパスを指定してください(which uvx を実行します → 例:/opt/homebrew/bin/uvx)。GUI アプリはシェルの PATH を常に引き継ぐわけではありません。初回起動時は uv がパッケージを取得するため数秒かかりますが、次回からはすぐに起動します。

動作を確認する

接続したら、エージェントに自然な言葉で尋ねるだけです。

「メキシコの 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 を除外)

接着コードは不要です。エージェントが適切なツールを選んで呼び出します。

Pro — コンプライアンスとデータのプラン

上記のツールは永久に無料です。Pro では、チームが実際に料金を払って利用するコンプライアンスおよびデータ機能を追加します。無料の公開 API では利用できない機能です。

  • 🛡️ OFAC 制裁リスト/監視リストのスクリーニング — KYC/AML のオンボーディング向けに、類似名を照合します(別名、名前の順序違い、アクセント記号にも対応)。
  • 🏢 納税者番号による企業検索 — 現在は 🇨🇱 チリに対応。🇦🇷 アルゼンチン、🇵🇪 ペルー、🇲🇽 メキシコは近日対応予定です — 企業名、ステータス、事業内容、コンプライアンスフラグを確認できます。
  • 📋 一括検証 — 1 回の呼び出しで最大 10,000 件の ID を検証できます。オンボーディングのパイプラインや CRM の整理に便利です。
  • 近日公開: PEP スクリーニング、変更監視 Webhook、拡張された履歴データ

高いレート制限と優先サポートを備えた、常時稼働のマネージドホスト型エンドポイントとして提供されます(セルフホストには対応していません)。

💳 月額 $19.99 — → Pro に登録

チーム向けに開発している場合や、特定の国・データソースへの先行対応が必要な場合は、 イシューを作成してください — 利用ケースをお知らせいただければ、早期アクセスをご案内します。

開発

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 のリファレンスアルゴリズムと、実在する公的機関(Banco do Brasil、SUNAT、DIAN、UTE、U. de Chile)の ID を使って検証されています。

データソース

すべてキー不要の無料公開 API です:gael.cloud(チリ)、Bluelytics(アルゼンチン)、BrasilAPI(ブラジル)、datos.gov.co(コロンビア)、open.er-api.com(地域の為替レート)、Nager.Date(祝日)。納税者番号の検証は純粋なローカル計算です — 依存関係ゼロ、遅延ゼロ、壊れる要素もありません。

ロードマップ

  • 過去の時系列データ(UF、USD、TRM)
  • 無料プランのデプロイとディレクトリへの掲載(Smithery、PulseMCP、mcp.so)
  • 無料プランの週間アクティブユーザー獲得後、MCPize を通じて収益化(収益の 85% を還元)
  • 国ごとの電子請求書発行要件(静的ナレッジツール)

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。