AlgoVoi MCP Server
AlgoVoi MCP 服务器
一个 MCP (模型上下文协议) 服务器,它将 AlgoVoi 的支付基础设施作为任何 MCP 客户端(Claude Desktop、Claude Code、Cursor、Windsurf 或任何其他兼容 MCP 的助手)可以调用的工具公开。
提供 两个包:
包 | 安装 | 命令 |
|
| |
|
|
两者都公开了 相同的 13 个工具 和相同的 API 接口 —— 选择您客户端偏好的运行时即可。
13 个工具
支付工具
# | 工具 | 功能 |
1 |
| 为指定金额 + 链生成托管结账 URL |
2 |
| 验证结账令牌(可选包含 tx_id) |
3 |
| 页面内钱包流程参数 (Algorand / VOI) |
4 |
| 用于 AlgoVoi Webhook 的 HMAC-SHA256 签名检查 |
5 |
| 支持的链 + 资产 ID(离线,无 API 调用) |
协议质询工具
# | 工具 | 功能 |
6 |
| IETF MPP 402 |
7 |
| 验证 MPP 链上收据(直接索引器,无 API 调用) |
8 |
| 验证 x402 base64 支付证明(直接索引器) |
9 |
| x402 |
10 |
| 用于 AI 代理支付流程的 AP2 v0.1 |
11 |
| 验证 AP2 授权支付收据(直接索引器) |
A2A 代理工具 (v1.2.0 新增)
# | 工具 | 功能 |
12 |
|
|
13 |
|
|
A2A 支付并调用流程
1. fetch_agent_card("https://agent.example.com")
→ see agent costs $0.01, accepts MPP on Algorand
2. send_a2a_message(agent_url, "What is the price of ALGO?")
→ payment_required: true, challenge_headers: {WWW-Authenticate: ...}
3. generate_mpp_challenge(...) ← use tool #6
→ user pays on-chain
4. send_a2a_message(agent_url, text, payment_proof="<proof>")
→ task result returned支持的网络:Algorand、VOI、Hedera、Stellar(所有四个网络上的 USDC + 原生 ALGO/VOI/HBAR/XLM)。
Related MCP server: algorand-mcp
两种连接方式
选项 A — AlgoVoi Cloud(推荐)
AlgoVoi Cloud 是您所有集成的控制平面 —— WooCommerce、Zapier、n8n 和 MCP 都在一个仪表板中。将 ALGOVOI_API_BASE 指向 https://cloud.algovoi.co.uk,您唯一的 algv_... API 密钥即可覆盖所有集成 —— 无需租户 ID 或支付地址(它们存储在仪表板中)。
{
"mcpServers": {
"algovoi": {
"command": "npx",
"args": ["-y", "@algovoi/mcp-server"],
"env": {
"ALGOVOI_API_KEY": "algv_...",
"ALGOVOI_API_BASE": "https://cloud.algovoi.co.uk"
}
}
}
}Claude 创建的每笔支付都会与来自其他所有平台的支付一起出现在您的云仪表板中。在一个地方查看所有内容。
在 dash.algovoi.co.uk 免费注册。
选项 B — AlgoVoi 直接连接
使用您的 algv_... 密钥和租户 ID 直接连接到 AlgoVoi API。
两个包读取相同的环境变量:
变量 | 必需 | 用途 |
| ✅ | 来自 AlgoVoi 仪表板的 |
| ✅ | 来自 AlgoVoi 仪表板的租户 UUID |
| ✅* | Algorand 支付钱包地址 |
| ✅* | VOI 支付钱包地址 |
| ✅* | Hedera 支付账户 (例如 |
| ✅* | Stellar 支付地址 ( |
| — | 如果未设置各链变量,则作为通用回退 |
| — | 用于 |
| — | 覆盖 AlgoVoi API 基础 URL (默认: |
* 至少需要一个各链地址(或作为回退的 ALGOVOI_PAYOUT_ADDRESS)。
身份验证仅通过环境变量进行。 密钥绝不会通过工具参数传递 —— MCP 客户端永远看不到 API 密钥。
在 www.algovoi.co.uk 注册以获取您的 API 密钥和租户 ID。
{
"mcpServers": {
"algovoi": {
"command": "npx",
"args": ["-y", "@algovoi/mcp-server"],
"env": {
"ALGOVOI_API_KEY": "algv_...",
"ALGOVOI_TENANT_ID": "...",
"ALGOVOI_PAYOUT_ALGORAND": "<your-algorand-address>",
"ALGOVOI_PAYOUT_VOI": "<your-voi-address>",
"ALGOVOI_PAYOUT_HEDERA": "0.0.<your-account>",
"ALGOVOI_PAYOUT_STELLAR": "G<your-stellar-address>"
}
}
}
}对于 Python 包,请将 "command": "uvx", "args": ["algovoi-mcp"] 替换。
配置文件位置:
Claude Desktop:
~/Library/Application Support/Claude/claude_desktop_config.json(macOS),%APPDATA%\Claude\claude_desktop_config.json(Windows)Claude Code:
~/.claude.jsonCursor:
~/.cursor/mcp.json
测试
# TypeScript unit tests (77/77)
cd typescript && npm test
# Python unit tests (85/85)
cd python && pytest
# Stdio integration smoke — boots both servers and confirms all 13 tools list
python smoke_stdio.py根据 Business Source License 1.1 授权。
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceA generic MCP + REST payments gateway enabling agents to charge and accept payments without holding spending keys, supporting direct payments via x402 USDC and top-ups with XMR/ZEC.1MIT
- AlicenseNot gradedqualityDmaintenanceA comprehensive Model Context Protocol (MCP) server providing 50+ tools for Algorand blockchain development, including account management, asset operations, smart contracts, API integration, swap functionality, and advanced transaction capabilities.59MIT
- AlicenseAqualityBmaintenanceKeyless crypto payments for AI agents. One MCP call turns any wallet address into a non-custodial crypto payment link or tip jar, no API key and no account, with funds settling straight to your wallet at a 0% platform fee (USDC/USDT, BTC, LTC, DASH, DOGE, ZCASH).6369MIT
- AlicenseNot gradedqualityBmaintenanceNon-custodial payment engine for AI agents supporting BTC, ETH, USDT, USDC, XRP, XMR, and ZEC. Exposes wallet, invoice, and payment tools over MCP with per-agent spend limits, plus x402 pay-per-call support.59Business Source 1.1
Related MCP Connectors
Agent Commerce Protocol MCP — bridges Stripe ACP + Google AP2 + Coinbase x402 for agent payments
Billing proxy for MCP servers. Adds Stripe and x402 crypto payments without writing billing code.
Solana-native MCP gateway for SAP, DeFi tools, SNS identity, and x402 payments.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/chopmob-cloud/AlgoVoi-Platform-Adapters'
If you have feedback or need assistance with the MCP directory API, please join our Discord server