OneSource MCP

@one-source/mcp

OneSource 向けの統合 MCP サーバーです。ブロックチェーンデータ、ライブチェーンクエリ、Deepstate の市場データ、The Standard Reserve、REST API ドキュメント用の 91 個のツールを、単一のサーバーで提供します。

MCP とは？ Model Context Protocol を使うと、AI アシスタントからツールを呼び出し、データソースにアクセスできます。このサーバーは、OneSource のブロックチェーン API とそのドキュメントの両方をツールとして公開します。

クイックスタート

Claude Code

claude mcp add onesource -- npx -y @one-source/mcp@latest

Claude Desktop / Cursor

MCP 設定に追加します。

{
  "mcpServers": {
    "onesource": {
      "command": "npx",
      "args": ["-y", "@one-source/mcp@latest"]
    }
  }
}

任意の MCP クライアント（stdio）

npx -y @one-source/mcp@latest

HTTP サーバー（セルフホスト）

npx -y @one-source/mcp@latest --http
npx -y @one-source/mcp@latest --http --port=8080

次に、MCP クライアントを http://localhost:3000/（または --port に指定した値。たとえば、上の 2 つ目の例では 8080）に接続します。

ヘルスチェック：GET http://localhost:3000/health（ポートは適宜置き換えてください）。

ツール（97）

ブロックチェーン API — ライブチェーン（12 個のツール）

ツール	説明
1s_allowance_live	ERC20 の使用許可を確認
1s_contract_info_live	ERC165 によるコントラクトタイプの検出
1s_erc1155_balance_live	RPC による ERC1155 残高の取得
1s_erc20_balance_live	balanceOf による ERC20 残高の取得
1s_erc20_transfers_live	eth_getLogs による ERC20 Transfer ログの取得
1s_erc721_tokens_live	ERC721 トークンの列挙
1s_events_live	eth_getLogs によるイベントログの取得
1s_multi_balance_live	ETH と複数の ERC20 残高の取得
1s_nft_metadata_live	tokenURI による NFT メタデータの取得
1s_nft_owner_live	ownerOf による NFT 所有者の取得
1s_total_supply_live	トークンの総供給量
1s_tx_details_live	RPC によるトランザクションとレシートの取得

ブロックチェーン API — チェーンユーティリティ（13 個のツール）

RPC のみ。

ツール	説明
1s_block_by_number	RPC によるブロック番号指定でのブロック詳細の取得
1s_block_number	最新のブロック番号
1s_chain_id	EIP-155 チェーン ID
1s_contract_code	コントラクトのバイトコード
1s_ens_resolve	ENS 名またはアドレスの解決
1s_estimate_gas	ガスの見積もり
1s_network_info	チェーン ID、ブロック番号、ガス価格
1s_nonce	トランザクション数
1s_pending_block	メンプールからの保留中ブロック
1s_proxy_detect	プロキシコントラクトの検出
1s_simulate_call	eth_call のシミュレーション
1s_storage_read	ストレージスロットの読み取り
1s_tx_receipt	トランザクションレシート

決済（2 個のツール）

ツール	説明
1s_payment_mode	4 つのモードすべてにおける決済レールとスキームの表示または切り替え：x402-exact / x402-batch（Base 上の USDC）および mpp-charge / mpp-session（Tempo 上の USDC.e / pathUSD）。batch と session は、多数の呼び出しに使えるチャネルを開きます。
1s_refund	開いている決済チャネルの未使用デポジットを必要に応じて払い戻します。x402 の batch チャネル（Base）と MPP の session バウチャーチャネル（Tempo）の両方に対応しています。

Deepstate マーケットデータ（10 個のツール）

Deepstate は、Robinhood Chain（チェーン 4663）上のオンチェーン注文板プロトコルです。これらのツールでは、マーケットデータ（注文板、取引、ローソク足、統計、メイカー分析、ガス／厚み分析）を読み取れます。同じ API 上の通常のツールであり、network パラメーターは不要です。常に Robinhood Chain を使用し、ほかのすべてのツールと同様に、API キー、x402、または MPP で有料利用できます。DGP-3 への移行（2026-09-22）以降、メイカー報酬は単一の固定トークンではなく、マーケットごとに設定されています。DEEP と決めつけず、必ず 1s_ds_markets でマーケットの reward_token を確認してください。

ツール	説明
1s_ds_markets	この API が提供する Deepstate マーケット（注文板）を一覧表示します。各マーケットのスラッグ、トークン構成、プール／ルーターのアドレス、status、reward_token を含みます
1s_ds_book	マーケットの注文板スナップショットです。買い注文は価格の高い順、売り注文は価格の低い順に並び、各価格レベルの未約定数量を含みます
1s_ds_trades	マーケットの取引履歴です。新しい順に、各約定の価格、数量、売買区分、ブロックを表示します
1s_ds_candles	指定した時間足でのマーケットの OHLCV ローソク足です
1s_ds_stats	マーケットの直近 24 時間／7 日間／30 日間の出来高と価格変動、および最新の取引価格です
1s_ds_makers	マーケットごとのメイカー分析です。最良気配にいた時間、未約定注文の名目価値、約定数／約定率、獲得したメイカー報酬を表示します（報酬トークンはマーケットごとに異なります。1s_ds_markets の reward_token を参照してください）
1s_ds_cost_to_quote	マーケットで注文を維持およびキャンセルするために費やしたガスを、期間ごとに集計します
1s_ds_depth_history	マーケットの厚みヒートマップです。時間ごとの価格レベル別の未約定注文数量を表示します
1s_ds_token_2deep	2DEEP の供給量、上限、流通量、報酬プールと基金の残高、移行債務、プール価格をチェーンからリアルタイムで取得します
1s_ds_migration	DGP-3（2026-09-22）以降の DEEP／STATE から 2DEEP への償還状況です。合計、件数、残量、日次データを表示します

