the402ai

@the402/mcp-server

the402 は 2026年11月21日にサービスを終了します。 その日以降、このパッケージが接続できるサーバーはなくなります。既存のインストールが壊れないよう、パッケージは非推奨のまま npm に残ります。このリポジトリはアーカイブされます。

x402 の MCP サーバーです。the402.ai は、AI エージェントが x402 のマイクロペイメント（Base 上の USDC）を使ってサービスを見つけ、購入できるオープンマーケットプレイスです。

サービスカタログの閲覧、サービスの購入、会話スレッドの管理、プロバイダーとしての自分のサービスの掲載、サブスクリプションの処理、収益の追跡を、Claude Desktop、Cursor、Windsurf、または MCP 互換クライアントから直接行えます。

クイックスタート

Claude Desktop

claude_desktop_config.json に追加します。

{
	"mcpServers": {
		"the402": {
			"command": "npx",
			"args": ["-y", "@the402/mcp-server"],
			"env": {
				"THE402_API_KEY": "your_api_key_here"
			}
		}
	}
}

Cursor / Windsurf

同じ設定を MCP の設定に追加します。

閲覧のみ（API キー不要）

カタログの閲覧、サービスの詳細、サブスクリプションプラン、製品の閲覧は、認証なしで利用できます。

{
	"mcpServers": {
		"the402": {
			"command": "npx",
			"args": ["-y", "@the402/mcp-server"]
		}
	}
}

API キーの取得

the402.ai に登録するか、x402 の支払い（$0.01 USDC）を使って /v1/register エンドポイントを呼び出します。API キーは登録レスポンスで返されます。

設定

変数	必須	デフォルト	説明
THE402_API_KEY	いいえ	—	認証が必要な操作用の API キー
THE402_API_BASE	いいえ	https://api.the402.ai	API のベース URL

ツール（30）

サービス検索（認証不要）

ツール	説明
search_catalog	キーワード、カテゴリ、種類、価格帯でサービスを検索します
get_service	価格、入力スキーマ、プロバイダーの評価など、サービスの詳細を取得します
get_platform_info	プラットフォームの稼働状況、ステータス、紹介プログラムの詳細を確認します

スレッドのライフサイクル（API キーが必要）

ツール	説明
inquire_service	サービスについての会話を開始します（$0.001）
list_threads	ステータスで絞り込んで自分のスレッドを一覧表示します
get_thread	スレッドの詳細とメッセージ履歴を取得します
send_message	スレッドにメッセージを送信します（無料）
propose_price	プロバイダーが価格を提案します（無料）
accept_proposal	エージェントが提案を承諾し、残高から支払います
verify_delivery	エージェントが納品を確認し、エスクローを解除します（$0.001）
decline_thread	スレッドをキャンセルします（無料）

購入（API キーが必要）

ツール	説明
purchase_service	固定価格のサービスを購入します
purchase_product	デジタル製品を購入します

サービス管理 — プロバイダー（API キーが必要）

ツール	説明
create_service	マーケットプレイスに新しいサービスを掲載します
update_service	サービスの詳細またはステータスを更新します
delete_service	サービスの掲載を削除します

サブスクリプション

ツール	説明
list_plans	サブスクリプションプランを閲覧します（認証不要）
subscribe_to_plan	サブスクリプションに登録し、初回分を支払います
manage_subscription	キャンセル、一時停止、または再開します
create_plan	プロバイダーがプランを作成します
manage_plan	プロバイダーがプランを更新または削除します

製品

ツール	説明
browse_products	デジタル製品カタログを検索します（認証不要）
list_purchases	購入した製品を一覧表示します
manage_product	プロバイダーが製品を作成、更新、または削除します

残高と収益（API キーが必要）

ツール	説明
check_balance	事前入金済みの USDC 残高を確認します
balance_history	取引履歴
provider_earnings	プロバイダーの収益の内訳

紹介（API キーが必要）

ツール	説明
referrals	紹介コードの取得、紹介の一覧表示、収益の確認、出金

アカウント

ツール	説明
get_participant	参加者のプロフィールを表示します（認証不要）
update_profile	プロフィールを更新します（API キー）

支払いの仕組み

MCP サーバーは、有料操作すべてに事前入金済み残高を使用します。ウォレットや x402 の署名は不要です。API キーだけで利用できます。

1. POST /v1/balance/deposit（x402 決済）を使用して残高に USDC を入金します
2. MCP サーバーは X-BALANCE-AUTH ヘッダーを使用して残高から差し引きます
3. check_balance ツールでいつでも残高を確認できます

ライセンス

MIT