AlgoVoi MCP Server

Сервер MCP (Model Context Protocol), который предоставляет инфраструктуру платежей AlgoVoi в виде инструментов, доступных для вызова любым MCP-клиентом — Claude Desktop, Claude Code, Cursor, Windsurf или любым другим помощником с поддержкой MCP.

Поставляется в виде двух пакетов:

Оба пакета предоставляют одни и те же 13 инструментов и API — выбирайте ту среду выполнения, которую предпочитает ваш клиент.

13 инструментов

Инструменты для платежей

Инструменты протокольных запросов

Инструменты A2A-агентов (новое в v1.2.0)

Поток оплаты и вызова 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

Поддерживаемые сети: Algorand, VOI, Hedera, Stellar (USDC во всех четырех + нативные ALGO/VOI/HBAR/XLM).

Related MCP server: Lightning Enable MCP

Два способа подключения

Вариант А — AlgoVoi Cloud (рекомендуется)

AlgoVoi Cloud — это панель управления для всех ваших интеграций: WooCommerce, Zapier, n8n и MCP в одном месте. Укажите ALGOVOI_API_BASE как https://cloud.algovoi.co.uk, и ваш единый API-ключ algv_... покроет все интеграции — не нужно указывать ID арендатора или адреса для выплат (они хранятся в панели управления).

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

Каждый платеж, созданный Claude, отображается в вашей облачной панели управления наряду с платежами с других платформ. Все в одном месте.

Зарегистрируйтесь бесплатно на dash.algovoi.co.uk.

Вариант Б — Прямое подключение к AlgoVoi

Подключайтесь напрямую к API AlgoVoi с помощью вашего ключа algv_... и ID арендатора.

Оба пакета считывают одни и те же переменные окружения:

***** Требуется как минимум один адрес для конкретной сети (или ALGOVOI_PAYOUT_ADDRESS в качестве резервного).

Авторизация только через переменные окружения. Секреты никогда не передаются через аргументы инструментов — MCP-клиент никогда не видит API-ключ.

Зарегистрируйтесь на www.algovoi.co.uk, чтобы получить API-ключ и ID арендатора.

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

Для пакета Python замените на "command": "uvx", "args": ["algovoi-mcp"].

Расположение файлов конфигурации:

• 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

Тестирование

# 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

Лицензировано по 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