AlgoVoi MCPサーバー
MCP (Model Context Protocol)サーバーであり、AlgoVoiの決済インフラをClaude Desktop、Claude Code、Cursor、Windsurf、その他MCP互換アシスタントなどのあらゆるMCPクライアントから呼び出せるツールとして公開します。
2つのパッケージで提供されています:
パッケージ | インストール | コマンド |
|
| |
|
|
どちらも同じ13種類のツールとAPIインターフェースを提供します。クライアントが好むランタイムを選択してください。
13種類のツール
決済ツール
# | ツール | 機能 |
1 |
| 指定した金額とチェーンのホスト型チェックアウトURL |
2 |
| チェックアウトトークンの検証(オプションでtx_idを指定可能) |
3 |
| ページ内ウォレットフローのパラメータ(Algorand / VOI) |
4 |
| AlgoVoi Webhook用のHMAC-SHA256署名チェック |
5 |
| サポートされているチェーンとアセットID(オフライン、API呼び出しなし) |
プロトコルチャレンジツール
# | ツール | 機能 |
6 |
| IETF MPP 402 |
7 |
| MPPオンチェーンレシートの検証(直接インデクサー、API呼び出しなし) |
8 |
| x402 base64決済証明の検証(直接インデクサー) |
9 |
| x402 |
10 |
| AIエージェント決済フロー用のAP2 v0.1 |
11 |
| AP2委任決済レシートの検証(直接インデクサー) |
A2Aエージェントツール (v1.2.0で新機能)
# | ツール | 機能 |
12 |
|
|
13 |
|
|
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(4つすべてでUSDC + ネイティブのALGO/VOI/HBAR/XLM)。
Related MCP server: Lightning Enable MCP
接続方法
オプションA — AlgoVoi Cloud(推奨)
AlgoVoi Cloudは、WooCommerce、Zapier、n8n、MCPなど、すべての統合を1つのダッシュボードで管理するコントロールプレーンです。ALGOVOI_API_BASE を https://cloud.algovoi.co.uk に設定し、単一の algv_... APIキーを使用すれば、すべての統合をカバーできます。テナント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から無料で登録してください。
オプションB — AlgoVoi直接接続
algv_... キーとテナントIDを使用して、AlgoVoi APIに直接接続します。
両方のパッケージで同じ環境変数を読み取ります:
変数 | 必須 | 用途 |
| ✅ | AlgoVoiダッシュボードの |
| ✅ | AlgoVoiダッシュボードのテナントUUID |
| ✅* | Algorand支払い用ウォレットアドレス |
| ✅* | VOI支払い用ウォレットアドレス |
| ✅* | Hedera支払い用アカウント (例: |
| ✅* | Stellar支払い用アドレス ( |
| — | チェーンごとの変数が設定されていない場合の汎用フォールバック |
| — |
|
| — | AlgoVoi APIベースURLのオーバーライド (デフォルト: |
* チェーンごとのアドレス(またはフォールバックとしての ALGOVOI_PAYOUT_ADDRESS)が少なくとも1つ必要です。
認証は環境変数のみで行われます。 シークレットがツール引数として渡されることはなく、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.jsonCursor:
~/.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.pyBusiness 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