1s_ds_markets を除くすべての Deepstate ツールには book パラメーターが必要です。値には、マーケットの正規の大文字スラッグ（例：NVDA-USDG）または 32 バイトの book_id を指定します。まず 1s_ds_markets を呼び出して、全マーケットの一覧を取得してください。

The Standard Reserve（49 個のツール）

The Standard Reserve は、Robinhood Chain（チェーン ID 4663）上のオンチェーン中央銀行プロトコルです。これらのツールでは、OneSource がインデックス化して提供するデプロイ済みコントラクトの状態を読み取れます。すべてのレスポンスに basis、as_of_block、serving_state が含まれます。1s_std_addresses と 1s_std_genesis_live は無料です。それ以外のツールはすべて、この API のほかのツールと同じく、API キー、x402、または MPP で有料利用できます。複数のツール（1s_std_supply、_vaults、_pool、_exit_pressure、_backing、_policy_current）では atBlock パラメーターも使用でき、最新の状態ではなく、指定した過去のブロック時点の状態を読み取れます。

ツール	説明
1s_std_addresses	検証済みのTSRコントラクトとプールのレジストリです。各エントリーに検証ステータスが付いています。無料で、支払いは不要です。
1s_std_auction_days	ライセンスまたはチャーターのオークションの日ごとの履歴です。開始価格／最低価格／終了価格、販売数と出品数、完売までの時間を確認できます。ライセンスの日には購入数、異なるチャーター数、平均支払額と総支払額、取引ごとの購入数の内訳も含まれます
1s_std_auction_sales	ライセンスまたはチャーターのオークションの最近の販売履歴を新しい順に表示します。購入者、単価、数量、ブロックを確認できます。種類で絞り込み、before/limitでページ分割できます
1s_std_auctions_current	日次ライセンスオークションとチャーターオークションの現在の状態です。価格、最低価格、本日の販売数／残数、フェーズ、最終販売を確認できます
1s_std_backing	準備金による裏付け情報です。VaultのETH残高、準備資産の保有額、VaultのUniswap v4ポジション、およびSTANDARDあたりのETH裏付けを3種類で確認できます。VaultのETHのみ、プロトコル所有の流動性を加えた場合、準備金独自のプール価格（USDGは$1）で全準備資産を加えた場合です。現在、履歴、または過去のブロック時点を指定できます
1s_std_branch_auction_live	Branchライセンスオークションの最新ブロック時点の状態です。フェーズ、価格、本日の販売数／残数、最近の販売速度を確認できます
1s_std_branches_doi	Branchライセンスオークションの発行日数と、今すぐ購入する場合と待つ場合の比較表です
1s_std_branches_summary	TSRの稼働中Branch全体の概要です。数、Branchあたりの1日の発行数、発行日数で表したライセンス価格を確認できます
1s_std_buyback_readiness	縮小Vaultの買い戻しティック実行準備状況です。このティックのETH処理能力、制約要因、クールダウン、TWAP乖離、最近実行されたティックを確認できます
1s_std_candles	ETH/STANDARDプールのOHLC価格ローソク足を、STANDARDあたりのETHで表示します。スワップ数と出来高も含まれます。ローソク足の幅（1m〜1d）はtfで、期間はfrom/toで指定します
1s_std_charter	IDで指定した1つのチャーター、または所有者で絞り込んだチャーターです。保有者、Branch数、ミント種別、未払いの生産量、Branch履歴、一度限りのチャータースティミュラスの割当分（応答で返される期限までチャーター所有者が請求可能）、各ローンチパッドのチャータードロップの割当分を確認できます
1s_std_decision_branch	複合情報：今すぐBranch／ライセンスを購入すべきかどうかを判断します。発行日数、ライセンス費用とチャーターオークションの比較、最近のオークション履歴、ポリシーの見通し、保留中のガバナンス変更、過去のローンチパッドのチャータードロップでBranchが得たもの（予測ではなく履歴）をまとめます
1s_std_decision_bid	複合情報：指定した最高価格でのライセンスオークションの指値がいつ成立するか、その前にいくつの入札とライセンスがあるか、さらにcharter_idを指定した場合、そのチャーターの保留中STANDARDと上限で入札を賄えるかを示します。約定は別途トランザクションを誰でも送信できます。応答にはその旨と計測された約定履歴が記載されます。max_unit_priceを指定し、countとcharter_idは任意です
1s_std_decision_charter	複合情報：今すぐ新しいチャーターを購入すべきかどうかを判断します。チャーターオークションの状態、最安のライセンス取得方法、発行日数、裏付け比率、保有者の集中度、過去のローンチパッドのチャータードロップでBranchが得たもの（予測ではなく履歴）をまとめます
1s_std_decision_exit	複合情報：今すぐチャーターのBranchを退出すべきかどうかを判断します。退出見積もり、手数料曲線、手数料予測、税スケジュール、プールの状態、ポリシーの見通し、保留中のガバナンス変更、全額退出で失われる未請求のスティミュラス、クローズ時に解放されるチャータードロップをまとめ、noteOwnerに関する警告も含みます
1s_std_decision_hold	複合情報：STANDARDを保有し続けるべきかどうかを判断します。ポリシーの見通し、発行残存期間、保留中のガバナンス変更、税スケジュール、買い戻しの準備状況、休眠状態をまとめます。引数は不要です
1s_std_decision_plan	期間を指定して、Branch購入戦略（維持、選択的、積極的）の3種類をシミュレーションします。上書きしない限り、現在の価格、発行量、ライセンス費用を初期値に使用します。チャーターIDを指定すると、ローンチパッドのドロップ割当分が各戦略の横に表示され、ETHの結果には含まれません。計画用ツールであり、予測ではありません。勝利する戦略を示すことはありません
1s_std_decision_sbill	複合情報：このS-Billをどうすべきかを示します。満期前は、今すぐ退出した場合の受取額、放棄するプレミアム、および誰も退出しない場合の今後各日の退出手数料（算出値）を示します。満期後は、償還額とロールで固定される内容（算出値）、自動ロールがない旨を示します。bill_idを指定します
1s_std_decision_stake	複合情報：今すぐこのSTANDARDをS-Billにステーキングすべきか、待つべきかを判断します。S-Billの見積もり、ウォレットに対する上限の確認、預け入れ直後の退出手数料、他の預け入れがない場合の1時間／6時間／24時間のレート（算出値）をまとめます。amountを指定し、walletは任意です
1s_std_dormancy	報告対象となる休眠期間を過ぎたウォレット、または追跡対象の全ウォレット一覧
1s_std_dormancy_bounties	休眠バウンティボードです。報告対象期間をすでに過ぎたウォレットを、推定バウンティ額の高い順に表示します
1s_std_epochs	TSRのエポック履歴です。エポックごとの純フロー、シグナル、レジーム、乗数、発行量を確認できます。before/limitでページ分割できます
1s_std_events	デコード済みのプロトコルイベントをそのまま返します。contract_label、event_name、アドレス、token_id、epoch、またはブロック／ログカーソルで任意に絞り込み、before/limitでページ分割できます
1s_std_exit_fee_curve	引き出し額に応じた退出手数料の変化です。現在の手数料率と、総引き出し額の1／5／10／25／50／100%に対する段階別の手数料を確認できます
1s_std_exit_fee_forecast	これ以上引き出しがない場合の現在のペースに基づく退出手数料の推移を日ごとに予測します。手数料が下限に達するまでの日数と、記録された各引き出し日の影響が手数料の計算期間から外れる正確な時刻も確認できます
1s_std_exit_pressure	退出圧力の指標と、それに応じた精算手数料率です。現在、履歴、または過去のブロック時点を指定できます
1s_std_exit_quote	チャーターの稼働中Branchを終了する場合の按分退出見積もりと、指定したブロック時点で実現可能なETHの推定額です
1s_std_flow_charters	各スワップ発生時にチャーターを保有していたウォレットごとにまとめたETH/STANDARDプールの購入と売却です。結果の対象期間はhoursとlimitで指定します
1s_std_flow_hourly	ETH/STANDARDプールへの流入・流出を、スワップ数とともに時間単位で表示します。遡る時間数はhoursで指定します
1s_std_genesis_live	ジェネシスDutchミントの最新ブロック時点の統計情報です。フェーズ、ミント済み数量、残数、価格、販売速度を確認できます。無料です。
1s_std_governance_changes	TSRが追跡する15のコントラクト全体にわたるガバナンス／パラメーター変更履歴、現在キューに入っている変更、スイッチの状態、ガーディアンの一時停止状態です
1s_std_holders_concentration	チャーター／Branchの所有集中度です。チャーターごとの分布、上位所有者、HHI（ハーフィンダール・ハーシュマン指数）スコア、ジェネシスとオークションのコホート分布を確認できます
1s_std_issuance_runway	中央銀行の発行予算に対するSTANDARD累積発行量、現在のストリームレート、現状が続いた場合に予算が尽きる時期の予測です
1s_std_license_bids	1ブロック時点で読み取ったライセンスオークションのすべての指値です。入札者、数量、最高単価、コントラクトが約定可能か、各入札を妨げる要因、古い入札または削除可能な入札のフラグ、算出された実効交差価格を確認できます。チャーター、入札者、約定可能かどうかで絞り込み、並べ替えられます
1s_std_license_cost	現時点でのBranchライセンスのETH価格と、同じ結果を得るためにチャーターオークションを利用する方が安価かどうかを示します
1s_std_license_headroom	チャーターが今日さらに購入できるBranchライセンス数と、リアルタイムの単位ごとの価格見積もり一覧です
1s_std_policy_current	現在のエポックの金融政策です。レジーム、乗数、純フロー、2エポックのシグナルを確認できます。現在、または過去のブロック時点を指定できます
1s_std_policy_outlook	現在のエポックの純フローの符号が終了時まで維持された場合の、ポリシー乗数と発行率の予測です
1s_std_pool	ETH/STANDARD Uniswap v4プールの最新状態です。価格、ティック、流動性、準備金、残りのローンチ税を確認できます。現在、または過去のブロック時点を指定できます
1s_std_protocol_flows	プロトコルによる資金移動を新しい順に表示します。保有資産の移管、税金の送金、手数料の再投入、チームによる請求、POL買い戻し、手数料とペアリング、インセンティブの送金、マルチシグ管理の準備金Vaultからの流出と、移動に使用された方法、受取人を示すto_labelを確認できます。kindで絞り込み、cursorでページ分割できます
1s_std_sbills_bills	IDで指定した1つのS-Bill、または所有者やステータスで絞り込んだS-Billです。元本、プレミアム、固定レート、満期、決済方法を確認できます。単一のBillを指定した場合は、リアルタイムの退出見積もりと償還見積もりも返します
1s_std_sbills_current	現時点のS-Billステーキング条件です。期間ごとのレートと単純APR、変動状態、ロックされた元本、プレミアム予算、上限、早期退出手数料の適用期間を確認できます。レートは年率ではなく期間ごとのものです
1s_std_sbills_events	デコード済みのS-Billコントラクトイベントを新しい順に表示します。預け入れ、早期退出、償還、ロール、精算、ボーナス分配、レート変更、管理者による変更を確認できます
1s_std_sbills_quote	STANDARDをS-Billにステーキングする場合のリアルタイム見積もりです。固定されるレート、エスクローされるプレミアム、預け入れ後のレート、上限または一時停止によって預け入れが拒否されるかどうかを確認できます。コントラクトから直接読み取ります
1s_std_sbills_rate_history	S-Billレートの推移です。オンチェーンでのすべてのレート変更と定期的な変動サンプルを、各時点で有効だった期間の長さとともに表示します
1s_std_supply	STANDARDの供給台帳です。流通量、累積ミント量、経路ごとの累積バーン量、最大供給量、未請求のチャータースティミュラス（過去のブロックではnull）を確認できます。現在、履歴、または過去のブロック時点を指定できます
1s_std_tax_schedule	ローンチ税フックのスケジュールです。現在の購入／売却税、減衰設定、ローンチスケジュールが有効な間のラベル付き予測を確認できます
1s_std_vaults	拡大Vaultと縮小Vaultの残高です。保有するWETHとSTANDARD、プロトコル所有の流動性、買い戻し処理能力を確認できます。現在、履歴、または過去のブロック時点を指定できます
1s_std_wallet	1つのウォレットについて、保有するすべてのチャーターにまたがるTSRポジション全体を表示します。未払い分、退出見積もりの概要、休眠状態、ライセンス購入余地、請求可能なチャータースティミュラス、請求可能およびロック中のチャータードロップを確認できます

