
Algovoi Mcp Server
io.github.chopmob-cloudPublished by GitHub account chopmob-cloudv1.1.3Updated Oct 27, 2026
AlgoVoi crypto payments via MCP: USDC + native on Algorand, VOI, Hedera, Stellar.
Overview
AlgoVoi MCP server that puts crypto payment tools for USDC and native tokens on Algorand, VOI, Hedera and Stellar inside an AI assistant.
- What you can do
- Create and manage crypto payment requests and hosted checkout links across Algorand, VOI, Hedera, Stellar, Base, Solana and Tempo
- Check payment status and confirm settlements via webhook or API status lookup
- Verify incoming webhook signatures when a webhook secret is configured
- Work with payout wallet addresses and tenant settings for direct API access or AlgoVoi Cloud
- Expose the same payment capabilities to AI assistants such as Claude, Cursor and Windsurf
- When to use it
- Useful when you want an assistant to create, track or reconcile crypto payments for an online store, donation flow or AI-agent payment gate, or to check whether an invoice has been settled on-chain.
- Requirements
- Runs locally over stdio as an npm or PyPI package. Needs an AlgoVoi API key in ALGOVOI_API_KEY, obtained from the AlgoVoi dashboard. ALGOVOI_API_BASE selects the API host; ALGOVOI_TENANT_ID and ALGOVOI_PAYOUT_ADDRESS are needed only for direct API access, not for AlgoVoi Cloud. Network access to the AlgoVoi API is required.
Installation
In SourceWeft
- Open Algovoi Mcp Server in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
AlgoVoi is available for acquisition — docs.algovoi.co.uk/acquisition
AlgoVoi Platform Adapters
Drop-in payment adapters for connecting e-commerce platforms, AI agent frameworks, and automation tools to AlgoVoi — a compliance-aware crypto payment gateway where agents negotiate a shared stablecoin settlement lane: seven native mainnet chains, with cross-chain settlement negotiated between agents on any two of them. The adapters in this repository are end-to-end tested on the seven native chains (Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo).
What is AlgoVoi?
AlgoVoi is compliance-aware payment infrastructure for stablecoin settlement. The same gateway that negotiates settlement across seven native mainnet chains — in any cross-chain pairing among them — also runs continuous sanctions screening, KYB gating, and a write-once SHA-256 audit chain on every payment — so merchants and autonomous agents don't quietly carry UK MLRs / OFAC / SAMLA exposure they didn't sign up for. Compliance posture is published live at /compliance/attestation.
The compliance perimeter is the product. Multi-chain breadth — seven native mainnet chains (Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo), with settlement negotiated between agents on any two of them rather than fixed to one — and protocol coverage (x402, MPP, AP2, A2A) are how we deliver it on a single endpoint, without merchants having to manage wallets or blockchain integrations directly.
Supported settlement assets:
These seven are the native chains; agents on different chains negotiate a shared lane and settle once, any cross-chain pairing among them. The hosted AlgoVoi pay rail additionally settles natively on Arc, Monad, Polygon, Arbitrum and OP Mainnet. The platform integration guides and adapter smoke tests in this repository cover the seven native chains above.
What is this repository?
This repository contains production-ready payment adapters and integration documentation for connecting e-commerce platforms, custom applications, and AI agent services to AlgoVoi Tenant Services.
Included:
- Recurring / standing-authority subscriptions (
Recurr/) — Tier 2 lets a customer sign ONCE and AlgoVoi auto-pulls per cycle on all 7 chains (Algorand SpendingCapVault, EVM ERC-20 approve, Solana SPL Approve, Hedera HTS allowance, Stellar Soroban auth_entry, VOI). Per-chain wallet-side reference flows + chain-agnostic merchant-side examples.native-python/algovoi.pyv1.2.0+ ships the merchant HTTP wrappers (8 lifecycle methods) - Drop-in plugins for WooCommerce, OpenCart, PrestaShop, and Shopware (tested and deployed)
- CMS payment gateways for Drupal Commerce, Easy Digital Downloads (WordPress), and Ghost — all Comet-validated 2026-04-15
- Native adapters for PHP, Python, Go, Rust, and TypeScript (zero external dependencies) — all at v1.2.0 with full Tier 2 (recurring) surface
- Agent protocol middleware for MPP and AP2 (gate APIs behind payment challenges)
- AI platform adapters for OpenAI, Claude, Gemini, Bedrock, Cohere, xAI/Grok, and Mistral (MPP + AP2 + x402, all 7 chains)
- AI agent framework adapters for LangChain, LlamaIndex, CrewAI, Hugging Face, AutoGen, Semantic Kernel, Pydantic AI, DSPy, Vercel AI SDK, Google A2A, LangGraph, and Agno — gate LLM-agnostic pipelines, RAG chains, multi-agent crews, and autonomous agents (MPP + AP2 + x402, all 7 chains)
- No-code / automation adapters for Zapier, Make (Integromat), n8n, and X (Twitter) — drop-in Python classes that bridge AlgoVoi payment flows into any no-code workflow, with webhook verification, MPP + x402 + AP2 challenge generation, and all 14 networks (7 mainnet + 7 testnet); the X adapter auto-posts payment confirmations and checkout links to X via webhook (OAuth 1.0a, stdlib-only, 4-chain mainnet verified 2026-04-18)
- MCP server (
@algovoi/mcp-server/algovoi-mcp) — exposes 13 AlgoVoi tools natively inside Claude Desktop, Claude Code, Cursor, and Windsurf via the Model Context Protocol - x402 embeddable widget for any HTML page (Cloudflare Pages)
- Integration guides and Python adapters for 45+ platforms — all end-to-end tested on
api.algovoi.co.ukacross all 7 chains
AlgoVoi Cloud — No-Code Dashboard
The fastest way to accept stablecoin payments — no server access or code required. dash.algovoi.co.uk is the hosted SaaS version of AlgoVoi: sign up with your email, verify your identity, and connect your platforms through a guided dashboard wizard. Each wizard takes under 5 minutes.
Sign up
- Go to dash.algovoi.co.uk/signup
- Enter your email and choose your account type (Individual, Sole Trader, or Company)
- Your AlgoVoi API key is shown once on screen — copy it immediately
- Complete KYC/KYB verification in the dashboard to unlock mainnet payments
Supported chains: Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo
Connect a platform
After signing in, open Connect from the sidebar. Every integration has a setup badge:
E-commerce
Automation
Messaging Bots
AI Assistants
KYC / KYB verification
Before your first mainnet payment, upload the required documents through the Onboarding page:
Accepted formats: PDF, JPEG, PNG, WebP — max 50 MB per file. The dashboard auto-advances to active status when all required documents are collected.
Repository structure
Live-tested adapters
The following adapters have been end-to-end tested against a live AlgoVoi tenant on algorand_mainnet, voi_mainnet, hedera_mainnet, stellar_mainnet, base_mainnet, and solana_mainnet:
Last webhook test: 14 April 2026 — all 39 testable adapters passed on all 4 original chains (algorand_mainnet, voi_mainnet, hedera_mainnet, stellar_mainnet); Base and Solana added 2026-04-22/23. Checkout pages validated live via Comet CDP. 6 adapters skipped: BigCommerce (partial — order-amount fetch needs real API credentials), Discord (Ed25519), TrueLayer (ES512), Faire/Jumia/Printify (docs only).
Accounting adapters unit tests: 339 passing, 0 failing (includes replay attack prevention coverage — commit 5025c4e)
AI agent adapters — production ready as of 13 April 2026:
- x402: spec v1 compliant —
x402Version: 1,acceptsarray, CAIP-2 network IDs, string microunit amounts,payload.signatureproof format. Real payments smoke-tested on all 4 original chains (Algorand, VOI, Stellar, Hedera mainnet); Base and Solana added 2026-04-22/23.x402/verifyconfirmedverified:trueon each. 76/76 unit tests passing. Adapter v2.0.0. - MPP: 100% IETF spec compliant (v2.1.0) —
id(HMAC-SHA256),method,intent="charge",request=(charge intent object),expires, challenge echo validation (Table 3), CAIP-2 network routing, replay protection, spec-compliantPayment-Receipt. On-chain verification smoke-tested on all 4 original chains (Algorand, VOI, Hedera, Stellar) 13 Apr 2026 ×2; Base and Solana added 2026-04-22/23. 153/153 unit tests. - AP2: production ready (v2.0.0) — AP2 v0.1 CartMandate/PaymentMandate with AlgoVoi crypto-algo extension. CartMandate issues
PaymentMethodDataper extension schema (network,receiver,amount_microunits,asset_id,min_confirmations,memo_required). PaymentMandate acceptspayment_response.details.{network, tx_id, note_field}. ed25519 sig + on-chain AVM verification. PyNaCl + cryptography fallback both confirmed. 81/81 tests.
Two payment flows
Hosted checkout — Customer is redirected to a secure AlgoVoi-hosted payment page. Supports Algorand, VOI, Hedera, Stellar, Base, Solana, and Tempo. Works with any wallet (Pera, Defly, Lute, HashPack, Freighter, LOBSTR, MetaMask, Phantom, …). Payment confirmed via webhook or API status check. Used by all platforms including Shopify.
Extension payment — Customer pays directly on the store page using the AlgoVoi browser extension and algosdk. Supports Algorand and VOI only (AVM chains). Buyers paying on Hedera or Stellar use hosted checkout with their chain-native wallet. No redirect required for extension flow. Available on WooCommerce, OpenCart, PrestaShop, and Shopware.
Shopify checkout extension — "Pay with Crypto →" link rendered on the thank-you page via Shopify Checkout UI Extension (Preact). Customer selects their chain on a dedicated pay page. Webhook automatically adds payment link to order notes.
E-commerce integrations
CMS integrations
Drop-in payment gateways for major content-management and publishing platforms. All three were shipped together on 15 April 2026 and Comet-validated end-to-end. Each adapter applies the full April 2026 + pass-2 hardening set (cancel-bypass guard, empty-secret HMAC reject, timing-safe compare, 64 KB body cap, https-only outbound, amount sanity, scheme guards, token length caps, mandatory payment cross-check on webhooks).
Each adapter folder ships a README.md with a how-it-works diagram, quick-start, supported chains, webhook endpoint, security posture table, and dependency list.
Regional & international marketplace integrations
All regional marketplace adapters have been end-to-end tested on 14 April 2026 across all 4 original chains; Base and Solana added 2026-04-22/23. Checkout pages validated live via Comet CDP.
Accounting integrations
All 7 accounting adapters are end-to-end tested on 14 April 2026 against api.algovoi.co.uk across all 4 original chains (28/28 pass); Base and Solana added 2026-04-22/23.
Adapter source is not publicly distributed. Integration guides are below. Download your adapter from the AlgoVoi dashboard after signing in with your API key.
Social commerce integrations
Financial services integrations
AI agent & machine payment adapters
AI Platform Adapters
Drop-in payment gates for AI provider APIs. Each adapter wraps the AI call behind an on-chain payment check — the caller pays 0.01 USDC (or any configured amount) before the AI responds. All adapters accept OpenAI-format message lists and share a common interface: check(headers, body) → result, complete(messages) → str, flask_guard() convenience method.
All adapters support all 7 chains (Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo) and all 3 payment protocols (MPP, AP2, x402).
OpenAI — MPP Quick start
Supports any OpenAI-compatible provider via base_url:
OpenAI — AP2 Quick start
Claude — Quick start
Models: claude-opus-4-7 · claude-sonnet-4-6 (default) · claude-haiku-4-5-20251001
Gemini — Quick start
Models: gemini-2.0-flash (default) · gemini-2.0-flash-lite · gemini-2.5-pro
Bedrock — Quick start
Models (any model exposed by Bedrock Converse in your AWS region/account):
amazon.nova-pro-v1:0 (default) · amazon.nova-lite-v1:0 · anthropic.claude-3-5-sonnet-20241022-v2:0 · meta.llama3-70b-instruct-v1:0 · amazon.titan-text-premier-v1:0
Cohere — Quick start
Models: command-r-plus-08-2024 (default — most capable) · command-r-08-2024 (balanced) · command-r7b-12-2024 (fastest)
xAI (Grok) — Quick start
Models: grok-4 (default — latest, most capable) · grok-3 · grok-3-mini (fast + cheap) · grok-2-1212 · grok-2-vision-1212
Mistral — Quick start
Models: mistral-large-latest (default — flagship) · mistral-medium-latest · mistral-small-latest · codestral-latest · open-mistral-nemo · pixtral-large-latest
OpenAI-format messages work across all seven platforms — system roles are extracted automatically where required (Claude, Bedrock), Gemini assistant roles are mapped to model internally, and Cohere, xAI, and Mistral all accept the system role natively via their respective SDKs.
AI Agent Framework Adapters
Gate entire orchestration frameworks behind on-chain payment — not just a single model provider. These adapters are LLM-agnostic: pass any pre-built ChatModel, LCEL chain, RAG pipeline, or ReAct agent and the payment check wraps the whole thing.
LangChain — Quick start
Bring your own model — pass any pre-built LangChain ChatModel instead of an OpenAI key:
Gate any LCEL chain or RAG pipeline:
Drop into a ReAct agent as a BaseTool:
The tool accepts {"query": "...", "payment_proof": "<base64>"}. Returns a challenge JSON dict if proof is absent or invalid; calls resource_fn(query) and returns the result if verified.
All 7 chains and all 3 protocols supported. Full reference: ai-agent-frameworks/langchain/README.md
LlamaIndex — Quick start
ReAct agent tool — drop into any LlamaIndex agent:
The tool accepts {"query": "...", "payment_proof": "<base64>"}. Returns a ToolOutput with .content (challenge JSON or resource result), .tool_name, .raw_input, .raw_output.
Bring your own LlamaIndex LLM (Anthropic, Google, Cohere, Bedrock, etc.):
All 7 chains and all 3 protocols supported. Full reference: ai-agent-frameworks/llamaindex/README.md
CrewAI — Quick start
Add AlgoVoiPaymentTool to any CrewAI agent:
The tool uses PaymentToolInput (Pydantic args_schema) — the agent generates {"query": "...", "payment_proof": "<base64>"}, CrewAI validates it, and _run(query, payment_proof) is called directly as kwargs. Any crewai.LLM provider (OpenAI, Anthropic, Gemini, Bedrock, Groq, Together AI, …) is supported via the LiteLLM router.
All 7 chains and all 3 protocols supported. Full reference: ai-agent-frameworks/crewai/README.md
Hugging Face — Quick start
Drop into a smolagents ToolCallingAgent:
The tool accepts query and payment_proof (base64) as kwargs. Returns challenge JSON if proof absent/invalid; calls resource_fn(query) and returns the result if verified. Works with any smolagents agent type (ToolCallingAgent, CodeAgent, custom).
All 7 chains and all 3 protocols supported. Full reference: ai-agent-frameworks/huggingface/README.md
AutoGen — Quick start
Callable tool — AutoGen 0.2.x:
AutoGen 0.4.x FunctionTool:
All 7 chains and all 3 protocols supported. Full reference: ai-agent-frameworks/autogen/README.md
Semantic Kernel — Quick start
Add as a @kernel_function plugin:
The gate function accepts query and payment_proof (base64). Returns challenge JSON if proof absent/invalid; calls resource_fn(query) and returns the result if verified.
All 7 chains and all 3 protocols supported. Full reference: ai-agent-frameworks/semantic-kernel/README.md
Pydantic AI — Quick start
Add as a pydantic_ai.tools.Tool:
The tool accepts query and payment_proof (base64). Returns challenge JSON if proof absent/invalid; calls resource_fn(query) if verified. Supports all Pydantic AI providers — OpenAI, Anthropic, Google, Groq, Ollama, and any OpenAI-compatible endpoint via base_url.
All 7 chains and all 3 protocols supported. Full reference: ai-agent-frameworks/pydantic-ai/README.md
DSPy — Quick start
Gate a compiled DSPy program:
Drop into a ReAct agent as a plain callable tool:
All LLM calls use dspy.context(lm=...) — global dspy.configure() state is never modified. DSPy's provider/model string format is supported for OpenAI, Anthropic, Google, Cohere, Groq, Ollama, and Azure OpenAI.
All 7 chains and all 3 protocols supported. Full reference: ai-agent-frameworks/dspy/README.md
Vercel AI SDK — Quick start
Streaming:
Payment tool for LLM function calling:
Supports any @ai-sdk/* provider — OpenAI, Anthropic, Google, Groq, Mistral, Cohere, Ollama, Azure. Uses node:crypto for MPP HMAC; requires Node.js runtime (not Edge) for MPP. x402 and AP2 work on Edge runtimes.
All 7 chains and all 3 protocols supported. Full reference: ai-agent-frameworks/vercel-ai-sdk/README.md
Google A2A — Quick start
All 7 chains and all 3 protocols supported. Full reference: ai-agent-frameworks/a2a/README.md
No-Code / Automation Adapters
Drop-in Python classes that bridge AlgoVoi crypto payment flows into Zapier, Make (Integromat), and n8n — the three leading no-code / low-code automation platforms. Each adapter is a single file with zero external dependencies (stdlib HTTP only), mirrors the native Python adapter pattern, and applies the full April 2026 + pass-2 security hardening.
All three adapters were shipped on 17 April 2026 and are Comet-validated end-to-end.
Total: 225/225 tests · 21/21 smoke checks (Phase 1) · 3/3 live create_payment_link + verify_payment (Phase 2)
Supported across all 14 networks (7 mainnet + 7 testnet) on Algorand, VOI, Hedera, Stellar, Base, Solana, and Tempo. All three adapters support MPP, x402, and AP2 challenge generation.
Zapier — Quick start
Make (Integromat) — Quick start
n8n — Quick start
Full reference: no-code/README.md
MCP Server
An MCP (Model Context Protocol) server that exposes AlgoVoi's payment infrastructure as tools directly inside Claude Desktop, Claude Code, Cursor, Windsurf, and any other MCP-compatible AI assistant. Ships as two packages — pick whichever runtime your client supports:
13 built-in tools
Quick start — Claude Desktop / Claude Code / Cursor
Single-chain users only need to set the env var for their chain — the others are optional. For Base use ALGOVOI_PAYOUT_BASE; for Solana use ALGOVOI_PAYOUT_SOLANA. For the Python package, swap "command": "uvx", "args": ["algovoi-mcp"].
Config file locations: Claude Desktop %APPDATA%\Claude\claude_desktop_config.json (Windows) / ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) · Claude Code ~/.claude.json · Cursor ~/.cursor/mcp.json
Full reference: mcp-server/README.md · TypeScript source: mcp-server/typescript/ · Python source: mcp-server/python/
Charity Interfaces
Pre-built, self-contained donation pages powered by AlgoVoi and deployed to Cloudflare Pages. Zero external dependencies — drop the HTML file onto any server or share the URL directly.
Source: x402-widget/manndeshi.html · x402-widget/functions/api/manndeshi/donate.js
x402 Embeddable Payment Widget
A drop-in Web Component for accepting x402 payments on any website. Deployed to Cloudflare Pages at your-domain.example. Full source and security guide: x402-widget/
Adapters with limited support
Six adapters have structural blockers that prevent full end-to-end testing:
How payments work
Payments are verified directly on-chain — no intermediary holds funds. Settlement goes straight to the merchant's configured payout address.
Security
Every adapter is hardened against real-world payment attack vectors. Pass 1 (April 2026) covered cancel-bypass / empty-secret / cookie-swap / SSRF / timing attacks across all deployed stores and native adapters. Pass 2 (15 April 2026) added defensive depth across the B2B webhook trio + native SDKs + a critical Rust compile fix.
Vulnerabilities found and fixed — Pass 1 (April 2026)
Vulnerabilities found and fixed — Pass 2 (15 April 2026)
Comet-validated audit across the B2B webhook trio and all 4 native SDKs. All seven adapters bumped from 1.0.0 to 1.1.0.
Security measures in every adapter
- HMAC webhook verification —
hash_equals(PHP),hmac.compare_digest(Python),hmac.Equal(Go),constant_time_eq(Rust) - Empty secret rejection — webhooks rejected before HMAC check if secret is not configured
- SSRF protection — checkout URL host validated against configured API base before server-side fetch
- Cancel-bypass prevention — hosted checkout returns verified via API status check before marking orders complete
- Order ownership checks — customer ID cross-referenced on verify endpoints (prevents cookie/session swap)
- TLS enforced — SSL verification on all outbound HTTP calls across every language
- Input validation — network whitelist, tx_id length guard, timing-safe comparisons
- No hardcoded secrets — all credentials read from platform admin config or environment variables
- Replay attack prevention —
is_replay()method on all 7 accounting adapters; real implementation on Xero (eventDateUtc/firstRetryMoment, 5-minute window, fail-open); documented no-op on platforms with no signed timestamp in payload
Getting started
- Sign up — Start a free trial with just your wallet address (no email required)
- Get your API key — Instant API access with testnet + capped mainnet (30-day trial)
- Configure networks — Add payout addresses for Algorand, VOI, Hedera, Stellar, Base, and/or Solana
- Install an adapter — Drop the plugin into your store, or use a native adapter for custom apps
- Accept payments — Customers select their chain and pay with stablecoins
License
This repository is licensed under the Business Source License 1.1.
Permitted
- Install plugins on your own store (WooCommerce, OpenCart, PrestaShop, Shopware)
- Use native adapters (PHP, Python, Go, Rust) in your own application
- Fork and modify the code for your own internal use
- Contribute improvements back via pull requests
- All usage requires a valid AlgoVoi tenant account
Prohibited
- Operating the adapters (or derivatives) as a competing hosted payment service or payment gateway
- Reselling, sublicensing, or redistributing as a commercial product
- Processing payments without a valid AlgoVoi tenant account
- Removing or altering copyright, attribution, or license notices
Not distributed
- Shopify app — proprietary hosted service operated by AlgoVoi. Merchants install via the Shopify App Store; source code is not publicly distributed.
- Accounting adapters (QuickBooks Online, Xero, FreshBooks, Sage Business Cloud, Zoho Books, Wave, MYOB) — source code is not publicly distributed. Integration guides are in this repository. Download your adapter from the AlgoVoi dashboard after signing in.
Support
- Documentation: github.com/chopmob-cloud/AlgoVoi-Platform-Adapters (this repository)
- Open an issue in this repository
- Contact via X (@AlgoVoi)
- API:
api.algovoi.co.uk
Source: README.md at commit 31ac983
Tools
0Version history
1- v1.1.3LatestSep 16, 2026
Score
40% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts
Declare a license in the repository or the registry entry.