Skip to main content
Glama

AlgoVoi MCP Server

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

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

Пакет

Установка

Команда

TypeScript

npm i -g @algovoi/mcp-server

npx -y @algovoi/mcp-server

Python

pip install algovoi-mcp

uvx algovoi-mcp или algovoi-mcp

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


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

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

#

Инструмент

Что он делает

1

create_payment_link

URL для хостинг-чекаута на указанную сумму + сеть

2

verify_payment

Проверка токена оплаты (опционально с tx_id)

3

prepare_extension_payment

Параметры потока оплаты в кошельке (Algorand / VOI)

4

verify_webhook

Проверка подписи HMAC-SHA256 для вебхуков AlgoVoi

5

list_networks

Поддерживаемые сети + ID активов (офлайн, без вызова API)

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

#

Инструмент

Что он делает

6

generate_mpp_challenge

Заголовки IETF MPP 402 WWW-Authenticate + challenge_id

7

verify_mpp_receipt

Проверка квитанции MPP в блокчейне (прямой индексатор, без вызова API)

8

verify_x402_proof

Проверка доказательства оплаты x402 в base64 (прямой индексатор)

9

generate_x402_challenge

Заголовки x402 X-Payment-Required 402 + полезная нагрузка

10

generate_ap2_mandate

AP2 v0.1 PaymentMandate для потоков оплаты AI-агентов

11

verify_ap2_payment

Проверка квитанции об оплате мандата AP2 (прямой индексатор)

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

#

Инструмент

Что он делает

12

fetch_agent_card

GET {agent_url}/.well-known/agent.json — обнаружение возможностей и требований к оплате A2A-агента перед его вызовом

13

send_a2a_message

POST {agent_url}/message:send — вызов A2A v1.0 агента с защитой платежом; возвращает результат задачи при 200 или challenge_headers при 402, чтобы Claude мог оплатить и повторить попытку

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

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

Вариант А — 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_API_KEY

✅

API-ключ algv_... из панели управления AlgoVoi

ALGOVOI_TENANT_ID

✅

UUID арендатора из панели управления AlgoVoi

ALGOVOI_PAYOUT_ALGORAND

✅*

Адрес кошелька для выплат Algorand

ALGOVOI_PAYOUT_VOI

✅*

Адрес кошелька для выплат VOI

ALGOVOI_PAYOUT_HEDERA

✅*

Аккаунт для выплат Hedera (например, 0.0.123456)

ALGOVOI_PAYOUT_STELLAR

✅*

Адрес для выплат Stellar (G...)

ALGOVOI_PAYOUT_ADDRESS

—

Универсальный резервный адрес, если не заданы переменные для конкретных сетей

ALGOVOI_WEBHOOK_SECRET

—

Для verify_webhook

ALGOVOI_API_BASE

—

Переопределение базового URL API AlgoVoi (по умолчанию: https://cloud.algovoi.co.uk)

***** Требуется как минимум один адрес для конкретной сети (или 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.

Available Tools

11 tools
generate_ap2_mandateA

Generate an AP2 v0.1 PaymentMandate for agent-to-agent payment. Returns the mandate object and its base64 encoding for the AP2-Payment-Required header. After the paying agent submits on-chain, call verify_ap2_payment to confirm.

Inputs: resource_id (required), amount_microunits (required), network, expires_in_seconds, +1 more.

generate_mpp_challengeA

Generate an IETF MPP (draft-ryan-httpauth-payment) 402 challenge that an API server can return to gate a resource. Produces the WWW-Authenticate and X-Payment-Required headers plus the challenge_id to echo.

Inputs: resource_id (required), amount_microunits (required), networks, expires_in_seconds.

generate_x402_challengeA

Generate an x402 (spec v1) 402 Payment Required response for gating a resource. Returns the X-Payment-Required header value and full payload. The client must pay on-chain and re-send with X-Payment: , then verify with verify_x402_proof.

Inputs: resource (required), amount_microunits (required), network, expires_in_seconds, +1 more.

list_networksA

List the blockchain networks AlgoVoi supports, with asset IDs, decimals, and CAIP-2 identifiers. Offline tool — no API call.

Inputs: no named parameters.

prepare_extension_paymentA

Prepare an in-page wallet-extension payment (Algorand / VOI only). Returns the token and chain parameters a frontend can use to ask a browser wallet to sign and submit the transfer, then verify with verify_payment + tx_id.

Inputs: amount (required), currency (required), label (required), network (required).

verify_ap2_paymentA

Verify an AP2 payment — returns {verified: true} if the on-chain transaction satisfies the mandate's amount and recipient.

Inputs: mandate_id (required), tx_id (required), network (required).

verify_mpp_receiptB

Verify an MPP receipt (on-chain transaction ID) for a given resource — returns {verified: true} if the transaction paid the resource's declared amount to the tenant's payout address.

Inputs: resource_id (required), tx_id (required), network (required).

verify_paymentA

Verify that a payment for a given checkout token has settled. Returns paid/unpaid status. If tx_id is supplied, verifies that specific on-chain transaction; otherwise uses hosted-checkout status.

Inputs: token (required), tx_id.

verify_webhookA

Verify an AlgoVoi webhook HMAC-SHA256 signature. Returns {valid: true, payload: } if the signature matches the server's configured webhook secret (ALGOVOI_WEBHOOK_SECRET env var — never passed as a tool argument).

Inputs: raw_body (required), signature (required).

verify_x402_proofA

Verify a base64-encoded x402 payment proof against a given network — returns {verified: true} if the proof corresponds to a confirmed on-chain transfer to the tenant's payout address.

Inputs: proof (required), network (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 11 tools

    Disambiguation4/5

    Most tools have distinct purposes, such as create_payment_link for hosted checkout and generate_ap2_mandate for agent-to-agent payments. However, the three challenge-generation tools (generate_ap2_mandate, generate_mpp_challenge, generate_x402_challenge) could be confusing due to overlapping concepts of payment challenges, though their specific protocols help differentiate them.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with snake_case, such as create_payment_link, verify_payment, and list_networks. This uniformity makes the tool set predictable and easy to navigate, with no deviations in naming conventions.

    Tool Count5/5

    With 11 tools, the server is well-scoped for handling blockchain payments and verifications. Each tool serves a clear function, such as payment creation, verification, and network listing, without feeling excessive or insufficient for the domain of payment processing and validation.

    Completeness5/5

    The tool set provides comprehensive coverage for the payment domain, including creation (e.g., create_payment_link), verification (e.g., verify_payment, verify_ap2_payment), and support tools (e.g., list_networks, verify_webhook). There are no obvious gaps, as it covers multiple payment protocols and lifecycle stages from initiation to confirmation.

    Maintenance

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A comprehensive Model Context Protocol (MCP) server providing 50+ tools for Algorand blockchain development, including account management, asset operations, smart contracts, API integration, swap functionality, and advanced transaction capabilities.
      ISC
    • A
      license
      A
      quality
      D
      maintenance
      Keyless crypto payments for AI agents. One MCP call turns any wallet address into a non-custodial crypto payment link or tip jar, no API key and no account, with funds settling straight to your wallet at a 0% platform fee (USDC/USDT, BTC, LTC, DASH, DOGE, ZCASH).
      3
      88 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      An MCP server for agentic commerce, enabling AI agents to discover services, make x402 payments with USDC across multiple chains, and manage crypto wallets and token swaps.
      598 npm
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Payment infrastructure MCP server enabling AI agents to make gasless USDC payments on Base and JIT single-use virtual card checkouts, with zero-trust card handling, merchant checkout hints, and signed receipts.
      13
      348 npm
      1
      MIT