ドキュメント（8 個のツール）

認証は不要です。これらのツールはサーバーに同梱されたドキュメントコーパスから回答するため、料金はかからず、支払い方法を設定する前でも利用できます。スタンドアロンの @one-source/docs-mcp サーバーと同じ名前で、同じコーパスを提供します。

ツール	説明
1s_search_docs	OneSource 開発者向けドキュメントをキーワードで検索します
1s_get_api_overview	REST API の対象範囲 — 操作数、タグ、ネットワーク、支払いプロトコルを確認します
1s_list_endpoints	すべての REST エンドポイントについて、メソッド、パス、料金、概要を確認します。タグで絞り込めます
1s_get_endpoint_reference	1 つのエンドポイントの詳細 — パラメーター、リクエストボディ、レスポンス例、料金、curl を確認します
1s_search_use_cases	タスクを平易な言葉で説明して、適切なエンドポイントを探します
1s_list_networks	公開された仕様で定義されている、REST API がルーティングするネットワークを確認します
1s_get_payment_info	料金の範囲、決済手段、支払い先アドレスを確認します。エンドポイントを指定すると、そのエンドポイントの情報を表示します
1s_get_authentication_guide	REST API の認証方法と、選択すべき方法を確認します

セットアップと運用（3 個のツール）

認証は不要です。

