Twelvedata

@pipeworx/twelvedata

Twelve Data MCP — 株式、ETF、外国為替、暗号資産のデータ。1 日あたり 800 件の無料リクエスト。

Pipeworx の一部です — AI エージェントを 1684 以上のライブデータソースに接続する MCP ゲートウェイです。

認証

• プラットフォーム：PLATFORM_TWELVEDATA_KEY。BYO：?_apiKey=…。

ツール

• time_series(symbol, interval, exchange?, mic_code?, country?, type?, outputsize?, prepost?, dp?, order?, timezone?, date?, start_date?, end_date?, previous_close?, format?, delimiter?) — OHLC 時系列
• quote(symbol, interval?, exchange?, country?, format?, dp?, prepost?, timezone?, eod?) — 気配値スナップショット
• price(symbol, format?, prepost?) — 最新価格
• eod(symbol, exchange?, mic_code?, country?, type?, prepost?, dp?, format?) — 日末の気配値
• exchange_rate(symbol, format?, dp?, timezone?) — 為替レート（例：EUR/USD）
• currency_conversion(symbol, amount, format?, dp?) — FX 換算
• stocks(symbol?, exchange?, mic_code?, country?, type?, format?) — 株式シンボル
• forex_pairs(symbol?, currency_base?, currency_quote?, format?) — 外国為替ペア
• cryptocurrencies(symbol?, exchange?, currency_base?, currency_quote?, format?) — 暗号資産シンボル
• etfs(symbol?, exchange?, mic_code?, country?, page?, outputsize?) — ETF シンボル、ページ分割（既定値は 200 行、count は合計数）。株式ティッカーを指定すると、empty_reason: wrong_instrument_class と stocks への案内が返されます。
• indices(symbol?, country?, exchange?, mic_code?, page?, outputsize?) — インデックスシンボル、ページ分割。米国以外のインデックスは約 1,300 件です。米国のインデックス（SPX、DJI、IXIC）は Twelve Data のリファレンスリストに含まれていません。これらの気配値を取得するには、Grow 以上のキーを _apiKey で指定する必要があります。米国で絞り込むと、空のリストではなく、その旨の拒否応答が返されます。
• earnings(symbol, exchange?, country?, mic_code?, type?, period?, outputsize?, format?, dp?, start_date?, end_date?) — 決算カレンダー
• earnings_calendar(start_date?, end_date?, country?, format?, dp?) — 広範な決算カレンダー
• dividends(symbol, exchange?, country?, mic_code?, range?, start_date?, end_date?) — 配当
• splits(symbol, exchange?, country?, mic_code?, range?, start_date?, end_date?) — 株式分割
• profile(symbol, exchange?, country?, mic_code?) — 企業プロフィール

データソース

https://api.twelvedata.com

クイックスタート

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

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

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

https://gateway.pipeworx.io/twelvedata/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 も、同じゲートウェイと同じ 1684 以上のデータソースに接続します。唯一の違いは、どのパックのツールが直接一覧表示されるかです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/time_series \
  -H 'Content-Type: application/json' \
  -d '{"symbol":"AAPL","interval":"1h"}'

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

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

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

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

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

npx -y @pipeworx/mcp-twelvedata

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

ask_pipeworx を使用する

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

ask_pipeworx({ question: "your question about Twelvedata data" })

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

詳細

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

ライセンス

MIT