Rhumb

Rhumb MCP Server

Model Context Protocol 向けのエージェントネイティブなツールインテリジェンス。

3 つの実行レイヤーを備えています。プロバイダーへの直接アクセス（Layer 1）、インテリジェントなルーティング（Layer 2）、決定論的な組み合わせレシピ（Layer 3、公開カタログを正確に提示するベータ版）です。すべてのプロバイダーを AN Score で評価します。すべての実行で、チェーンハッシュ付きのレシートが生成されます。

• Web サイト：https://rhumb.dev
• ドキュメント：https://rhumb.dev/blog/getting-started-mcp
• 料金：https://rhumb.dev/pricing
• リポジトリ：https://github.com/supertrained/rhumb

設定不要のクイックスタート

検出に認証済み API キーは必要ありません。 インストールして、すぐに開始できます。

npx -y --package rhumb-mcp@latest rhumb-mcp

または、Claude Desktop／Cursor／任意の MCP クライアントに追加します。

{
  "mcpServers": {
    "rhumb": {
      "command": "npx",
      "args": ["-y", "--package", "rhumb-mcp@latest", "rhumb-mcp"]
    }
  }
}

エージェントに次のように尋ねます。

• 「エージェントに最適なメール API を探して」
• 「Stripe の AN Score は？」
• 「Rhumb のレシピが公開されているか確認して」

現在呼び出し可能な範囲

Rhumb が現在特に得意としているのは、調査、抽出、生成、限定的な情報拡充です。

現時点では、汎用的なビジネスエージェントの自動化レイヤーではなく、まずは機能インフラとして捉えてください。現在、Layer 2 が実際の本番利用向けインターフェースです。Layer 3 は、意図的に公開カタログを絞ったベータ版です。

検出できる範囲は、現在実行できる範囲より広くなっています。Rhumb は999 件のサービスを評価し、435 件の機能定義を公開していますが、現在の認証済み実行は 28 件の呼び出し可能なプロバイダーに集中しています。

解決時の基本モデル

• サービス＝Rhumb が評価・比較するベンダー
• 機能＝MCP クライアントがルーティングして実行できるアクション
• レシピ＝機能を基にした決定論的な複数ステップのワークフロー（ベータ版、公開カタログは限定的）
• デフォルトの経路は Layer 2 — 検出 → 解決 → 見積もり → 実行
• 繰り返し利用する場合のデフォルト認証＝認証済み API キー、または X-Rhumb-Key へのウォレット事前入金
• プロバイダーを自分で管理することが目的の場合に限り、BYOK または Agent Vault を使用してください
• 登録不要で呼び出しごとに支払うことが目的の場合に限り、x402 を使用してください

正規のオンボーディングガイド：https://rhumb.dev/docs#resolve-mental-model

v2.0.0 の新機能

Rhumb Resolve — 3 つの実行レイヤー：

レイヤー	内容	方法
Layer 1	プロバイダーへの直接アクセス	プロバイダーを選択します。代替手段であり、信頼の基点です。
Layer 2	機能ルーティング	AN Score、可用性／サーキットの状態、推定コスト、レイテンシの推定値、認証情報のモード、明示的なポリシー制約を用いて、呼び出しに最適な対応プロバイダーへ Rhumb がルーティングします。
Layer 3	決定論的なレシピ（ベータ版）	コンパイル済み DAG ワークフローです。複数ステップに対応し、予算を適用し、コンテンツをファイアウォールで保護します。公開済みのレシピはまだありません。

新しいインフラ：

• 実行レシート（チェーンハッシュ付き、HMAC 署名済み）
• ルートの説明（プロバイダーが選ばれた理由）
• AN Score の構造的分離（読み取り専用キャッシュ、監査可能）
• 請求イベントストリーム（チェーンハッシュ付き、15 種類以上のイベントタイプ）
• 可用性、コスト、信頼性の実測値を示すトラストダッシュボード用入力データ
• レシピの安全制御（コンテンツファイアウォール、冪等性、ネストの深さ、ファンアウトのレート制限）
• キルスイッチ（エージェントごと、プロバイダーごと、レシピごと、およびグローバル。認証済みの二者認証を使用）
• 監査証跡（追記専用、チェーンハッシュ検証、エクスポート API）

