Datos Co

@pipeworx/datos-co

コロンビアの国のオープンデータ：汎用データセット検索／クエリツールと、コロンビアの集団投資ファンド（fondos de inversión colectiva、FIC）の検索機能です。

Pipeworx の一部です。AI エージェントを 1882 以上の稼働中のデータソースに接続する MCP ゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携関係になく、推奨も公開もされていません。

ツール

• search_datasets(q)、dataset_columns(datasetId)、query_dataset(datasetId, $where, ...) — 国のオープンデータポータルにある任意のデータセットに汎用的にアクセスします。
• co_fic_search(name) — ファンド名または運用会社名でファンドを検索します。大文字小文字、アクセント、語順は区別されません。各単語につき 1 つの誤字が許容されます。fund_code、事業体名とファンド名を返します。見つからない場合は、最も近い名前とともに found:false を返します。
• co_fic_unit_value(fund | fund_code, date?, from?, to?, participation_class?) — 参加クラスごとの基準価額（valor de la unidad）、ファンド規模、投資家数、日次／月次／半年次／年次リターンを返します。デフォルトは、直近の公開日です。

知っておくと便利な動作

• 名前に一致するものがない場合は、reason: "no_fund_matches_all_words" と closest ファンドを含む found:false を返します。複数の名前に一致する場合は、reason: "ambiguous_fund_name" と candidates を返します。選択するには fund_code を渡してください。日付の形式が正しくない場合や、ファンドが見つからない場合は、該当なしではなくエラーになります。
• 公開には数日の遅れがあります。data_as_of は直近の公開日、fund_last_reported はファンド自身の直近の行を示します。それより後の日付を指定すると、fund_matched_but_no_rows_for_request が返されます。
• 上流データの重複行は、日付と参加クラスごとに 1 行にまとめられます。
• リターンのフィールド：規制当局はパーセンテージを公開していますが、その算出根拠は文書化されていません。同じ基準価額の系列と照らして確認した当方の解釈では、それぞれ直近 1／30／183／365 日間の実効年率（365 日換算）です。そのため、日次の数値は年率換算値であり、当日の価格変動ではありません。
• 直近 30 日以内に報告を行ったファンドのみ検索できます。

認証

認証キーは不要です。プラットフォームキーも不要です。

データソース

Superintendencia Financiera de Colombia の集団投資ファンド（FIC）の日次系列データで、国のオープンデータポータルに公開されています。リクエストごとにプロキシ経由で取得され、ミラーはありません。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "datos-co": {
      "url": "https://gateway.pipeworx.io/datos-co/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/datos-co/mcp の tools/list は、上の表にあるツールに加えて、共有 Pipeworx メタツール — ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で共有されるツール一式 — を返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック固有のツールとともに、およそ 30 個の共有ツールが一覧表示されます。接続の initialize 応答には正確な範囲が示され、その日の状況を確認する際の正式な情報源となります。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使えば、このパックの対象外の質問にも、カタログ全体を横断してルーティングする ask_pipeworx を通じて回答できます。別の MCP サーバーを追加する必要はありません。現時点では、これらのメタツールを含めずにパックのエンドポイントを接続する方法はありません。追加のスキーマにかかるコンテキストコストがルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworx のフルゲートウェイに接続して、このパックだけでなく、すべてのパックのツールを直接一覧表示できます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ 1882 以上のデータソースに接続します。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合は、HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/datos_co_search_datasets \
  -H 'Content-Type: application/json' \
  -d '{"q":"covid"}'

最初の呼び出しにアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/datos_co_search_datasets を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイとの往復通信も不要です。

{
  "mcpServers": {
    "datos-co": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-datos-co"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-datos-co

stdin/stdout 経由で MCP を使用し、initialize／tools/list／tools/call に応答します。対象はこのパックのツールのみで、上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使用する

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは上記のパックエンドポイントだけでなく、フルゲートウェイでも機能します。

ask_pipeworx({ question: "your question about Datos Co data" })

ゲートウェイが適切なツールを選び、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT