TokenOracle

このリポジトリはアーカイブされており、サービスは終了しています

TokenOracle MCP

Token Oracle は、エージェントがトークンを消費する前に LLM API のコストを見積もり、比較し、制御する Model Context Protocol（MCP）サーバーです。9 つのツール、4 つの読み取り専用リソース、cost_analysis_workflow プロンプトテンプレートを公開します。LLM を使用しない独自の価格設定アルゴリズムにより、決定論的な予算ワークフローを実現します。

従業員がゼロまたは 1 人の企業を支えるエージェント群で動作するよう設計された Token Oracle は、OpenClaw のエージェント群内で小さな CFO として機能し、支出を抑えながらプロンプトを改善する提案を行います。

トークンを節約しましょう。今すぐ Token Oracle を呼び出してください！

公開される MCP ツール：

• estimate_cost — 実行前に、単一の LLM API 呼び出しの USD コストを見積もります。入力：task_description、prompt_text、task_type、または明示的な token_count。出力：cost_usd、recommended_model、confidence、will_fit_context、pricing_updated。アノテーション：readOnlyHint:true、idempotentHint:true、openWorldHint:false。
• estimate_cost_batch — 1 回の呼び出しで最大 100 件の LLM タスクの料金を算出します。タスクごとの内訳、total_cost_usd、cheapest_model_for_all を返します。複数ステップのパイプラインを開始する前に使用してください。
• compare_models — 指定したタスクについて、サポートされているすべてのプロバイダーの LLM 料金を順位付けします。speed_tier と quality_tier を含め、モデルをコスト順に返します。min_quality、max_cost_usd、provider によるフィルタリングに対応しています。入力：task_type、token_count、または prompt_text。
• budget_check — 計画中のタスクが月間予算内に収まるか確認します。can_proceed（ブール値）、remaining_budget_usd、budget_consumed_pct、節約率（savings_pct）付きのより安価な選択肢を返します。入力：monthly_budget_usd、current_spend_usd、タスクの説明。
• find_cheapest_for_budget — budget_check の逆です。budget_usd の上限とタスクを指定すると、予算内で最適なモデルと品質の組み合わせに加え、品質、次にコストの順で順位付けしたすべての選択肢を返します。

公開される MCP リソース：

• token-oracle://meta — サーバーの機能を機械可読形式で記述したドキュメント（バージョン、モデル数、価格メタデータ）
• token-oracle://models — 検出と検証に使う、メタデータ付きのモデル ID
• token-oracle://heuristics — タスク種別ごとのトークン推定値とキーワード分類パターン（監査可能）
• token-oracle://pricing/changelog — 価格変更の追記専用ログ。価格の変更を時系列で検出するために使用します

公開される MCP プロンプト：

• cost_analysis_workflow — 3 ステップでガイドするプロンプトテンプレート：estimate_cost → compare_models → budget_check。引数：task_description、monthly_budget_usd（省略可）、quality_threshold（省略可）。

サポート対象プロバイダー： Anthropic、OpenAI、Google、Groq、Together AI、Mistral、DeepSeek、Cohere（100 以上のモデル）。

標準的なエージェントワークフローの例： 目標：商品説明の生成タスクを 500 件実行する。予算は月額 50 ドル、現在の支出は 43 ドル。

1. estimate_cost_batch({ tasks: [{ task_type: "generate", token_count: { input: 200, output: 800 }, quantity: 500 }] }) → total_cost_usd: $0.60
2. compare_models({ token_count: { input: 200, output: 800 }, task_type: "generate", min_quality: "med", max_cost_usd: 0.002 }) → deepseek-v3 は 1 タスクあたり $0.00035（合計 $0.175）— 71% 安く、品質ティアは同じ
3. budget_check({ monthly_budget_usd: 50, current_spend_usd: 43, token_count: { input: 200, output: 800 }, model: "deepseek-v3" }) → can_proceed: true、残額：$6.825、予算消費率：2.4% 判断：deepseek-v3 を使用します。gpt-4o-mini と比べて $0.425 節約できます。