ツール	目的	使用するタイミング
1s_setup_check	対話型セットアップとヘルスチェック。 両方の決済手段について、設定項目（認証方法、x402、MPP、支払いモード、チャネル設定）を一度に 1 つずつ案内します。設定済みの場合も実行のたびに案内します。また、バージョン、認証状態、チャネル状態、接続状況も確認します	最初に呼び出します — セットアップ、設定の変更、トラブルシューティングに使用します
1s_batch_config	支払いチャネルの設定（自律性、しきい値、x402 入金倍率、MPP セッション入金上限、デフォルトモード）を表示または変更し、再起動後も保持します — 設定ファイルの編集は不要です	セッション内でチャネルの動作を設定します
1s_report_bug	Slack（または代替手段の GitHub Issues）にバグを報告します	ツールでエラーが発生した場合や、ユーザーが問題を報告したい場合

ネットワーク

すべてのブロックチェーン API ツールでは、network パラメーターを省略可能です。

ネットワーク	説明
ethereum	Ethereum メインネット（デフォルト）
sepolia	Ethereum Sepolia テストネット
robinhood	Robinhood Chain、チェーン 4663（Arbitrum Orbit L2）— ライブ RPC 専用

認証

ブロックチェーン API ツールを使用するには認証が必要です。利用できる方法は 3 つあります。API キーとウォレットキーの両方が設定されている場合は、API キーが優先され、ウォレットキーは無視されます。

