
Algovoi Mcp Server
io.github.chopmob-cloud由 GitHub 账号 chopmob-cloud 发布v1.1.3更新于 Oct 27, 2026
AlgoVoi crypto payments via MCP: USDC + native on Algorand, VOI, Hedera, Stellar.
概览
AlgoVoi MCP 服务器,让 AI 助手直接使用 Algorand、VOI、Hedera、Stellar 上的 USDC 与原生代币加密支付工具。
- 可以做什么
- 创建和管理加密支付请求与托管结账链接,覆盖 Algorand、VOI、Hedera、Stellar、Base、Solana 和 Tempo
- 查询支付状态,通过 webhook 或 API 状态检查确认到账
- 在配置 webhook 密钥后校验传入的 webhook 签名
- 管理收款钱包地址与租户设置,支持直连 API 或 AlgoVoi Cloud
- 把同样的支付能力提供给 Claude、Cursor、Windsurf 等 AI 助手
- 适用场景
- 适合需要让助手为网店、捐赠流程或 AI 代理付费网关创建、跟踪或核对加密支付的场景,也适合查询某笔账单是否已在链上结算。
- 运行要求
- 以 npm 或 PyPI 包形式通过 stdio 在本机运行。需要从 AlgoVoi 控制台获取的 API 密钥,放在 ALGOVOI_API_KEY 中。ALGOVOI_API_BASE 用于选择 API 主机;ALGOVOI_TENANT_ID 与 ALGOVOI_PAYOUT_ADDRESS 仅在直连 API 时需要,使用 AlgoVoi Cloud 时无需设置。需要能访问 AlgoVoi API 的网络。
安装
在 SourceWeft 中
- 打开 控制台中的 Algovoi Mcp Server,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
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
来源:README.md,提交 31ac983
工具
0版本历史
1- v1.1.3最新Sep 16, 2026
评分
已满足适用检查项的 40%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分
请在仓库或注册中心条目中声明许可证。