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 transaction

• prepare_extension_payment — Generate parameters for browser wallet extensions on Algorand/VOI

• verify_webhook — Validate AlgoVoi webhook HMAC-SHA256 signatures

• list_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 402 WWW-Authenticate headers to gate API resources

• verify_mpp_receipt — Confirm an on-chain transaction satisfies an MPP payment requirement (direct indexer)

• generate_x402_challenge — Produce x402 v1 402 Payment Required response headers

• verify_x402_proof — Validate a base64-encoded x402 payment proof against an on-chain transfer (direct indexer)

• generate_ap2_mandate — Create AP2 v0.1 PaymentMandate objects for agent-to-agent payment flows

• verify_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.json

• send_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.

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

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.

{
 "mcpServers": {
 "algovoi": {
 "command": "npx",
 "args": ["-y", "@algovoi/mcp-server"],
 "env": {
 "ALGOVOI_API_KEY": "algv_...",
 "ALGOVOI_API_BASE": "https://cloud.algovoi.co.uk"
 }
 }
 }
}

{
 "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>"
 }
 }
 }
}

# 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