**ヒント：**いずれの方法も、最も手早く設定するには 1s_setup_check ツールを使用してください。対話形式ですべてのオプションを案内し、そのまま実行できるコマンドを提示するため、環境変数や設定ファイルを手作業で編集する必要はありません。以下の手動手順を参照情報としてご利用ください。

方法	変数	説明
API キー	ONESOURCE_API_KEY	無制限に呼び出せます。呼び出しごとの費用はかかりません
x402 マイクロペイメント	X402_PRIVATE_KEY	Base 上で USDC による従量課金。アカウントは不要です
MPP マイクロペイメント	MPP_PRIVATE_KEY	Tempo 上で USDC.e / pathUSD による従量課金。アカウントは不要です

オプション 1：API キー

1. app.onesource.io にアクセスして、アカウントを作成します。
2. Stripe のチェックアウトで API キーのサブスクリプションを完了します。
3. API Keys に移動して、キーを生成します。
4. キーをコピーします。sk_ で始まります。

Claude Code

claude mcp add onesource -e ONESOURCE_API_KEY=<key> -- npx -y @one-source/mcp@latest

Claude Desktop / Cursor

MCP 設定に env ブロックを追加します。

{
  "mcpServers": {
    "onesource": {
      "command": "npx",
      "args": ["-y", "@one-source/mcp@latest"],
      "env": {
        "ONESOURCE_API_KEY": "<key>"
      }
    }
  }
}

任意の MCP クライアント（stdio）

ONESOURCE_API_KEY=<key> npx -y @one-source/mcp@latest

追加した後、MCP サーバーを再読み込みして 1s_setup_check を呼び出します。Current configuration に Active auth method: API key（キーの先頭 6 文字とともに）と表示されます。

オプション 2：x402 マイクロペイメント

ブロックチェーン API エンドポイントは、x402 を介して Base 上で USDC 建てで課金されます。X402_PRIVATE_KEY を設定すると、サーバーが自動的に支払いを処理します。ツール呼び出しの支払いと再試行は透過的に行われるため、エージェント側で追加の作業は不要です。

1. EVM 秘密鍵を取得します — MetaMask、Coinbase Wallet、または任意の EVM ウォレットからエクスポートするか、新しく生成します。キーは 64 文字の 16 進数文字列です。0x プレフィックスは省略可能で、どちらの形式も受け付けます。
2. 以下のいずれかの方法でキーをサーバーに渡します。
3. 再読み込みしてウォレットアドレスを確認します — MCP サーバーを再読み込みしてから、1s_setup_check を呼び出します。Current configuration に x402 (Base) wallet として、キーから導出されたアドレスが表示されます。
4. そのアドレスに Base 上の USDC を入金します — 1s_setup_check に表示されたアドレス宛てに、Base ネットワーク上で USDC を送金します。数ドル（USDC で 1～5 ドル）あれば、数百回呼び出せます。USDC が Ethereum メインネット上にある場合は、Base Bridge を使ってブリッジしてください。
5. 動作を確認します — ethereum の 1s_network_info を呼び出します。チェーンデータ（ブロック番号、ガス価格）が返されれば、x402 による支払いが最後まで正常に機能しています。

Claude Code

claude mcp add onesource -e X402_PRIVATE_KEY=<key> -- npx -y @one-source/mcp@latest

Claude Desktop / Cursor

MCP 設定に env ブロックを追加します。

{
  "mcpServers": {
    "onesource": {
      "command": "npx",
      "args": ["-y", "@one-source/mcp@latest"],
      "env": {
        "X402_PRIVATE_KEY": "<key>"
      }
    }
  }
}

任意の MCP クライアント（stdio）

X402_PRIVATE_KEY=<key> npx -y @one-source/mcp@latest

オプション 3：MPP マイクロペイメント（Tempo）

ブロックチェーン API エンドポイントは、x402 の Base 上での支払いに代わる方法として、MPP を介して Tempo ネットワーク上でも支払うことができます。MPP_PRIVATE_KEY を設定すると、サーバーが支払いを自動的に処理します。ツール呼び出しの支払いと再試行は透過的に行われます。

1. EVM 秘密鍵を取得します — 形式は x402 と同じです（64 文字の 16 進数。0x は省略可能）。キーをエクスポートするか、新しく生成します。
2. 以下のいずれかの方法でキーをサーバーに渡します。
3. 再読み込みしてウォレットアドレスを確認します — MCP サーバーを再読み込みしてから、1s_setup_check を呼び出します。Current configuration に MPP (Tempo) wallet として、キーから導出されたアドレスが表示されます。
4. そのアドレスに Tempo 上の USDC.e または pathUSD を入金します — 数ドルあれば、数百回呼び出せます。
5. 動作を確認します — 1s_network_info を呼び出します。チェーンデータが返されれば、MPP による支払いが最後まで正常に機能しています。

