MCP経由で接続

MCP クライアントから同じ Narwhal キーと公開 API スキーマを使用します。

NarwhalはステートレスなStreamable HTTP MCPエンドポイントを1つ公開しています。RESTと同じ6つのデータAPI、レスポンススキーマ、認証、クォータを使用します。

接続

認証済みStreamable HTTPに対応するMCPクライアントへ、リモートサーバーURLとBearerヘッダーを追加します。

クライアントに依存しないフィールドマップ

{
  "url": "https://api.narwhalapi.com/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_NARWHAL_API_KEY"
  }
}

これはフィールドマップであり、コピー＆ペースト用ファイルではありません。置き換えるもの： YOUR_NARWHAL_API_KEY クライアントの安全なシークレット設定を通じて指定します。JSON はそれ自体ではシェル変数を展開せず、MCP クライアントごとに環境変数の構文が異なります。

実際のキーを共有設定ファイルに貼り付けないでください。

利用可能なツール

tools/list 読み取り専用ツールを33個返します。Economics 操作18個と、FX、Equities、SEC 提出、Palmoil、Calendars の各3個です。

economics_get_cpieconomics_get_inflationeconomics_get_unemploymenteconomics_get_labour_force_participationeconomics_get_gdpeconomics_get_gdp_growtheconomics_get_tradeeconomics_get_trade_exportseconomics_get_trade_importseconomics_get_cpi_historyeconomics_get_inflation_historyeconomics_get_unemployment_historyeconomics_get_labour_force_participation_historyeconomics_get_gdp_historyeconomics_get_gdp_growth_historyeconomics_get_trade_historyeconomics_get_trade_exports_historyeconomics_get_trade_imports_historyfx_get_ratesfx_get_rate_historyfx_convert_currencyequities_list_instrumentsequities_get_instrumentequities_get_barscompanies_searchcompanies_getcompanies_list_filingscommodities_discover_physical_seriescommodities_get_oil_palm_ffb_pricecommodities_get_oil_palm_ffb_price_observationscalendars_list_holidayscalendars_get_holidays_on_datecalendars_get_next_holiday

引数と結果

最新リリースツールは次を受け付けます： country および任意の period。履歴ツールは country、任意 start および end、さらに limit および cursor ページ分割向け。

ツール引数

{
  "country": "USA",
  "period": "2026-07"
}

2つの方向別貿易ツールでは、MCP は次を使用します： "product": { "classification": "HS2022", "code": "27" }。RESTでは同じフィルターを別々の classification および product クエリパラメータ。

ツール	期間	その他の引数
`economics_get_cpi`	`YYYY-MM`	なし
`economics_get_inflation`	`YYYY-MM`	なし
`economics_get_unemployment`	`YYYY, YYYY-MM, or YYYY-QN`	なし
`economics_get_labour_force_participation`	`YYYY, YYYY-MM, or YYYY-QN`	なし
`economics_get_gdp`	`YYYY-QN`	なし
`economics_get_gdp_growth`	`YYYY-QN`	なし
`economics_get_trade`	`YYYY or YYYY-MM`	なし
`economics_get_trade_exports`	`YYYY or YYYY-MM`	`partner` およびネストされた `product` 受け付けますが、フィルター済み合計はまだ公開されていません。
`economics_get_trade_imports`	`YYYY or YYYY-MM`	`partner` およびネストされた `product` 受け付けますが、フィルター済み合計はまだ公開されていません。
`economics_get_cpi_history`	`YYYY-MM`	`start`, `end`, `limit`、および `cursor`
`economics_get_inflation_history`	`YYYY-MM`	`start`, `end`, `limit`、および `cursor`
`economics_get_unemployment_history`	`YYYY, YYYY-MM, or YYYY-QN`	`start`, `end`, `limit`、および `cursor`
`economics_get_labour_force_participation_history`	`YYYY, YYYY-MM, or YYYY-QN`	`start`, `end`, `limit`、および `cursor`
`economics_get_gdp_history`	`YYYY-QN`	`start`, `end`, `limit`、および `cursor`
`economics_get_gdp_growth_history`	`YYYY-QN`	`start`, `end`, `limit`、および `cursor`
`economics_get_trade_history`	`YYYY-MM`	`start`, `end`, `limit`、および `cursor`
`economics_get_trade_exports_history`	`YYYY-MM`	`start`, `end`, `limit`、および `cursor`
`economics_get_trade_imports_history`	`YYYY-MM`	`start`, `end`, `limit`、および `cursor`

成功したツール呼び出しは、スキーマに適合した値を返します： structuredContent クライアント互換性のため、同じ JSON をテキストとしてシリアライズしたものも含みます。MCP の問題は REST と同じ公開ステータスおよびコード用語を使用します。

クォータの動作

初期化とツールのディスカバリーはデータクォータを消費しません。成功した各 tools/call 成功した REST 呼び出し1回と同様、リクエストを正確に1件消費します。

初回の tools/call

{
  "method": "tools/call",
  "params": {
    "name": "fx_get_rates",
    "arguments": { "base": "USD", "currencies": ["EUR", "JPY"] }
  }
}

無料ベータに含まれるもの： 3,000 UTC 月あたりの成功リクエスト数、および 30 1分あたりのリクエスト数。バースト上限： 5。クォータの状態は X-RateLimit-Limit, X-RateLimit-Remaining、および X-RateLimit-Reset。短時間ウィンドウの状態は X-RateLimit-Short-Limit, X-RateLimit-Short-Remaining、および X-RateLimit-Short-Reset。短時間ウィンドウのスロットリングは 429 rate_limit_exceeded。月間上限到達時は 429 quota_exhausted.

トラブルシューティング

症状	確認
`401 invalid_api_key`	正確なBearerヘッダーと、キーが有効なままかを確認します。
接続はリダイレクトに従います	正確に使用： `https://api.narwhalapi.com/mcp` 末尾のスラッシュなし。
ツールがありません	利用できるのは、上記に記載した公開ツールだけです。
ツールが問題を返します	構造化された status、code、detail とリクエスト ID を確認します。参照先：エラーとクォータ.