0.x からの移行

• v1 のすべてのエンドポイントは完全な後方互換性を維持します。破壊的変更はありません
• v2 の新しいエンドポイントは v1 と並行して利用できます
• execute_capability は、アトリビューションとレシートを含む _rhumb_v2 メタデータを返すようになりました
• レシピカタログの確認、レシート、テレメトリー用の新しいツール
• 更新コマンド：npx -y --package rhumb-mcp@latest rhumb-mcp

検索ツール（認証不要、6 件）

ツール	機能
find_services	必要な機能を指定して、インデックス化されたサービスを検索します
get_score	サービスの AN スコアの詳細な内訳を取得します。実行品質、アクセス準備状況、自律性レベル、ティアラベル、新しさが含まれます
get_alternatives	AN スコア順に代替サービスを検索します
get_failure_modes	サービスで確認されている障害パターン、影響の重大度、回避策を取得します
discover_capabilities	ドメイン別または検索テキストでケイパビリティを閲覧します
resolve_capability	ケイパビリティ ID と、必要に応じて認証情報モードを指定すると、ヘルスステータス、呼び出しごとのコスト、認証方式、エンドポイントのパターン、実行ガイダンス、recovery_hint.resolve_url、recovery_hint.credential_modes_url、該当する場合は recovery_hint.alternate_execute_hint や recovery_hint.setup_handoff などの機械可読な復旧フィールドを含む、ランク付けされたプロバイダーを返します。また、ケイパビリティ ID が誤っている場合の入力ミスからの復旧情報も返します

実行ツール（認証が必要、8 件）

{
  "mcpServers": {
    "rhumb": {
      "command": "npx",
      "args": ["-y", "rhumb-mcp@latest"],
      "env": {
        "RHUMB_API_KEY": "rk_your_key_here"
      }
    }
  }
}

https://rhumb.dev/auth/login からガバナンス対象の API キーを取得します（GitHub、Google、またはメール。30 秒で完了します）。

ツール	機能
execute_capability	Rhumb Resolve を通じてケイパビリティを呼び出します
estimate_capability	ケイパビリティを呼び出す前に、アクティブな実行経路、コスト、ヘルスを見積もります。匿名の直接的なシステム・オブ・レコード経路でも、機械可読な execute_readiness の引き継ぎ情報が保持されます
credential_ceremony	サービスの API 認証情報を取得するための手順を確認します
check_credentials	全体、または特定のケイパビリティについて、認証情報モードの現在の準備状況を確認します
rhumb_list_recipes	現在公開されている Rhumb Layer 3 レシピカタログを一覧表示します
rhumb_get_recipe	入力／出力スキーマやステップのトポロジーなど、Rhumb レシピの公開定義全体を取得します
rhumb_recipe_execute	公開カタログで利用可能になった Rhumb Layer 3 レシピを実行します
get_receipt	ID で実行レシートを取得します

金融ツール（認証が必要、5 件）

ツール	機能
budget	呼び出しの支出上限を確認または設定します
spend	請求期間の支出内訳を取得します。合計支出額（USD）、呼び出し回数、呼び出しごとの平均コストを、ケイパビリティ別およびプロバイダー別に確認できます
check_balance	現在の Rhumb クレジット残高を USD で確認します
get_payment_url	Rhumb 残高にクレジットを追加するための決済 URL を取得します
get_ledger	請求履歴を確認します。請求（引き落とし）、チャージ（入金）、自動リロードのイベントが含まれます

運用ツール（認証が必要、2 件）