Claude Code

claude mcp add onesource -e MPP_PRIVATE_KEY=<key> -- npx -y @one-source/mcp@latest

Claude Desktop / Cursor

{
  "mcpServers": {
    "onesource": {
      "command": "npx",
      "args": ["-y", "@one-source/mcp@latest"],
      "env": {
        "MPP_PRIVATE_KEY": "<key>"
      }
    }
  }
}

任意の MCP クライアント（stdio）

MPP_PRIVATE_KEY=<key> npx -y @one-source/mcp@latest

デフォルトでは、MPP は呼び出しごとに支払います（mpp-charge）。短時間に多数の呼び出しを行う場合は、1s_payment_mode { "mode": "mpp-session" } を使って Tempo バウチャーチャネルに切り替えるか（または MPP_PAYMENT_MODE=session を設定します）、1 回の入金で複数のオフチェーン呼び出しに対応できます。未使用残高は 1s_refund でいつでも返金でき、正常にシャットダウンすると自動的に精算されます。

設定ファイルの場所

CLI コマンドではなく、設定ファイルを直接編集する場合は、以下を参照してください。

クライアント	設定ファイルのパス
Claude Code	claude mcp get onesource を実行してファイルパスを確認します
Claude Desktop（macOS）	~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop（Windows）	%APPDATA%\Claude\claude_desktop_config.json
Cursor（macOS）	~/.cursor/mcp.json
Cursor（Windows）	%USERPROFILE%\.cursor\mcp.json

上記の JSON ブロックを使って、"mcpServers" 内に onesource エントリを追加します。

別の方法：環境変数として設定する

env 設定ブロックを使う代わりに、次のいずれかの変数をシェルまたはシステムの環境変数として設定できます。export ONESOURCE_API_KEY=<key>（bash/zsh）または $env:ONESOURCE_API_KEY = "<key>"（PowerShell）を実行してください。セッションをまたいで設定を保持するには、OS レベルで設定します。

支払いチャネル（任意）

デフォルトでは、有料の呼び出しごとに支払いを 1 回署名します（Base では x402-exact、Tempo では mpp-charge）。短時間に多数の呼び出しを行う場合は、支払いチャネルを開くと、1 回のオンチェーン入金で複数のオフチェーン呼び出しに対応し、まとめて精算できます。呼び出しごとに支払うよりも安価です。

• x402（Base）： 1s_payment_mode { "mode": "x402-batch" } を使って x402-batch に切り替えるか（または X402_PAYMENT_MODE=batch を設定します）。最初の呼び出しで price × X402_DEPOSIT_MULTIPLIER（デフォルトは 10）が入金されます。
• MPP（Tempo）： 1s_payment_mode { "mode": "mpp-session" } を使って mpp-session に切り替えるか（または MPP_PAYMENT_MODE=session を設定します）。最初の呼び出しで、最大 MPP_MAX_DEPOSIT（デフォルトは 1）が入金されます。

未使用残高は 1s_refund ツールでいつでも返金できます（どちらのレールでも利用可能）。残高は常にオンチェーンで返金可能です。アイドル状態の x402 チャネルは数時間後に自動返金され、MPP セッションは正常にシャットダウンすると自動的に精算されます。

ウォレットで支払う場合、エージェントには起動時にシステムプロンプトでチャネルに関するガイダンスが渡されるため、手動の手順を残さずにエージェントが管理できます。多数の呼び出しを見込む場合は、使用中のレールでチャネルモードへの切り替えを提案し、完了後に 1s_refund を使うよう通知します。エージェントの積極性は X402_BATCH_PROMPT（ask / auto / off）と X402_BATCH_THRESHOLD（何回の呼び出しを多数とみなすか。両方のレールで共通）で制御できます。詳しくは環境変数を参照してください。1s_setup_check では現在のモード、チャネルが利用可能かどうか、およびすべての設定を確認できます。

セキュリティ

キーをソース管理にコミットしないでください。環境変数、.env ファイル（git の対象から除外）、またはシークレットマネージャーを使用してください。

設定を変更した後は必ず： Claude Code で /reload-plugins を実行するか、Claude Desktop / Cursor を再起動してください。新しい環境変数を反映するには、MCP サーバーを再読み込みする必要があります。

環境変数

必須

ブロックチェーン API ツールにアクセスするには、いずれか 1 つを設定します。どちらも設定されていない場合、認証不要の Setup & Ops ツールのみ利用できます。API キーをウォレットキーと併せて設定した場合は、API キーが優先されます。

Variable	Default	Description
ONESOURCE_API_KEY	—	Bearer トークン認証用の OneSource API キーです。ウォレット関連の設定より優先されます。
X402_PRIVATE_KEY	—	Base での x402 による USDC 自動決済に使用する EVM 秘密鍵です（64 文字の 16 進数。0x プレフィックスは省略可能）。
MPP_PRIVATE_KEY	—	Tempo での MPP による自動決済（USDC.e / pathUSD）に使用する EVM 秘密鍵です。

オプション／詳細設定

