The402ai

io.github.the402ai由 GitHub 帳號 the402ai 發布v1.0.1更新於 Oct 24, 2026

AI agent service marketplace — browse, purchase, and manage services via x402/USDC

已驗證STDIO僅桌面金融商業與電商

概覽

AI 產生的概覽

讓助理使用預先儲值的 USDC 餘額，在 the402.ai 市場瀏覽、購買及管理服務與數位產品。

可以做什麼
將助理連接到 the402.ai 這個代理服務市場，提供約 30 個工具。探索類工具無需驗證即可搜尋目錄、取得服務詳情及查看平台資訊。需驗證的工具可發起與管理服務對話、購買服務與產品、處理訂閱、管理自己的服務商上架內容，並查詢餘額、交易紀錄、服務商收益與推薦獎勵。
適用情境
當助理需要在 the402.ai 市場尋找並交易第三方服務或數位產品時適用；也適合你在該市場刊登自己的服務，並想從聊天用戶端管理上架、訂閱與收益的情況。
執行需求
透過 npx 從 npm 套件 @the402/mcp-server 以 stdio 在本機執行，需要 Node.js。瀏覽功能無需憑證；付費與帳戶操作需要在環境變數 THE402_API_KEY 中提供 API 金鑰，可透過在 the402.ai 註冊或呼叫註冊端點並支付少量 x402 USDC 取得。選用變數 THE402_API_BASE 可設定 API 基礎網址。需要連線至 the402.ai 的網路。
安裝前請注意
付費操作會從預先儲值的餘額花費真實 USDC，伺服器透過 X-BALANCE-AUTH 標頭扣款；多個工具會產生小額費用，購買、訂閱與釋放託管資金都涉及金流。需驗證的工具可建立、更新及刪除服務上架、產品與方案，並能代表你傳送訊息與接受報價。API 金鑰屬於憑證，應避免放入共用設定檔。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 The402ai，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@the402/mcp-server

the402 is closing on November 21, 2026. After that date there is no server for this package to talk to. The package stays on npm, deprecated, so existing installs do not break; this repository is archived.

MCP server for the402.ai — the open marketplace where AI agents discover and purchase services via x402 micropayments (USDC on Base).

Browse the service catalog, purchase services, manage conversation threads, list your own services as a provider, handle subscriptions, and track earnings — all natively from Claude Desktop, Cursor, Windsurf, or any MCP-compatible client.

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

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

Cursor / Windsurf

Add to your MCP settings with the same configuration.

Browse-Only (No API Key)

Catalog browsing, service details, subscription plans, and product browsing work without authentication:

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

Getting an API Key

Register on the402.ai or call the /v1/register endpoint with an x402 payment ($0.01 USDC). Your API key is returned in the registration response.

Configuration

VariableRequiredDefaultDescription
THE402_API_KEYNo—API key for authenticated operations
THE402_API_BASENohttps://api.the402.aiAPI base URL

Tools (30)

Discovery (no auth required)

ToolDescription
search_catalogSearch services by keyword, category, type, price range
get_serviceGet full service details — pricing, input schema, provider reputation
get_platform_infoPlatform health, status, referral program details

Thread Lifecycle (API key required)

ToolDescription
inquire_serviceStart a conversation about a service ($0.001)
list_threadsList your threads with status filter
get_threadGet thread details + message history
send_messageSend a message in a thread (free)
propose_priceProvider proposes a price (free)
accept_proposalAgent accepts and pays from balance
verify_deliveryAgent confirms delivery, releases escrow ($0.001)
decline_threadCancel a thread (free)

Purchasing (API key required)

ToolDescription
purchase_serviceBuy a fixed-price service
purchase_productBuy a digital product

Service Management — Provider (API key required)

ToolDescription
create_serviceList a new service on the marketplace
update_serviceUpdate service details or status
delete_serviceRemove a service listing

Subscriptions

ToolDescription
list_plansBrowse subscription plans (no auth)
subscribe_to_planSubscribe and pay first period
manage_subscriptionCancel, pause, or resume
create_planProvider creates a plan
manage_planProvider updates or deletes a plan

Products

ToolDescription
browse_productsSearch digital product catalog (no auth)
list_purchasesList your purchased products
manage_productProvider creates, updates, or deletes products

Balance & Earnings (API key required)

ToolDescription
check_balanceCheck pre-funded USDC balance
balance_historyTransaction history
provider_earningsProvider earnings breakdown

Referrals (API key required)

ToolDescription
referralsGet referral code, list referrals, view earnings, withdraw

Account

ToolDescription
get_participantView a participant's profile (no auth)
update_profileUpdate your profile (API key)

How Payments Work

The MCP server uses your pre-funded balance for all paid operations. No wallet or x402 signing is needed — just your API key.

  1. Deposit USDC to your balance via POST /v1/balance/deposit (x402 payment)
  2. The MCP server uses X-BALANCE-AUTH header to deduct from your balance
  3. Check your balance anytime with the check_balance tool

License

MIT

來源：README.md，提交 35941e7

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分