AlgoVoi MCP Server
The AlgoVoi MCP Server exposes 13 tools for integrating blockchain payment infrastructure into MCP-compatible clients (Claude Desktop, Cursor, Windsurf, etc.) across Algorand, VOI, Hedera, and Stellar networks.
Payment Tools:
create_payment_link— Generate a hosted checkout URL for a given amount and network (USDC, ALGO, VOI, HBAR, XLM)verify_payment— Check whether a checkout token has been settled, optionally verifying a specific on-chain transactionprepare_extension_payment— Generate parameters for browser wallet extensions on Algorand/VOIverify_webhook— Validate AlgoVoi webhook HMAC-SHA256 signatureslist_networks— Retrieve supported blockchains with asset IDs, decimals, and CAIP-2 identifiers (offline, no API call)
Protocol Challenge Tools:
generate_mpp_challenge— Create IETF MPP 402WWW-Authenticateheaders to gate API resourcesverify_mpp_receipt— Confirm an on-chain transaction satisfies an MPP payment requirement (direct indexer)generate_x402_challenge— Produce x402 v1402 Payment Requiredresponse headersverify_x402_proof— Validate a base64-encoded x402 payment proof against an on-chain transfer (direct indexer)generate_ap2_mandate— Create AP2 v0.1PaymentMandateobjects for agent-to-agent payment flowsverify_ap2_payment— Confirm an on-chain transaction satisfies an AP2 mandate's amount and recipient
A2A Agent Tools:
fetch_agent_card— Discover an A2A agent's capabilities and payment requirements via/.well-known/agent.jsonsend_a2a_message— Call a payment-gated A2A v1.0 agent, automatically handling 402 challenges for payment and retry
Enables merchants to accept stablecoin payments settled on the Algorand blockchain through AlgoVoi's payment infrastructure, supporting USDC (ASA ID 31566704) and native ALGO payments.
Provides a live-tested Python webhook adapter for the Allegro marketplace (Poland/CEE) to integrate AlgoVoi payment flows, verified across all 4 supported blockchains.
Offers an Amazon SP-API webhook adapter (Python) for connecting Amazon Marketplace Web Services to AlgoVoi's payment infrastructure for stablecoin settlements.
Includes a BigCommerce webhook adapter (partial implementation) for integrating AlgoVoi payment flows into BigCommerce stores.
Hosts the x402 embeddable payment widget for any HTML page on Cloudflare Pages, providing a ready-to-use payment interface component.
Offers a CrewAI gate for multi-agent crews, enabling payment-gated access to crew.kickoff() and BaseTool functionality with MPP, AP2, and x402 support.
Provides a Discord interactions payment adapter with Ed25519 signing for integrating AlgoVoi payment flows into Discord applications.
Includes a Drupal Commerce payment gateway module for Drupal 10/11 with Commerce 2/3, enabling stablecoin payments through AlgoVoi.
Offers an eBay Platform Notifications adapter for integrating AlgoVoi payment flows with eBay marketplace transactions.
Provides an Etsy webhook adapter for connecting Etsy shops to AlgoVoi's payment infrastructure for stablecoin settlements.
Includes an Instagram & Facebook Shops adapter for integrating AlgoVoi payment flows with Facebook's e-commerce platforms.
Offers a Flipkart Seller API adapter (India) for connecting Flipkart marketplace to AlgoVoi's payment infrastructure.
Provides a Ghost 5.x paid-membership grant-on-payment adapter for integrating AlgoVoi payments with Ghost membership platforms.
Includes payment-gated Google Gemini API wrappers with MPP, AP2, and x402 challenge generation for payment-controlled access to Gemini services.
Enables merchants to accept stablecoin payments settled on the Hedera blockchain through AlgoVoi's payment infrastructure, supporting USDC (HTS token 0.0.456858) and native HBAR payments.
Provides a Hugging Face gate for InferenceClient, transformers pipelines, and smolagents tools with payment-gated access via MPP, AP2, and x402 challenges.
Includes an Instagram & Facebook Shops adapter for integrating AlgoVoi payment flows with Instagram's shopping features.
Offers a LangChain gate for any ChatModel, LCEL chain, RAG pipeline, or ReAct agent with payment-controlled access through MPP, AP2, and x402 challenges.
Provides a LangGraph gate for StateGraph invoke/stream, ToolNode, and create_react_agent functionality with payment-gated access via MPP, AP2, and x402.
Includes a Make (Integromat) adapter with webhook verification, challenge generation, and support for all 16 networks to bridge AlgoVoi payments into no-code workflows.
Offers a MYOB AccountRight poll-based adapter for integrating AlgoVoi payment flows with MYOB accounting software.
Provides an n8n adapter with webhook verification, challenge generation, and support for all 16 networks to integrate AlgoVoi payments into n8n automation workflows.
Includes payment-gated OpenAI/compatible API wrappers with MPP, AP2, and x402 challenge generation for payment-controlled access to AI services.
Provides a framework-free PHP adapter for integrating AlgoVoi payment flows into PHP applications without external dependencies.
Offers PrestaShop 8 modules (hosted + wallet) for integrating AlgoVoi payment infrastructure into PrestaShop e-commerce stores.
Includes a Pydantic AI gate for any Agent, dependencies injection, and provider:model strings with payment-gated access via MPP, AP2, and x402.
Provides a stdlib-only Python adapter for integrating AlgoVoi payment flows into Python applications without external dependencies.
Offers a QuickBooks Online invoice adapter for integrating AlgoVoi payment flows with QuickBooks accounting software.
Provides a Rakuten marketplace adapter for connecting Rakuten e-commerce platform to AlgoVoi's payment infrastructure.
Includes a zero-crate Rust library for integrating AlgoVoi payment flows into Rust applications without external dependencies.
Offers a Sage Business Cloud invoice adapter for integrating AlgoVoi payment flows with Sage accounting software.
Provides a Shopee open platform adapter (SE Asia) for connecting Shopee marketplace to AlgoVoi's payment infrastructure.
Includes a private Shopify payment app (Cloudflare Pages) for integrating AlgoVoi payments with Shopify stores (not distributed).
Offers a Shopware 6 plugin with Symfony handlers for integrating AlgoVoi payment infrastructure into Shopware e-commerce stores.
Provides a Squarespace Commerce webhook adapter (Python) for integrating AlgoVoi payment flows with Squarespace websites.
Enables merchants to accept stablecoin payments settled on the Stellar blockchain through AlgoVoi's payment infrastructure, supporting USDC and native XLM payments (requires trust line setup).
Used in Shopware 6 plugin implementation with Symfony handlers for integrating AlgoVoi payment infrastructure.
Provides a Telegram Bot payment adapter for integrating AlgoVoi payment flows into Telegram bot applications.
Offers a TikTok Shop Open Platform adapter (Python) for connecting TikTok Shop to AlgoVoi's payment infrastructure.
Includes the @algovoi/mcp-server npm package for TypeScript implementation of the MCP server exposing AlgoVoi tools.
Provides a Vercel AI SDK gate for generateText, streamText, and tool() functions with payment-controlled access via MPP, AP2, and x402 challenges.
Offers a Walmart Marketplace adapter for connecting Walmart e-commerce platform to AlgoVoi's payment infrastructure.
Provides a WhatsApp Business API adapter for integrating AlgoVoi payment flows with WhatsApp Business applications.
Includes a Wix Payment Provider SPI (Velo) adapter for integrating AlgoVoi payment flows with Wix websites.
Offers a WooCommerce plugin (single PHP file) for integrating AlgoVoi payment infrastructure into WooCommerce stores.
Includes Easy Digital Downloads (EDD) WordPress plugin for digital downloads and licensing with AlgoVoi payment integration.
Provides a Xero invoice payment adapter for integrating AlgoVoi payment flows with Xero accounting software.
Includes a Zapier adapter with webhook verification, challenge generation, and support for all 16 networks to bridge AlgoVoi payments into Zapier automation workflows.
Offers a Zoho Books invoice adapter for integrating AlgoVoi payment flows with Zoho accounting software.
AlgoVoi MCP Server
An MCP (Model Context Protocol) server that exposes AlgoVoi's payment infrastructure as tools any MCP client can call — Claude Desktop, Claude Code, Cursor, Windsurf, or any other MCP-compatible assistant.
Ships as two packages:
Package | Install | Command |
|
| |
|
|
Both packages now expose all 21 tools (13 Tier 1 + 8 Tier 2 standing-authority recurring tools, both shipped at v1.3.0). Pick whichever runtime your MCP client / deployment stack prefers — same surface, same JSON Schema definitions, same Pydantic-strict / extra-forbid validation.
Tools
Payment tools
# | Tool | What it does |
1 |
| Hosted-checkout URL for a given amount + chain |
2 |
| Verify a checkout token (optionally with a tx_id) |
3 |
| In-page wallet-flow params (Algorand / VOI) |
4 |
| HMAC-SHA256 signature check for AlgoVoi webhooks |
5 |
| Supported chains + asset IDs (offline, no API call) |
Protocol challenge tools
# | Tool | What it does |
6 |
| IETF MPP 402 |
7 |
| Verify an MPP on-chain receipt (direct indexer, no API call) |
8 |
| Verify an x402 base64 payment proof (direct indexer) |
9 |
| x402 |
10 |
| AP2 v0.1 |
11 |
| Verify an AP2 mandate payment receipt (direct indexer) |
A2A agent tools (new in v1.2.0)
# | Tool | What it does |
12 |
|
|
13 |
|
|
A2A pay-and-call flow
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 returnedSupported networks: Algorand, VOI, Hedera, Stellar (USDC on all four + native ALGO/VOI/HBAR/XLM).
Tier 2 — Standing-authority recurring tools (new in v1.3.0 — both TS and Python)
Tier 2 is "customer signs ONCE, AlgoVoi auto-pulls per cycle" — the subscription / agent-bound spending pattern. Each chain uses its native authorisation primitive (no custom escrow contracts on the merchant side):
# | Tool | What it does |
14 |
| Open a new standing authority. Returns chain-specific |
15 |
| Read current state (status, cycles_pulled, cap_remaining, etc.) |
16 |
| List all authorities for this tenant; filter by status / subscription_id |
17 |
| Mark active after on-chain landing (most flows skip this — webhook does it) |
18 |
| Chain-side revocation (customer's wallet signs the revoke tx) |
19 |
| Off-chain pause (no chain action) |
20 |
| Off-chain resume |
21 |
| Tenant-initiated catch-up / proration pull |
Per-chain authorisation primitives
Chain | Primitive |
Algorand / VOI | SpendingCapVault (6-action atomic group) |
Base / Tempo | ERC-20 |
Solana | SPL Token |
Hedera | HTS |
Stellar | Soroban |
Subscription flow
1. create_recurring_authority(subscription_id, chain, customer_wallet,
cap_amount_minor, cap_period_seconds,
per_cycle_amount_minor)
→ customer_signing_payload returned
2. Hand template to wallet (Pera / Defly / MetaMask / Phantom /
HashPack / Freighter / etc.)
→ customer signs the chain-native authorisation tx
3. confirm_authority(authority_id, on_chain_address)
→ status: 'pending' → 'active'
4. AlgoVoi cycle reaper auto-pulls per cap_period_seconds.
Each pull emits subscription.charged or subscription.payment_failed
webhooks (verify with verify_webhook).
5. Lifecycle: revoke_authority / pause_authority / resume_authority /
manual_pull as needed.Per-chain wallet-side integration: see ../Recurr/<chain>/README.md for
each chain's customer-side flow.
Supported networks: all 14 (7 mainnets + 7 testnets) — Algorand, VOI, Base, Tempo, Solana, Hedera, Stellar.
Related MCP server: ShieldZ Crypto Payments
Two ways to connect
Option A — AlgoVoi Cloud (recommended)
AlgoVoi Cloud is the control plane for all your integrations — WooCommerce, Zapier, n8n, and MCP all in one dashboard. Point ALGOVOI_API_BASE at https://cloud.algovoi.co.uk and your single algv_... API key covers every integration — no tenant ID or payout addresses needed (they're stored in the dashboard).
{
"mcpServers": {
"algovoi": {
"command": "npx",
"args": ["-y", "@algovoi/mcp-server"],
"env": {
"ALGOVOI_API_KEY": "algv_...",
"ALGOVOI_API_BASE": "https://cloud.algovoi.co.uk"
}
}
}
}Every payment Claude creates appears in your Cloud dashboard alongside payments from every other platform. One place to see everything.
Sign up free at dash.algovoi.co.uk.
Option B — AlgoVoi direct
Connect straight to the AlgoVoi API with your algv_... key and tenant ID.
Both packages read the same env vars:
Var | Required | Purpose |
| ✅ |
|
| ✅ | Tenant UUID from the AlgoVoi dashboard |
| ✅* | Algorand payout wallet address |
| ✅* | VOI payout wallet address |
| ✅* | Hedera payout account (e.g. |
| ✅* | Stellar payout address ( |
| — | Universal fallback if per-chain vars are not set |
| — | For |
| — | Override the AlgoVoi API base URL (default: |
* At least one per-chain address (or ALGOVOI_PAYOUT_ADDRESS as fallback) is required.
Auth is env-var only. Secrets never pass through tool arguments — the MCP client never sees the API key.
Sign up at www.algovoi.co.uk to get your API key and tenant 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>"
}
}
}
}For the Python package, swap "command": "uvx", "args": ["algovoi-mcp"].
Config file locations:
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
Testing
# 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.pyLicensed under the Business Source License 1.1.
Available Tools
11 toolscreate_payment_linkA
Create a hosted AlgoVoi checkout URL for a given amount and chain. Returns a short token and public URL the customer can visit to pay in USDC or native tokens (Algorand / VOI / Hedera / Stellar).
Inputs: amount (required), currency (required), label (required), network (required), +2 more.
generate_ap2_mandateA
Generate an AP2 v0.1 PaymentMandate for agent-to-agent payment. Returns the mandate object and its base64 encoding for the AP2-Payment-Required header. After the paying agent submits on-chain, call verify_ap2_payment to confirm.
Inputs: resource_id (required), amount_microunits (required), network, expires_in_seconds, +1 more.
generate_mpp_challengeA
Generate an IETF MPP (draft-ryan-httpauth-payment) 402 challenge that an API server can return to gate a resource. Produces the WWW-Authenticate and X-Payment-Required headers plus the challenge_id to echo.
Inputs: resource_id (required), amount_microunits (required), networks, expires_in_seconds.
generate_x402_challengeA
Generate an x402 (spec v1) 402 Payment Required response for gating a resource. Returns the X-Payment-Required header value and full payload. The client must pay on-chain and re-send with X-Payment: , then verify with verify_x402_proof.
Inputs: resource (required), amount_microunits (required), network, expires_in_seconds, +1 more.
list_networksA
List the blockchain networks AlgoVoi supports, with asset IDs, decimals, and CAIP-2 identifiers. Offline tool — no API call.
Inputs: no named parameters.
prepare_extension_paymentA
Prepare an in-page wallet-extension payment (Algorand / VOI only). Returns the token and chain parameters a frontend can use to ask a browser wallet to sign and submit the transfer, then verify with verify_payment + tx_id.
Inputs: amount (required), currency (required), label (required), network (required).
verify_ap2_paymentA
Verify an AP2 payment — returns {verified: true} if the on-chain transaction satisfies the mandate's amount and recipient.
Inputs: mandate_id (required), tx_id (required), network (required).
verify_mpp_receiptB
Verify an MPP receipt (on-chain transaction ID) for a given resource — returns {verified: true} if the transaction paid the resource's declared amount to the tenant's payout address.
Inputs: resource_id (required), tx_id (required), network (required).
verify_paymentA
Verify that a payment for a given checkout token has settled. Returns paid/unpaid status. If tx_id is supplied, verifies that specific on-chain transaction; otherwise uses hosted-checkout status.
Inputs: token (required), tx_id.
verify_webhookA
Verify an AlgoVoi webhook HMAC-SHA256 signature. Returns {valid: true, payload: } if the signature matches the server's configured webhook secret (ALGOVOI_WEBHOOK_SECRET env var — never passed as a tool argument).
Inputs: raw_body (required), signature (required).
verify_x402_proofA
Verify a base64-encoded x402 payment proof against a given network — returns {verified: true} if the proof corresponds to a confirmed on-chain transfer to the tenant's payout address.
Inputs: proof (required), network (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Most tools have distinct purposes, such as create_payment_link for hosted checkout and generate_ap2_mandate for agent-to-agent payments. However, the three challenge-generation tools (generate_ap2_mandate, generate_mpp_challenge, generate_x402_challenge) could be confusing due to overlapping concepts of payment challenges, though their specific protocols help differentiate them.
All tool names follow a consistent verb_noun pattern with snake_case, such as create_payment_link, verify_payment, and list_networks. This uniformity makes the tool set predictable and easy to navigate, with no deviations in naming conventions.
With 11 tools, the server is well-scoped for handling blockchain payments and verifications. Each tool serves a clear function, such as payment creation, verification, and network listing, without feeling excessive or insufficient for the domain of payment processing and validation.
The tool set provides comprehensive coverage for the payment domain, including creation (e.g., create_payment_link), verification (e.g., verify_payment, verify_ap2_payment), and support tools (e.g., list_networks, verify_webhook). There are no obvious gaps, as it covers multiple payment protocols and lifecycle stages from initiation to confirmation.
Maintenance
Related MCP Connectors
Agent Commerce Protocol MCP — bridges Stripe ACP + Google AP2 + Coinbase x402 for agent payments
Pay-per-action access to APIs and MCP tools over Lightning L402 and Base USDC x402.
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.
Related MCP Servers
- 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.ISC
- AlicenseAqualityDmaintenanceKeyless 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).388 npmMIT
- AlicenseNot gradedqualityCmaintenanceAn MCP server for agentic commerce, enabling AI agents to discover services, make x402 payments with USDC across multiple chains, and manage crypto wallets and token swaps.598 npm1MIT
- AlicenseAqualityBmaintenancePayment infrastructure MCP server enabling AI agents to make gasless USDC payments on Base and JIT single-use virtual card checkouts, with zero-trust card handling, merchant checkout hints, and signed receipts.13348 npm1MIT