Api Ninjas

mcp-api-ninjas

API Ninjas MCP — 複数のエンドポイントを持つ API Ninjas データ API（api-ninjas.com）をラップします。

Pipeworx の一部です — AI エージェントを 1872 以上のライブデータソースに接続する MCP ゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携、推奨、公開のいずれもされていません。

ツール

ツール	説明
historical_events	API Ninjas の歴史的出来事：世界史上の著名な出来事です。自由形式のキーワード、正確な日付（年／月／日）、またはその両方で絞り込めます。何が起きたかを示す { year, month, day, event } のリストを返します。例：historical_events({ year: 1969, month: 7, day: 20 }).
commodity_price	API Ninjas のリアルタイム商品価格：取引される商品の現在の取引所価格または先物契約価格（取引所、契約月、24 時間の変動）。「gold spot price」「silver price today」「lumber price」「live cattle」「heating oil futures」「RBOB gasoline futures」を調べる場合は、ウェブ検索よりこちらを優先してください。{ exchange, name, price, futures_contract, updated } を返します。API Ninjas は、無料プランで利用できる商品を毎週入れ替えるため、このツールでは対応商品一覧をあえて公開していません。一覧は数日で古くなるためです。金は安定して利用できます。それ以外は、ツールを呼び出してください。プランで利用できない名前を指定すると、ベンダーからリアルタイムに読み取った free_commodities_this_week を含む found:false が返ります。原油、天然ガス、農産物のベンチマークには、常に利用できる同等の系列を FRED で確認できます。name のエイリアスとして commodity または symbol を指定できます。例：commodity_price({ name: "gold" }).
inflation	API Ninjas のインフレ率：国別の最新の月次および年次インフレ率です。{ country, type, period, monthly_rate_pct, yearly_rate_pct } のリストを返します。国名と指数の種類（CPI または HICP）で任意に絞り込めます。例：inflation({ country: "United States", type: "CPI" }).
exercises	API Ninjas のエクササイズ：対象の筋肉、種類、難易度、名前で絞り込めるフィットネス／ジムのエクササイズです。{ name, type, muscle, equipment, difficulty, instructions } のリストを返します。例：exercises({ muscle: "biceps", difficulty: "beginner" }).
cars	API Ninjas の自動車情報：メーカー、モデル、年式、燃料の種類別の車両仕様です。{ make, model, year, fuel_type, cylinders, transmission, drive, city_mpg, highway_mpg, class } のリストを返します。例：cars({ make: "toyota", model: "camry", year: 2020 }).
animals	API Ninjas の動物情報：名前で指定した動物種の情報です。{ name, taxonomy, locations, diet, habitat, lifespan, top_speed } のリストを返します。例：animals({ name: "cheetah" }).

クイックスタート

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

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

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

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

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

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

最初の呼び出しにアカウントは必要ありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/historical_events を使います。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使います。

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

このパッケージはローカルの stdio MCP サーバーとしても動作します。Pipeworx アカウントも、ゲートウェイへのラウンドトリップも不要です。

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

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

npx -y @pipeworx/mcp-api-ninjas

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

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックエンドポイントでも、フルゲートウェイでも使えます。

ask_pipeworx({ question: "your question about Api Ninjas data" })

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

詳細

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

ライセンス

MIT