AI Price Index

ai-price-index-mcp

RoninForge ai-price-index-mcp は、ある日付時点での AI モデルの API 料金と、それを裏付ける公式ソースを回答する、読み取り専用の Model Context Protocol サーバーです。MIT ライセンスで提供され、すべてお使いのマシン上で動作し、API キーは必要ありません。

RoninForge.org の一部である本プロジェクトは、AI 開発者向けツールの経済状況を、日付付きで再現可能な記録として残す独立したオープンソースのワークショップです。オープンな AI Price Index データセットを、Claude Code や Cursor を含むあらゆる MCP クライアントに提供します。

多くの料金ツールがエージェントに伝えるのは、モデルの今日の料金です。このツールは、ある日付時点での料金も回答し、公式ソースの URL と、その料金が最後に検証された日付も返すため、エージェントは数値を引用できます。この時点指定の検索が、本ツールの特長です。

• キー不要、プロンプト不要、実行時のネットワーク通信なし。 日付付きデータセットは ai-price-index 依存関係にインラインで同梱されています。サーバーはデータをローカルで読み取るため、通信量は増えません。
• 読み取り専用。 料金を検索するだけです。書き込みや設定、外部への通信はできません。
• 引用可能。 すべての結果に source_url、last_validated、confidence、および CC BY 4.0 の帰属表示文字列が含まれます。

インストール

Node.js 18 以降が必要です。ビルド手順も API キーも不要です。

npx -y ai-price-index-mcp

このコマンドは stdio サーバーを起動します。MCP クライアントは、以下の設定を使ってサーバーを起動します。

クライアントの設定

以下を MCP クライアントの設定に追加してください。サーバーは stdio で通信します。

Claude Code（~/.claude.json またはプロジェクトの .mcp.json）と Cursor（~/.cursor/mcp.json）は、同じ mcpServers 形式を使用します。

{
  "mcpServers": {
    "ai-price-index": {
      "command": "npx",
      "args": ["-y", "ai-price-index-mcp"]
    }
  }
}

または、Claude Code の CLI を使います。

claude mcp add ai-price-index -- npx -y ai-price-index-mcp

ツール

すべてのツールは、テキストコンテンツとして構造化 JSON を返します。料金は usd_per_mtok（100 万トークンあたりの USD）です。モデル ID はデータセットのエイリアスを通じて解決されるため、短い ID も使用できます（例：claude-opus-4-5 は claude-opus-4-5-20251101 に解決されます）。

ツール	引数	戻り値
current_price	model、provider?	モデルの今日の入力／出力料金と、そのソース。
price_on	model、date（YYYY-MM-DD）、provider?	その日付時点で適用されていた料金（時点指定の検索）。
compare	models[]、date?	指定した日付における複数モデルの入力／出力料金を並べて表示します。
cost_from_usage	model、tokens、date?、provider?	キャッシュ倍率を適用した、ある時点でのトークン集計の USD 換算額。
list_models	provider?	既知のモデル ID（プロバイダーを 1 つ指定することもできます）と、それぞれのエイリアス。

cost_from_usage の tokens は input、output、cache_read、cache_write_5m、cache_write_1h を受け付けます（すべて省略可能で、省略した場合は 0 として扱われます）。キャッシュ読み取りは入力の 0.1 倍、キャッシュ書き込みは 1.25 倍（5 分）または 2 倍（1 時間）です。

複数のベンダーで同じ ID が使われている場合は、provider（例：openai、anthropic、google）を指定して、ベンダーを特定してください。

結果の例

{ "model": "gpt-4", "date": "2024-01-01" } を指定した price_on の結果：

{
  "query": "gpt-4",
  "provider": "openai",
  "model": "gpt-4",
  "date": "2024-01-01",
  "covered": true,
  "input": {
    "usd_per_mtok": 30,
    "unit": "usd_per_mtok",
    "effective_from": "2023-03-14",
    "effective_to": null,
    "last_validated": "2023-04-15",
    "confidence": "archived",
    "source_url": "https://web.archive.org/web/20230415223802/https://openai.com/pricing"
  },
  "output": { "usd_per_mtok": 60, "...": "..." },
  "provenance": {
    "dataset": "AI Price Index by RoninForge",
    "data_version": "2026-06-17",
    "license": "CC-BY-4.0",
    "attribution": "AI Price Index by RoninForge (https://roninforge.org/data/ai-price-index/), CC BY 4.0",
    "source": "https://roninforge.org/data/ai-price-index/"
  }
}

仕組み

このサーバーは、日付付きデータセットをインラインで同梱する npm ライブラリ ai-price-index を薄くラップしたものです。料金計算ロジックも、独立したデータレイヤーも、ネットワーク呼び出しもありません。結果に表示されるデータバージョンは、インストール済みの ai-price-index が固定しているデータセットのリリースです。新しい料金を利用するには、この依存関係を更新してください。

データライセンスと帰属表示

料金データは AI Price Index に由来し、CC BY 4.0 ライセンスで提供されています。このデータに基づくものを公開する際は、以下のように帰属を表示してください。

RoninForge による AI Price Index（https://roninforge.org/data/ai-price-index/）、CC BY 4.0。

このサーバーのコードは MIT ライセンスで提供されています（LICENSE を参照）。データとツールのライセンスは、上流の ai-price-index リポジトリで管理されています。

Links

• Data page: https://roninforge.org/data/ai-price-index/
• Library: https://www.npmjs.com/package/ai-price-index
• Dataset repo: https://github.com/RoninForge/ai-price-index
• DOI: https://doi.org/10.5281/zenodo.20730241