python

algovoi-mcp

MCP server for AlgoVoi — 21 tools across one-shot payments, agent-protocol challenges (MPP / x402 / AP2 / A2A), and Tier 2 standing-authority subscriptions, from any MCP client (Claude Desktop, Claude Code, Cursor, Windsurf).

Tier 1 (one-shot): create payment links, verify payments, prepare extension payments, verify webhooks, list networks, plus MPP / x402 / AP2 / A2A challenge + verify tools — supports all 16 AlgoVoi networks (USDC on Algorand / VOI / Hedera / Stellar mainnet+testnet, plus native ALGO / VOI / HBAR / XLM).

Tier 2 (standing-authority recurring) new in v1.3.0: create / get / list / confirm / revoke / pause / resume / manual-pull authorities — supports all 14 chain ids (7 mainnets + 7 testnets, including Base / Tempo / Solana / Hedera / Stellar). See the parent repo's Recurr/ folder for per-chain wallet-side integration code.

Install

# Via uvx (no global install)
uvx algovoi-mcp

# Or with pip
pip install algovoi-mcp
algovoi-mcp

Requires Python ≥ 3.10.

Configure

Add to your MCP client config (~/.claude.json, ~/.cursor/mcp.json, or claude_desktop_config.json):

{
  "mcpServers": {
    "algovoi": {
      "command": "uvx",
      "args": ["algovoi-mcp"],
      "env": {
        "ALGOVOI_API_KEY": "algv_...",
        "ALGOVOI_TENANT_ID": "your-tenant-uuid",
        "ALGOVOI_PAYOUT_ADDRESS": "YOUR_WALLET_ADDRESS",
        "ALGOVOI_WEBHOOK_SECRET": "optional"
      }
    }
  }
}

Sign up for an AlgoVoi tenant at algovoi.com to get your API key.

Tools

Tool	Purpose
create_payment_link	Hosted-checkout URL for Algorand / VOI / Hedera / Stellar
verify_payment	Check if a checkout token settled (optional tx_id)
prepare_extension_payment	In-page wallet flow params (Algorand / VOI)
verify_webhook	HMAC-SHA256 AlgoVoi webhook verification
list_networks	Supported chains + asset IDs
generate_mpp_challenge	IETF MPP 402 WWW-Authenticate response
verify_mpp_receipt	Verify MPP on-chain receipt
verify_x402_proof	Verify x402 base64 proof

Example prompts

"Create an AlgoVoi payment link for $5 USDC on Algorand, labeled 'Order #42'."

"Verify payment token abc123."

"Generate an MPP 402 challenge for my /premium route, $0.01 per call, on Algorand and VOI."

Dependencies

Only mcp>=1.26.0. The AlgoVoi HTTP client is bundled in the package and uses stdlib urllib.request — no requests / httpx needed.

Development

git clone https://github.com/chopmob-cloud/AlgoVoi-Platform-Adapters
cd AlgoVoi-Platform-Adapters/mcp-server/python
pip install -e ".[test]"
pytest

Run the server directly for debugging:

ALGOVOI_API_KEY=algv_... \
ALGOVOI_TENANT_ID=... \
ALGOVOI_PAYOUT_ADDRESS=... \
  python -m algovoi_mcp

License

Business Source License 1.1 — see LICENSE.