すべてに適切なデフォルト値が設定されているため、チャネルモードはそのまま利用できます。エンドポイントを変更する場合、チャネルモードの動作を調整する場合、または分析設定を変更する場合にのみ、これらを設定してください。決済モードは実行時に 1s_payment_mode ツールを使って切り替えることもできます。以下のチャネル関連設定（X402_PAYMENT_MODE、X402_DEPOSIT_MULTIPLIER、MPP_PAYMENT_MODE、MPP_MAX_DEPOSIT、X402_BATCH_PROMPT、X402_BATCH_THRESHOLD）は、セッションから 1s_batch_config ツールを使って設定し、保存できます。設定ファイルの編集や再起動は不要です。保存済みの設定は、これらの環境変数より優先されます。

Variable	Default	Description
ONESOURCE_BASE_URL	https://api.onesource.io	API のベース URL です。
X402_PAYMENT_MODE	exact	x402 の初期方式です。exact（呼び出しごと）または batch（決済チャネル）を指定します。セッション中は 1s_payment_mode で切り替えられます。
X402_RPC_URL	Base default	バッチモードでチャネルへの入金を送信する際に使用する Base RPC エンドポイントです。
X402_DEPOSIT_MULTIPLIER	10	バッチモードでは、入金額は料金 × この倍率となり、チャネルごとにその回数分の呼び出しに充当されます。未使用残高は 1s_refund で払い戻しできます。
X402_CHANNEL_DIR	—	再起動後もバッチチャネルの状態を保持するディレクトリです。未設定の場合はメモリー上に保存されるため、再起動するとチャネルは失われます。
X402_CHANNEL_SALT	zero	バッチモードで、開始チャネル ID の導出に使用する 32 バイトの 16 進数ソルトです。チャネルの利用が終了するか払い戻された場合、クライアントは次のソルトに自動的に切り替えます。
MPP_PAYMENT_MODE	charge	MPP の初期方式です。charge（呼び出しごと）または session（Tempo バウチャーチャネル）を指定します。セッション中は 1s_payment_mode で切り替えられます。
MPP_MAX_DEPOSIT	1	セッションモードで、Tempo バウチャーチャネルごとにロックする USDC.e / pathUSD の最大額です。未使用残高は 1s_refund で払い戻しできます。
MPP_RPC_URL	Tempo default	セッションモードでチャネルへの入金を送信する際に使用する Tempo RPC エンドポイントです。
X402_BATCH_PROMPT	ask	チャネルモードへの切り替えをエージェントがどのように扱うか（両方の決済方式に適用）を指定します。ask（切り替え前に確認）、auto（自動で切り替え）、off（明示的に要求された場合のみ切り替え）から選択します。
X402_BATCH_THRESHOLD	5	セッションで予想される呼び出し回数がこの値以上の場合に、エージェントがチャネルモードを検討する基準です（両方の決済方式に適用）。これは参考値です。エージェントが呼び出し回数を推定するものであり、実行時に厳密に数えるカウンターではありません。
ONESOURCE_CONFIG_DIR	~/.onesource	1s_batch_config が書き込む、サーバー管理のチャネル設定（batch-config.json）を格納するディレクトリです。
ONESOURCE_ANALYTICS	true	分析を無効にするには、false を設定します。
ONESOURCE_ANALYTICS_URL	https://1s-analytics.vercel.app	分析用ダッシュボードのエンドポイントです。
ONESOURCE_ANALYTICS_KEY	onesource-mcp	ダッシュボード分析用の API キーです。旧名の X402_ANALYTICS_KEY も引き続き利用できますが、非推奨です。

トラブルシューティング

1s_setup_check に「Active auth method: none」と表示される（ブロックチェーンツールがロックされている） Current configuration の「Active auth method: none」は、認証が設定されていないことを意味します。ONESOURCE_API_KEY（API キー）、X402_PRIVATE_KEY（Base 上の x402）、MPP_PRIVATE_KEY（Tempo 上の MPP）のいずれかを設定するか、1s_setup_check を実行して案内に従ってください。変数を設定したら、MCP サーバーを再読み込みしてください（上記の注記を参照）。キーがまだサーバーに渡されない場合は、シェルの環境変数として直接設定してください。

正しく設定しているのに 403 が発生する／別のキーが有効になっている シェルのプロファイル（例：~/.zshrc、~/.bash_profile）に設定されたキーは、Claude MCP 設定に記載されていなくても、MCP サーバープロセスで使用されます。ターミナルで echo $ONESOURCE_API_KEY を実行して確認してください。意図していない値が表示された場合は、unset ONESOURCE_API_KEY で設定を解除するか、サーバーの追加時に明示的にクリアしてください：claude mcp add onesource -e ONESOURCE_API_KEY= -e X402_PRIVATE_KEY=<key> -- npx -y @one-source/mcp@latest。1s_setup_check には、有効なキーの先頭 6 文字が表示されるため、サーバーがどのキーを使用しているか確認できます。

再インストール後、手順に誤った認証方式が表示される Claude Code の /reload-plugins はツールを再接続しますが、LLM に表示されるシステムプロンプトは更新されない場合があります。認証方式を切り替えた場合（例：API キー → x402）、手順に新しい認証方式が反映されるよう、Claude Code を完全に再起動してください。

「MCP server onesource already exists」エラー まず claude mcp remove onesource を実行してから、更新した設定で再追加してください。