料金：

• 無料：1 日あたり 1000 回の API 呼び出し、リモートエンドポイント経由のホスト型ツールすべて、クレジットカード不要
• Pro（月額 $29）：呼び出し無制限、track_spend ツール（API キーごとにコスト台帳を永続化）、優先スループット、エージェント／タスク／セッションごとの支出の帰属

お問い合わせ先： [email protected]

ホスト型エンドポイント

• 正規のリモート MCP URL：https://mcp.guffeyholdings.com/TokenOracle
• 正規の MCP 名：com.guffeyholdings/token-oracle

リモートへの直接設定：

{
  "mcpServers": {
    "token-oracle": {
      "type": "streamable-http",
      "url": "https://mcp.guffeyholdings.com/TokenOracle",
      "headers": {
        "X-API-Key": "${TOKEN_ORACLE_API_KEY}"
      }
    }
  }
}

npm ブリッジパッケージ

npm でインストールした stdio サーバーを引き続き必要とするローカルクライアントには、token-oracle-mcp を使用してください。

入力不要のトライアルフロー：

API キーを指定せずにブリッジを起動すると、ホステッドサービスでトライアル認証が有効な場合、初回起動時に従量制トライアル認証情報を自動的に取得して保存します。

{
  "mcpServers": {
    "token-oracle": {
      "command": "npx",
      "args": ["-y", "token-oracle-mcp"]
    }
  }
}

初回のみの明示的なログインフロー：

npx -y token-oracle-mcp login

--api-key を指定すると、有料のホステッド API キーを検証して保存します。--api-key を指定しない場合は、ホステッドトライアル認証情報をリクエストして保存します。どちらのフローでも、以降は MCP 設定で TOKEN_ORACLE_API_KEY を注入する必要はありません。

{
  "mcpServers": {
    "token-oracle": {
      "command": "npx",
      "args": ["-y", "token-oracle-mcp"]
    }
  }
}

ステートレスなセットアップを希望する場合は、引き続き TOKEN_ORACLE_API_KEY を環境変数として渡してください。

ホステッドトライアルの動作：

• トライアル認証情報は従量制で、サーバー側で上限が設定されています
• ホステッドトライアルのリクエスト上限に達すると、サービスはアップグレードが必要であることを示すレスポンスを返します
• ホステッドサービスは、同じ申請者に対して有効なトライアル認証情報が残っている場合、毎回新しいトークンを発行するのではなく、同じ認証情報を再利用します
• トライアルの発行には別途レート制限があり、サーバー側の不正利用リスクスコアリングによってブロックされることがあります
• 後日、ホステッドアップグレードフローで、MCP 設定を変更せずに保存済みのトライアル認証情報を有料認証情報に置き換えられます

オプションのブリッジ環境変数：

• TOKEN_ORACLE_API_KEY：オプションのホステッド API キー。保存済みの認証情報より優先されます
• TOKEN_ORACLE_BASE_URL：リモートエンドポイントの上書き。デフォルトは https://mcp.guffeyholdings.com/TokenOracle です
• TOKEN_ORACLE_SUBJECT：X-Token-Oracle-Subject として転送される、オプションのエンドユーザーサブジェクト

追加のブリッジコマンド：

• npx -y token-oracle-mcp login：有料認証の場合は --api-key を指定します。キーを指定しない場合は、ホステッドトライアル認証情報を取得します
• npx -y token-oracle-mcp logout：ローカルに保存された認証情報を削除します

機能

ツール：

• estimate_cost
• estimate_cost_batch
• compare_models
• budget_check
• find_cheapest_for_budget
• get_budget_status
• list_request_activity
• get_usage_summary
• get_usage_leaderboard

リソース：

• token-oracle://meta
• token-oracle://models
• token-oracle://heuristics
• token-oracle://pricing/changelog

プロンプト：

• cost_analysis_workflow

バージョン

• ホステッドサービスのバージョン：1.0.6
• ブリッジパッケージのバージョン：1.0.6