ツール	機能
routing	execute_capability でプロバイダーを指定しない場合に、Rhumb がプロバイダーを自動選択する方法を取得または設定します
usage_telemetry	Rhumb の利用状況に関する実行分析情報を取得します。呼び出し、レイテンシー、エラー、コスト、プロバイダーのヘルスが含まれます

21 個の MCP ツール

検索（無料）： find_services、get_score、get_alternatives、get_failure_modes、discover_capabilities、resolve_capability

実行（認証が必要）： execute_capability、estimate_capability、credential_ceremony、check_credentials、rhumb_list_recipes、rhumb_get_recipe、rhumb_recipe_execute、get_receipt

金融（認証が必要）： budget、spend、check_balance、get_payment_url、get_ledger

運用（認証が必要）： routing、usage_telemetry

検索対象はスコア付きの 999 サービスに及びますが、現在ガバナンス対象の実行で呼び出せるプロバイダーは 28 件です。

現時点で最も適しているのは、リサーチ、抽出、生成、限定的な情報補完です。汎用ビジネスエージェントの自動化は将来の対象として扱い、現時点で呼び出せる機能として約束されているものとは見なさないでください。

一般的なワークフロー

1) ツールを検索する（認証不要）

「エージェント向けのメールプロバイダーが必要です。」

• find_services → サービス全体を検索します
• get_score → 特定のプロバイダーを詳しく確認します
• get_failure_modes → 実際の利用で問題が起きる箇所を確認します

2) 機能をルーティングする（認証不要）

「email.send が必要です。何を使えばよいですか？」

• discover_capabilities → 機能 ID を見つけます
• resolve_capability → 優先順位付けされたプロバイダー、任意の認証情報モードによるフィルタリング、recovery_hint.resolve_url、recovery_hint.credential_modes_url などの機械可読な復旧フィールド、および該当する場合は recovery_hint.alternate_execute_hint または recovery_hint.setup_handoff を取得します。また、機能 ID が間違っている場合は検索候補を取得します

3) 準備状況を確認する（認証が必要）

「今すぐ deployment.list を呼び出せますか？また、どのレールを使いますか？」

• check_credentials → アカウント全体の BYOK／直接バンドルの準備状況を確認するには、パラメーターなしで呼び出します。プロバイダー単位のモード状況と認証手順の利用可否を調べるには、機能を渡します

4) 実行する（認証が必要）

「品質の下限を満たすプロバイダーのうち、最も安価なものを使ってメールを送信してください。」

• estimate_capability → 実行前に、現在の実行レール、健全性、コストを確認します
• execute_capability → アクションを実行します
• get_receipt → HMAC 署名付きの実行記録を検証します

5) レシピの利用可否を確認する／レシピを実行する（認証が必要）

「このための公開済み Rhumb ワークフローはありますか？」

• rhumb_list_recipes → 公開カタログで現在実際に利用できるものを確認します
• rhumb_get_recipe → カタログに表示された後でのみ、レシピを調べます
• rhumb_recipe_execute → 公開後にコンパイル済みレシピを実行します
• 公開情報：Layer 3 カタログは現在、登録内容がほとんどないか空の状態です。そのため、現時点ではほとんどの実作業で Layer 2 の機能を使用してください

x402 マイクロペイメント

アカウントは不要です。Base 上で USDC を使って、呼び出しごとに支払います。

{
  "env": {
    "RHUMB_X402_WALLET_ADDRESS": "0x...",
    "RHUMB_X402_PRIVATE_KEY": "0x..."
  }
}

ローカル開発

cd packages/mcp
npm ci
npm run dev

テストとビルド

npm test          # 84+ tests
npm run type-check
npm run build

関連情報

• API：https://api.rhumb.dev/v1（v1 互換）／https://api.rhumb.dev/v2（Resolve v2）
• npm：https://www.npmjs.com/package/rhumb-mcp
• MCP Registry：https://registry.modelcontextprotocol.io（「rhumb」を検索）
• GitHub：https://github.com/supertrained/rhumb

ライセンス

MIT