AlgoVoi MCP-Server
Ein MCP (Model Context Protocol)-Server, der die Zahlungsinfrastruktur von AlgoVoi als Tools bereitstellt, die von jedem MCP-Client aufgerufen werden können — Claude Desktop, Claude Code, Cursor, Windsurf oder jeder andere MCP-kompatible Assistent.
Erhältlich als zwei Pakete:
Paket | Installation | Befehl |
|
| |
|
|
Beide stellen die gleichen 13 Tools und die gleiche API-Oberfläche bereit — wählen Sie die Laufzeitumgebung, die Ihr Client bevorzugt.
13 Tools
Zahlungs-Tools
# | Tool | Was es tut |
1 |
| Gehostete Checkout-URL für einen bestimmten Betrag + Chain |
2 |
| Verifiziert ein Checkout-Token (optional mit einer tx_id) |
3 |
| In-Page Wallet-Flow-Parameter (Algorand / VOI) |
4 |
| HMAC-SHA256-Signaturprüfung für AlgoVoi-Webhooks |
5 |
| Unterstützte Chains + Asset-IDs (offline, kein API-Aufruf) |
Protokoll-Challenge-Tools
# | Tool | Was es tut |
6 |
| IETF MPP 402 |
7 |
| Verifiziert einen MPP On-Chain-Beleg (direkter Indexer, kein API-Aufruf) |
8 |
| Verifiziert einen x402 base64-Zahlungsnachweis (direkter Indexer) |
9 |
| x402 |
10 |
| AP2 v0.1 |
11 |
| Verifiziert einen AP2-Mandats-Zahlungsbeleg (direkter Indexer) |
A2A-Agenten-Tools (neu in v1.2.0)
# | Tool | Was es tut |
12 |
|
|
13 |
|
|
A2A Pay-and-Call-Ablauf
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 returnedUnterstützte Netzwerke: Algorand, VOI, Hedera, Stellar (USDC auf allen vier + natives ALGO/VOI/HBAR/XLM).
Related MCP server: Lightning Enable MCP
Zwei Möglichkeiten zur Verbindung
Option A — AlgoVoi Cloud (empfohlen)
AlgoVoi Cloud ist die Steuerungsebene für alle Ihre Integrationen — WooCommerce, Zapier, n8n und MCP in einem einzigen Dashboard. Richten Sie ALGOVOI_API_BASE auf https://cloud.algovoi.co.uk ein und Ihr einzelner algv_... API-Schlüssel deckt jede Integration ab — keine Mandanten-ID oder Auszahlungsadressen erforderlich (diese werden im Dashboard gespeichert).
{
"mcpServers": {
"algovoi": {
"command": "npx",
"args": ["-y", "@algovoi/mcp-server"],
"env": {
"ALGOVOI_API_KEY": "algv_...",
"ALGOVOI_API_BASE": "https://cloud.algovoi.co.uk"
}
}
}
}Jede Zahlung, die Claude erstellt, erscheint in Ihrem Cloud-Dashboard neben Zahlungen von jeder anderen Plattform. Alles an einem Ort im Blick.
Registrieren Sie sich kostenlos unter dash.algovoi.co.uk.
Option B — AlgoVoi direkt
Verbinden Sie sich direkt mit der AlgoVoi-API mit Ihrem algv_...-Schlüssel und Ihrer Mandanten-ID.
Beide Pakete lesen die gleichen Umgebungsvariablen:
Variable | Erforderlich | Zweck |
| ✅ |
|
| ✅ | Mandanten-UUID aus dem AlgoVoi-Dashboard |
| ✅* | Algorand-Auszahlungs-Wallet-Adresse |
| ✅* | VOI-Auszahlungs-Wallet-Adresse |
| ✅* | Hedera-Auszahlungskonto (z. B. |
| ✅* | Stellar-Auszahlungsadresse ( |
| — | Universeller Fallback, falls keine Chain-spezifischen Variablen gesetzt sind |
| — | Für |
| — | Überschreibt die AlgoVoi-API-Basis-URL (Standard: |
* Mindestens eine Adresse pro Chain (oder ALGOVOI_PAYOUT_ADDRESS als Fallback) ist erforderlich.
Die Authentifizierung erfolgt nur über Umgebungsvariablen. Geheimnisse werden niemals über Tool-Argumente übergeben — der MCP-Client sieht den API-Schlüssel niemals.
Registrieren Sie sich unter www.algovoi.co.uk, um Ihren API-Schlüssel und Ihre Mandanten-ID zu erhalten.
{
"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>"
}
}
}
}Für das Python-Paket tauschen Sie "command": "uvx", "args": ["algovoi-mcp"] aus.
Speicherorte der Konfigurationsdatei:
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
Testen
# 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.pyLizenziert unter der Business Source License 1.1.
Maintenance
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/chopmob-cloud/AlgoVoi-Platform-Adapters'
If you have feedback or need assistance with the MCP directory API, please join our Discord server
