Pyth Pro Mcp

Pyth Pro MCP サーバー

AI アシスタントがPythのリアルタイムおよび過去の市場データにアクセスできるMCPサーバーです。暗号資産、株式、外国為替、コモディティなど、500以上の価格フィードを利用できます。

ホスト先：https://mcp.pyth.network/mcp

クイックスタート

各スニペットは、独自のPyth Pro APIキーをAuthorization: Bearerヘッダーとして送信します。キーは一度設定すれば使えます（アクセストークンを参照）。

Claude Code

claude mcp add --transport http pyth https://mcp.pyth.network/mcp --header "Authorization: Bearer YOUR_TOKEN"

この設定では、コマンドを実行したフォルダーでのみPythを追加します。すべてのプロジェクトで使うには、--scope userを追加してください。開いたプロジェクトから、設定したキーを使って価格ツールを呼び出せるようになります。

Claude Desktop

Claude Desktopは、リモートサーバーにカスタムコネクターとして接続します。Anthropicのリクエストヘッダーのベータ版が有効な場合に限り、ヘッダーとしてキーを送信できます。すべてのプランでキーを一度だけ設定するには、mcp-remote（Node.jsが必要）を使って、claude_desktop_config.json（Claudeのメニューバー → Settings… → Developer → Edit Config）でブリッジします。

{
  "mcpServers": {
    "pyth": {
      "command": "npx",
      "args": ["-y", "[email protected]", "https://mcp.pyth.network/mcp", "--header", "Authorization:${PYTH_AUTH_HEADER}"],
      "env": { "PYTH_AUTH_HEADER": "Bearer YOUR_TOKEN" }
    }
  }
}

mcp-remoteはコミュニティ製パッケージであり、Pythがメンテナンスしているものではありません。また、キーを取り扱います。このスニペットでは、テスト済みのバージョンを固定しています。

または、https://mcp.pyth.network/mcpをカスタムコネクターとして追加します。Free、Pro、MaxではCustomize → Connectors → Add custom connectorから、TeamまたはEnterpriseではOwnerがOrganization settings → Connectors → Add → Customから追加し、メンバーがCustomize → ConnectorsでConnectをクリックします。リクエストヘッダーのベータ版を利用する場合は、No sign-inを選び、authorizationヘッダーにBearer YOUR_TOKENを追加します（TeamおよびEnterpriseプランでは、Ownerが組織全体に対して設定するため、全員で同じキーを使います）。それ以外の場合は、呼び出しごとにキーを渡してください。

Cursor

~/.cursor/mcp.jsonに追加します（グローバル設定のため、キーがリポジトリに含まれることはありません）。

