Skip to main content
Glama

AlgoVoi MCP 服务器

一个 MCP (模型上下文协议) 服务器,它将 AlgoVoi 的支付基础设施作为任何 MCP 客户端(Claude Desktop、Claude Code、Cursor、Windsurf 或任何其他兼容 MCP 的助手)可以调用的工具公开。

提供 两个包

安装

命令

TypeScript

npm i -g @algovoi/mcp-server

npx -y @algovoi/mcp-server

Python

pip install algovoi-mcp

uvx algovoi-mcpalgovoi-mcp

两者都公开了 相同的 13 个工具 和相同的 API 接口 —— 选择您客户端偏好的运行时即可。


13 个工具

支付工具

#

工具

功能

1

create_payment_link

为指定金额 + 链生成托管结账 URL

2

verify_payment

验证结账令牌(可选包含 tx_id)

3

prepare_extension_payment

页面内钱包流程参数 (Algorand / VOI)

4

verify_webhook

用于 AlgoVoi Webhook 的 HMAC-SHA256 签名检查

5

list_networks

支持的链 + 资产 ID(离线,无 API 调用)

协议质询工具

#

工具

功能

6

generate_mpp_challenge

IETF MPP 402 WWW-Authenticate 标头 + challenge_id

7

verify_mpp_receipt

验证 MPP 链上收据(直接索引器,无 API 调用)

8

verify_x402_proof

验证 x402 base64 支付证明(直接索引器)

9

generate_x402_challenge

x402 X-Payment-Required 402 标头 + 有效载荷

10

generate_ap2_mandate

用于 AI 代理支付流程的 AP2 v0.1 PaymentMandate

11

verify_ap2_payment

验证 AP2 授权支付收据(直接索引器)

A2A 代理工具 (v1.2.0 新增)

#

工具

功能

12

fetch_agent_card

GET {agent_url}/.well-known/agent.json — 在调用前发现 A2A 代理的功能和支付要求

13

send_a2a_message

POST {agent_url}/message:send — 调用受支付限制的 A2A v1.0 代理;在 200 时返回任务结果,或在 402 时返回 challenge_headers 以便 Claude 可以支付并重试

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

支持的网络:AlgorandVOIHederaStellar(所有四个网络上的 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_API_KEY

来自 AlgoVoi 仪表板的 algv_... API 密钥

ALGOVOI_TENANT_ID

来自 AlgoVoi 仪表板的租户 UUID

ALGOVOI_PAYOUT_ALGORAND

*

Algorand 支付钱包地址

ALGOVOI_PAYOUT_VOI

*

VOI 支付钱包地址

ALGOVOI_PAYOUT_HEDERA

*

Hedera 支付账户 (例如 0.0.123456)

ALGOVOI_PAYOUT_STELLAR

*

Stellar 支付地址 (G...)

ALGOVOI_PAYOUT_ADDRESS

如果未设置各链变量,则作为通用回退

ALGOVOI_WEBHOOK_SECRET

用于 verify_webhook

ALGOVOI_API_BASE

覆盖 AlgoVoi API 基础 URL (默认: https://cloud.algovoi.co.uk)

* 至少需要一个各链地址(或作为回退的 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.json

  • Cursor: ~/.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 授权。

Install Server
F
license - not found
A
quality
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity
Issues opened vs closed

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

  • A
    license
    Not graded
    quality
    B
    maintenance
    A 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.
    1
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    A 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.
    59
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    Keyless 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).
    6
    3
    69
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Non-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.
    59
    Business Source 1.1

View all related MCP servers

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.

View all MCP Connectors

Latest Blog Posts

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