用途
mcp-server 是 the402.ai 的 MCP（Model Context Protocol）服务器。the402.ai 被描述为一个开放市场，AI 智能体可在其中通过 x402 微支付（Base 链上的 USDC）发现并购买服务。该服务器的作用是把这一市场的操作能力以 MCP 工具的形式暴露给兼容 MCP 的客户端，使 AI 智能体能够原生地完成浏览、购买、管理与销售等流程。
主要能力
根据仓库说明，该 MCP 服务器支持以下操作：
- 浏览服务目录（service catalog）
- 购买服务
- 管理对话线程（conversation threads）
- 以提供者（provider）身份上架自己的服务
- 处理订阅（subscriptions）
- 跟踪收入（earnings）
这些能力覆盖了发现（Discovery）、线程生命周期（Thread Lifecycle）、购买（Purchasing）、服务管理（Service Management — Provider）、余额与收入（Balance & Earnings）、推荐（Referrals）等类别。
使用方式
该服务器可接入 Claude Desktop、Cursor、Windsurf 或任何兼容 MCP 的客户端。
在 Claude Desktop 中，将其添加到 claude_desktop_config.json；在 Cursor / Windsurf 中，使用相同的配置添加到 MCP 设置中。
认证方面：
- 仅浏览（Browse-Only，无需 API 密钥）：目录浏览、服务详情、订阅计划和产品浏览无需认证即可工作。
- 获取 API 密钥：在 the402.ai 注册，或调用 /v1/register 端点并支付 x402 付款（0.01 USDC）。API 密钥在注册响应中返回。
需要 API 密钥的操作包括：线程生命周期、购买、服务管理（提供者）、余额与收入、推荐。发现（Discovery）无需认证。
支付方式
该 MCP 服务器对所有付费操作使用用户的预充值余额。用户无需钱包或进行 x402 签名，只需 API 密钥即可：
- 通过 POST /v1/balance/deposit 向余额充值 USDC（x402 付款）。
- MCP 服务器使用 X-BALANCE-AUTH 请求头从余额中扣款。
- 随时使用 check_balance 工具查询余额。
适用场景
- 在兼容 MCP 的客户端（如 Claude Desktop、Cursor、Windsurf）中，让 AI 智能体发现并购买 the402.ai 市场上的服务。
- 服务提供者通过智能体上架并管理自己的服务、处理订阅、跟踪收入。
- 通过推荐机制（Referrals）进行推广。
限制
- 购买、线程管理、服务管理、余额与收入、推荐等操作需要 API 密钥。
- 获取 API 密钥需要在 the402.ai 注册或支付 0.01 USDC 的 x402 付款。
- 付费操作从预充值余额扣款，需先充值 USDC。
- 除上述内容外，仓库资料未提供更多关于服务范围、收费结构、支持平台或其他限制的说明。
