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 分