使用说明
@algo钱包/x402 mcp
Algorand的授权管理AI代理钱包。 让Claude和其他LLM能够在Algorand上使用USDC支付x402门控API，并在每次付款时强制执行所有者设置的支出限制。
这是什么
MCP服务器为LLM提供了三种管理自主AI代理钱包的工具：
| 工具 | 它做什么 |
|---|---|
pay_with_x402 |
支付任何x402-gated API端点的费用。资金流动前强制执行授权限制。 |
check_balance |
USDC+ALGO余额、天然气状态和预计剩余交易。 |
check_mandates |
钱包所有者设定的主动支出限额——每笔交易上限、每日上限、到期日。 |
安全保证： 您的所有者设定了一个授权（例如$0.10/tx，$1.00/天）。代理人不能超过这些限额进行支出——在任何资金转移之前，付款都会被拒绝。所有交易都使用公共txnId在Algorand主网上结算。
安装
npx @algo-wallet/x402-mcp
克劳德桌面
增添 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"x402-wallet": {
"command": "npx",
"args": ["-y", "@algo-wallet/x402-mcp"],
"env": {
"ALGO_MNEMONIC": "word1 word2 ... word25",
"X402_AGENT_ID": "my-claude-agent",
"X402_PORTAL_KEY": "pk_...",
"X402_API_URL": "https://api.ai-agentic-wallet.com"
}
}
}
}
克劳德代码
claude mcp add x402-wallet \
-e ALGO_MNEMONIC="word1 word2 ... word25" \
-e X402_AGENT_ID="my-claude-agent" \
-e X402_PORTAL_KEY="pk_..." \
-- npx -y @algo-wallet/x402-mcp
设置
- 创建代理 在 ai-agentic-wallet.com --得到你的
AGENT_ID和PORTAL_KEY - 为代理人提供资金 --发送0.5 ALGO激活，然后存入USDC用于消费
- 设定任务 --从仪表板配置每笔交易和每日上限
- 添加此MCP服务器 使用您的凭据
完整设置指南： ai-agentic-wallet.com/docs
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
ALGO_MNEMONIC |
是 | 您注册代理钱包的25个单词的Algorand助记符 |
X402_AGENT_ID |
是 | 来自ai-agentic-wallet.com的代理ID |
X402_PORTAL_KEY |
是 | 门户API密钥（仪表板→ API密钥） |
X402_API_URL |
否 | 覆盖API基本URL（默认值： https://api.ai-agentic-wallet.com) |
付款方式
Claude calls pay_with_x402("/api/weather")
↓
MCP server probes endpoint → receives 402 + payment terms
↓
Builds x402 proof (identity signature over groupId, no on-chain txn in flight)
↓
Server verifies proof → checks mandate → executes USDC payment on-chain
↓
Returns txnId + Pera Explorer link to Claude
↓
Claude delivers the answer
付款方式为 原子的 --在USDC在链上确认之前，数据永远不会交付。
科技
- Algorand主网，USDC（ASA 31566704）
- 每笔交易的ALGO费用约为0.0002美元，3.8秒结束
- 在Redis中强制执行速度窗口（故障关闭）
- 所有可公开验证的交易 货币浏览器
链接
- 仪表板和文档： ai-agentic-wallet.com
- npm： @algo钱包/x402 mcp
- MCP客户端SDK： @algo钱包/x402客户端