{
  "mcpServers": {
    "pyth": {
      "url": "https://mcp.pyth.network/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

ファイルにキーを記載しないようにするには、"Bearer ${env:PYTH_PRO_ACCESS_TOKEN}"と記述し、シェルのプロファイルまたはシステム環境でその変数を設定してください。

VS Code

~/.copilot/mcp-config.jsonに追加します。これはユーザーレベルのファイルで、VS CodeのチャットとAgent Hostのセッションの両方が読み込みます。キーは平文で保存されるため、リポジトリにコピーしないでください。（VS Codeの${input:...}プロンプトを使えばキーをファイルに記載せずに済みますが、Agent Hostのセッションでは、それを使う.vscode/mcp.jsonのサーバーを利用できません。）

{
  "mcpServers": {
    "pyth": {
      "type": "http",
      "url": "https://mcp.pyth.network/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" },
      "tools": ["*"]
    }
  }
}

その他のクライアント

Streamable HTTPに対応するMCPクライアントであれば、ヘッダーAuthorization: Bearer YOUR_TOKENを付けてhttps://mcp.pyth.network/mcpに接続できます。

ツール

ツール	説明	認証が必要
get_symbols	価格フィードを検索して一覧表示します。資産タイプ、金融商品タイプ、先物チェーンで絞り込めます	任意（Pro限定フィードと、各フィードのentitledフラグが追加されます）
get_latest_price	1つ以上のフィードのリアルタイム価格	はい（アクセストークン）
get_historical_price	指定時点の価格スナップショット	はい（アクセストークン）
get_price_range	最大60秒の期間内におけるすべての価格更新	はい（アクセストークン）
get_candlestick_data	チャート作成や分析向けのOHLCローソク足データ	はい（アクセストークン）
convert_date_to_timestamp	日付文字列をUnixタイムスタンプに変換します	いいえ

ヒント： まずget_symbolsを使って、利用可能なフィードを確認してください。価格ツールは完全なシンボル（Crypto.BTC/USD）またはペアのみの表記（BTC/USD）を受け付けます。ペアのみの表記の場合、ライブのスポットフィードがあればそれに解決され、なければ残っている一致候補が1つだけのときにそれに解決されます（例：BTC/USDT → Binanceのファンディングレートフィード）。候補が複数ある場合は、エラーにその一覧が表示されます。

アクセストークン

各ユーザーがそれぞれ独自の Pyth Pro アクセストークンを用意します。get_latest_price、get_historical_price、get_price_range、get_candlestick_data にはトークンが必要です。get_symbols はトークンなしでも動作しますが、トークンがある場合は Pro キーでのみ表示されるフィードも一覧に含め、各フィードに entitled: true/false（現在のトークンでクエリできるかどうか）を示します。convert_date_to_timestamp にはトークンは不要です。

• トークンを取得：API キーを取得
• 次の 3 つの方法のいずれかで、サーバーにトークンを渡します。呼び出し時に渡されたトークンは、設定済みのトークンより優先されます。
  • ホスト型サーバー用に一度だけ設定する：MCP クライアントから Authorization: Bearer ヘッダーとして送信します（クイックスタートを参照）。これにより、アシスタントが呼び出しのたびにトークンを扱う必要がなくなります。
  • ローカルの stdio サーバー用に一度だけ設定する：クライアント設定のサーバーの env ブロックに PYTH_PRO_ACCESS_TOKEN を設定します（ローカル stdio 設定を参照）。
  • 呼び出しごとに指定する：access_token ツールパラメーターを使用します。トークンが設定されていない場合、アシスタントがトークンを求めます。ヘッダーを送信できないクライアント（例：リクエストヘッダーのベータ機能を使わない Claude Desktop のカスタムコネクター）では、この方法を使用します。
• サーバー自体はキーを持ちません。ホスト型サーバーは自身の環境変数にある PYTH_PRO_ACCESS_TOKEN を無視し、各ユーザーが送信するキーのみを使用します。
• 401 は、トークンが無効または期限切れであることを示します。403 は、トークンは有効ですが、そのフィードを利用できるプランではないことを示します。エラーには必要なエンタイトルメントグループが記載されます。
• stable 状態のフィードのみ価格を返します。価格が返されないフィード（例：beta または coming_soon のフィード、あるいはフィードの min_channel より高速なチャネル）は、missing_feed_ids に一覧表示されます。

クエリの例

接続済みの AI アシスタントで、次のクエリを試してみてください。

• 「ビットコインの現在の価格は？」
• 「過去 24 時間の ETH/USD の価格履歴を表示して」
• 「現在の金と銀の価格を比較して」
• 「過去 1 週間の AAPL の日次ローソク足データを取得して」
• 「Pyth で利用できる暗号資産の価格フィードは？」
• 「今日の 14:30 UTC 以降 30 秒間の BTC/USD の価格更新をすべて表示して」
• 「Pyth が提供している VIX 先物契約は？」

ローカル開発

MCP サーバー自体に取り組むコントリビューター向けです。

ビルド

pnpm --filter @pythnetwork/mcp build

MCP Inspector

Inspector を実行して、ツールを対話的にテストします。

npx @modelcontextprotocol/inspector --cli -- pnpm --filter @pythnetwork/mcp start:stdio:dev

ローカル stdio 設定

stdio 経由でクライアントをローカルビルドに接続するには：

{
  "mcpServers": {
    "pyth-mcp": {
      "command": "node",
      "args": ["<path-to-repo>/apps/mcp/dist/index.js"],
      "env": { "PYTH_PRO_ACCESS_TOKEN": "YOUR_TOKEN" }
    }
  }
}

環境変数

変数	デフォルト	説明
PYTH_CHANNEL	fixed_rate@200ms	デフォルトの価格チャネル：real_time、fixed_rate@50ms、fixed_rate@200ms、または fixed_rate@1000ms
PYTH_LOG_LEVEL	info	ログレベル（debug/info/warn/error）
PYTH_REQUEST_TIMEOUT_MS	10000	HTTP リクエストのタイムアウト
PYTH_PRO_ACCESS_TOKEN	—	独自のトークン。stdio のみ。HTTP サーバーでは無視されます。

リンク

• Pyth Pro ドキュメント
• API キーを取得
• 料金
• GitHub リポジトリ