AlgoVoi MCP 서버
MCP (Model Context Protocol) 서버로, AlgoVoi의 결제 인프라를 Claude Desktop, Claude Code, Cursor, Windsurf 또는 기타 MCP 호환 어시스턴트와 같은 모든 MCP 클라이언트가 호출할 수 있는 도구로 노출합니다.
두 가지 패키지로 제공됩니다:
패키지 | 설치 | 명령어 |
|
| |
|
|
두 패키지 모두 동일한 13개의 도구와 동일한 API 인터페이스를 제공하므로, 클라이언트가 선호하는 런타임을 선택하세요.
13개의 도구
결제 도구
# | 도구 | 기능 |
1 |
| 특정 금액 및 체인에 대한 호스팅된 결제 URL 생성 |
2 |
| 결제 토큰 검증 (선택적으로 tx_id 포함) |
3 |
| 인페이지 지갑 흐름 매개변수 (Algorand / VOI) |
4 |
| AlgoVoi 웹훅을 위한 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 등 모든 통합을 위한 제어 평면입니다. 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가 생성하는 모든 결제는 다른 플랫폼의 결제와 함께 Cloud 대시보드에 표시됩니다. 한곳에서 모든 것을 확인할 수 있습니다.
dash.algovoi.co.uk에서 무료로 가입하세요.
옵션 B — AlgoVoi 직접 연결
algv_... 키와 테넌트 ID를 사용하여 AlgoVoi API에 직접 연결합니다.
두 패키지 모두 동일한 환경 변수를 읽습니다:
변수 | 필수 | 목적 |
| ✅ | AlgoVoi 대시보드의 |
| ✅ | AlgoVoi 대시보드의 테넌트 UUID |
| ✅* | Algorand 지급 지갑 주소 |
| ✅* | VOI 지급 지갑 주소 |
| ✅* | Hedera 지급 계정 (예: |
| ✅* | Stellar 지급 주소 ( |
| — | 체인별 변수가 설정되지 않은 경우의 범용 대체 주소 |
| — |
|
| — | AlgoVoi API 기본 URL 재정의 (기본값: |
***** 체인별 주소 중 최소 하나(또는 대체용 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.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