Windows：npx には cmd /c ラッパーが必要 Claude Code の /doctor コマンドで警告が表示される場合があります。MCP 設定を更新し、"command": "cmd" と "args": ["/c", "npx", "-y", "@one-source/mcp@latest"] を使用してください。

**npx が出力なしで停止する** これは正常です。stdio モードは stdin での JSON-RPC 入力を待機します。curl で利用できる HTTP サーバーが必要な場合は、--http を使用してください。

ポートがすでに使用されている 別のポートを指定してください：npx -y @one-source/mcp@latest --http --port=8080

レジストリへの公開

このパッケージは、検証済みの名前空間 io.onesource/mcp で公式 MCP レジストリに、また Glama に掲載されています。新しいバージョンをリリースする際は、両方のレジストリを更新してください。

MCP レジストリ

初回セットアップ

1. Go をインストールする

go.dev/dl からお使いのプラットフォーム用のインストーラーをダウンロードして実行してください。次のコマンドで確認します：

go version

2. mcp-publisher をインストールする

go install github.com/modelcontextprotocol/registry/cmd/mcp-publisher@latest

Go モジュールのパスが変更されてコマンドが失敗する場合は、代わりに mcp-publisher GitHub リリースページからバイナリを直接ダウンロードしてください。

Windows でコマンドが認識されない場合は、Go の bin ディレクトリを PATH に追加してください：

$env:PATH += ";$env:USERPROFILE\go\bin"

次のコマンドで確認します：

mcp-publisher --help

3. DNS 認証（設定済み）

onesource.io ドメインには、io.onesource 名前空間の所有権を証明する DNS TXT レコードが設定されています。これは設定済みのため、再設定する必要はありません。

レコードはルートドメイン（_mcp-registry.onesource.io ではなく onesource.io）にあります：

v=MCPv1; k=ed25519; p=7D3U5rufgNXb/lH2MthTRZdDzEGeE7/Jvg8YkiArQc8=

解決されることを次のコマンドで確認できます：

nslookup -type=TXT onesource.io 8.8.8.8

4. 秘密鍵を取得する

認証には、DNS レコード内の公開鍵に対応する ed25519 秘密鍵が16 進数形式で必要です。この鍵はチームリードに問い合わせてください。チームのパスワードマネージャー／保管庫に保存されています。

キーペアを再生成する必要がある場合（現在の DNS レコードが無効になり、更新が必要になります）：

1. 新しい ed25519 キーペアを生成します（例：openssl genpkey -algorithm Ed25519 -out key.pem）
2. 生の 32 バイト秘密鍵シードを取り出し、16 進数に変換します：

 openssl pkey -in key.pem -outform DER | tail -c 32 | xxd -p -c 32

3. DNS TXT レコード用に、公開鍵を base64 形式で取り出します：

 openssl pkey -in key.pem -pubout -outform DER | tail -c 32 | base64

4. onesource.io の DNS TXT レコードを新しい公開鍵で更新します：

 v=MCPv1; k=ed25519; p=<base64-public-key>

5. ログインを試みる前に、DNS の伝播を待ちます。

新しいバージョンの公開

リリーススクリプトを使用してください。 リリースは通常、sre-services リポジトリ内の調整済みリリース スクリプト（scripts/release-mcp.mjs — sre-services/RELEASING.mdを参照）を使って実行します。 このスクリプトは、server.jsonの更新やmcp-publisher publishも含め、以下のすべての手順を @one-source/api-mcpと@one-source/mcpの両方に対して正しい順序で実行します。レジストリへの 登録手順の前提条件として、上記の初回セットアップが必要です。以下の手動手順は、レジストリのみの 修正を行う場合、またはスクリプトを実行できない場合の代替手段です。

新しい npm バージョンをリリースするたびに、MCP Registry を更新してください。

1. npm に公開する（レジストリではパッケージが存在することを検証するため、最初に行う必要があります）：

 npm run build
 npm publish --access public

2. server.jsonを更新する — 2 つのversionフィールドを新しい npm バージョンに合わせます：

 {
   "version": "x.y.z",
   ...
   "packages": [{ "version": "x.y.z", ... }]
 }

package.jsonのmcpNameフィールドは"io.onesource/mcp"である必要があり、server.jsonのnameフィールドと一致している必要があります。すでに設定されているため、削除しないでください。 3. 認証する（トークンは期限切れになるため、毎回行ってください）：

 mcp-publisher login dns --domain onesource.io --private-key <ed25519-hex-private-key>

4. レジストリに公開する：

 mcp-publisher publish

5. 確認する：

 curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=onesource"

Glama

Glama は GitHub リポジトリから毎日自動同期します。リリース後に手動で行うことはありません。変更がdevelop（デフォルトブランチ）にプッシュされていることを確認してください。リポジトリのルートにあるglama.jsonファイルで所有権を管理します。サーバーの所有権を取得した後は、Glama 管理パネルから手動で再同期できます。

プライバシーポリシー

この拡張機能を使用すると、OneSource API に接続します。データの取り扱いについて詳しくは、OneSource プライバシーポリシーをご覧ください。

ライセンス

Apache 2.0 — 詳細はLICENSEをご覧ください。