Servidor MCP AlgoVoi

Un servidor MCP (Model Context Protocol) que expone la infraestructura de pagos de AlgoVoi como herramientas que cualquier cliente MCP puede llamar: Claude Desktop, Claude Code, Cursor, Windsurf o cualquier otro asistente compatible con MCP.

Se distribuye en dos paquetes:

Ambos exponen las mismas 13 herramientas y la misma superficie de API; elige el entorno de ejecución que prefiera tu cliente.

13 herramientas

Herramientas de pago

Herramientas de desafío de protocolo

Herramientas de agente A2A (nuevo en v1.2.0)

Flujo de pago y llamada A2A

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

Redes compatibles: Algorand, VOI, Hedera, Stellar (USDC en las cuatro + ALGO/VOI/HBAR/XLM nativos).

Related MCP server: Lightning Enable MCP

Dos formas de conectar

Opción A — AlgoVoi Cloud (recomendado)

AlgoVoi Cloud es el plano de control para todas tus integraciones: WooCommerce, Zapier, n8n y MCP, todo en un mismo panel. Apunta ALGOVOI_API_BASE a https://cloud.algovoi.co.uk y tu única clave de API algv_... cubre todas las integraciones; no se necesita ID de inquilino ni direcciones de pago (se almacenan en el panel).

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

Cada pago que crea Claude aparece en tu panel de Cloud junto con los pagos de cualquier otra plataforma. Un solo lugar para verlo todo.

Regístrate gratis en dash.algovoi.co.uk.

Opción B — AlgoVoi directo

Conéctate directamente a la API de AlgoVoi con tu clave algv_... y tu ID de inquilino.

Ambos paquetes leen las mismas variables de entorno:

* Se requiere al menos una dirección por cadena (o ALGOVOI_PAYOUT_ADDRESS como alternativa).

La autenticación es solo mediante variables de entorno. Los secretos nunca pasan a través de los argumentos de la herramienta; el cliente MCP nunca ve la clave de API.

Regístrate en www.algovoi.co.uk para obtener tu clave de API e ID de inquilino.

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

Para el paquete de Python, cambia a "command": "uvx", "args": ["algovoi-mcp"].

Ubicaciones de los archivos de configuración:

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS), %APPDATA%\Claude\claude_desktop_config.json (Windows)

• Claude Code: ~/.claude.json

• Cursor: ~/.cursor/mcp.json

Pruebas

# 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

Licenciado bajo la Business Source License 1.1.

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• create_payment_linkA
• generate_ap2_mandateA
• generate_mpp_challengeA
• generate_x402_challengeA
• list_networksA
• prepare_extension_paymentA
• verify_ap2_paymentA
• verify_mpp_receiptB