minia2a-mcp

minia2a-mcp

适用于 minia2a.uk 的 MCP 服务——面向 AI Agent 的 x402 微支付市场。

🚀 已为 Claude Code 自动模式做好准备。 让你的 AI Agent 使用内置 USDC 微支付，通过 x402 协议发现、调用并支付 1,600 多项服务。每个已签名钱包可免费试用 5 次（自托管钱包 + EIP-191 签名，无需注册）——无需 API 密钥或订阅，按次付费。支持 .agent-budget v1.1，确保自主消费安全。

安装

npm install -g minia2a-mcp

使用方法

Claude Code

添加到你的 Claude Code MCP 配置中（~/.claude/.mcp.json）：

{
  "mcpServers": {
    "minia2a": {
      "command": "npx",
      "args": ["-y", "minia2a-mcp"]
    }
  }
}

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "minia2a": {
      "command": "npx",
      "args": ["-y", "minia2a-mcp"]
    }
  }
}

工具（6 个）

minia2a_list_services

浏览可用的 x402 服务。按类别或搜索词筛选。

minia2a_get_service

获取特定服务的详细信息——价格、端点、架构和文档。

minia2a_get_stats

平台统计信息——服务总数、Agent 数量、交易量和运行时间。

minia2a_register

注册自托管钱包，以便发布自己的服务（EIP-191 签名）。注册用于发布服务——试用无需注册：在 minia2a_call_service 中签名的任何钱包都可获得 5 次免费试用调用。如果你未提供钱包，系统会为你生成一个，并返回私钥。

minia2a_call_service

调用任意 x402 服务。网关按以下顺序尝试两种访问方式：

1. 钱包试用——传入 privateKey（或设置 MINIA2A_PRIVATE_KEY），即可使用钱包的 5 次免费试用调用（无需注册）。密钥会保留在此进程中；它只用于签署每次调用的消息 minia2a trial:<wallet>:<serviceId>:<unixSeconds>，通过网络传输的只有签名。 单独提供 wallet= 不会生效——只有签名才能完成验证。
2. 支付——钱包的试用次数用完后，该工具会返回用于结算的 402 accepts[] 数组。

响应会直接从网关的标头中报告 trialMode（wallet / ip）和 trialRemaining，让你了解实际由哪种方式支付了调用费用，而不是自行推断。

minia2a_check_endpoint ← v1.1.3 新增

验证任意 x402 端点是否已准备好供自主 Agent（Claude Code 自动模式）使用。检查 9 项信号：HTTP 可达性、JSON 内容类型、支付挑战（规范的 PAYMENT-REQUIRED 标头或旧版 x-402-* 标头）、支付金额、网络、收款方、试用信息、注册途径以及 /api/agent-ready 握手。返回带评分的报告，逐项列出检查的 PASS/FAIL 详情及获得的分数。

什么是 minia2a？

minia2a.uk 是一个供 AI Agent 相互买卖服务的市场。它基于 x402 协议（HTTP 402 Payment Required）构建，每次 API 调用都会自动进行 USDC 微支付——无需订阅、API 密钥或月费。

• 1,600 多项 x402 服务——涵盖加密货币、Web、AI、数据等领域
• 在 Base 上使用 USDC 结算（eip155:8453）——每个端点的 402 accepts[] 都会在你付款前说明网络、资产和 payTo
• 每个已签名钱包可免费试用 5 次（自托管钱包 + EIP-191 签名，无需注册）
• 已为 Claude Code 自动模式做好准备——支持 .agent-budget v1.1，提供机器可读的 402 正文

Claude Code 自动模式

Claude Code 自动模式是默认模式。Agent 现在可以自主发现、试用并支付 API 费用，同时受到严格的预算上限、分类器安全检查和机器可读支付标头的保护。

minia2a 已支持自动模式：

• /api/agent-ready — 机器可读握手信息，包含支付信息、注册端点和快速入门指南
• 402 响应正文：accepts[] 数组（amount/asset/network/payTo/scheme）——Agent 可解析完整支付指令（x402 V2）
• .agent-budget v1.1 — 7 项自主购买控制（每次调用 / 每项任务 / 确认 / 去重 / 结算 / 审计）
• 每个已签名钱包有 5 次免费试用调用（无需注册）——可在整个目录中使用。并非每个端点都符合试用条件：高级 / 合约审计 / AI / deepseek 和价格 ≥$2 的服务可能仅支持付费使用。是否可试用由端点自身的 402 响应决定，而非所属类别。

{
  "version": "1.1",
  "daily_limit_usdc": 5,
  "max_per_call_usdc": 1,
  "per_task_limit_usdc": 3,
  "confirmation_threshold_usdc": 0.5,
  "idempotency_key": "required",
  "verify_settlement": true,
  "audit_trail": true
}

快速入门指南 →

什么是 x402？

x402 是一种开放协议，通过扩展 HTTP 402 Payment Required 实现机器间小额支付。服务会在 HTTP 响应标头中声明价格，客户端则使用 USDC 在 Base 上付款。没有中间商，也没有结算延迟。x402 Foundation 于 2026 年 7 月在 Linux Foundation 旗下成立，创始成员超过 40 家，包括 Visa、Mastercard、Stripe 和 Cloudflare。

了解更多信息，请访问 x402.org。

生态系统

minia2a 根据你的技术栈提供多种集成方式：

软件包	用途	安装
minia2a-mcp（本项目）	用于 Claude、Cursor、Codex 的 MCP 服务	npm i -g minia2a-mcp
@minia2a/sdk	面向 @x402/express 开发者的命令行工具	npm i -g @minia2a/sdk
@minia2a/elizaos-plugin-minia2a	ElizaOS Agent 插件	npm i @minia2a/elizaos-plugin-minia2a
minia2a	通用 SDK	npm i minia2a

链接

• minia2a.uk — 服务市场
• npm 上的 minia2a MCP 服务
• MCP Registry — 在官方注册表中查找此服务

许可证

MIT