Metadata-Version: 2.4
Name: algovoi-mcp
Version: 1.4.0
Summary: MCP server for AlgoVoi — create crypto payment links, verify payments, generate MPP / x402 / AP2 / A2A challenges, and manage Tier 2 standing-authority subscriptions on 7 chains, from any MCP client (Claude Desktop, Claude Code, Cursor, Windsurf). 21 tools across one-shot payments, agent-protocol challenges, A2A messaging, and recurring billing (Algorand, VOI, Base, Tempo, Solana, Hedera, Stellar).
Author: AlgoVoi
License-Expression: MIT
Project-URL: Homepage, https://github.com/chopmob-cloud/AlgoVoi-Platform-Adapters
Project-URL: Repository, https://github.com/chopmob-cloud/AlgoVoi-Platform-Adapters
Keywords: mcp,model-context-protocol,algovoi,payments,crypto,usdc,algorand,voi,hedera,stellar,base,solana,tempo
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp>=1.26.0
Requires-Dist: pydantic>=2.0
Provides-Extra: test
Requires-Dist: pytest>=7.0; extra == "test"
Requires-Dist: pytest-asyncio>=0.21; extra == "test"

<!-- mcp-name: io.github.chopmob-cloud/algovoi-mcp-server -->

# algovoi-mcp

MCP server for [AlgoVoi](https://github.com/chopmob-cloud/AlgoVoi-Platform-Adapters) — **21 tools** across one-shot payments, agent-protocol challenges (MPP / x402 / AP2 / A2A), and Tier 2 standing-authority subscriptions, from any MCP client (Claude Desktop, Claude Code, Cursor, Windsurf).

**Tier 1** (one-shot): create payment links, verify payments, prepare extension payments, verify webhooks, list networks, plus MPP / x402 / AP2 / A2A challenge + verify tools — supports all 16 AlgoVoi networks (USDC on Algorand / VOI / Hedera / Stellar mainnet+testnet, plus native ALGO / VOI / HBAR / XLM).

**Tier 2** (standing-authority recurring) *new in v1.3.0*: create / get / list / confirm / revoke / pause / resume / manual-pull authorities — supports all 14 chain ids (7 mainnets + 7 testnets, including Base / Tempo / Solana / Hedera / Stellar). See the [parent repo's `Recurr/` folder](https://github.com/chopmob-cloud/AlgoVoi-Platform-Adapters/tree/master/Recurr) for per-chain wallet-side integration code.

## Install

```bash
# Via uvx (no global install)
uvx algovoi-mcp

# Or with pip
pip install algovoi-mcp
algovoi-mcp
```

Requires Python ≥ 3.10.

## Configure

Add to your MCP client config (`~/.claude.json`, `~/.cursor/mcp.json`, or `claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "algovoi": {
      "command": "uvx",
      "args": ["algovoi-mcp"],
      "env": {
        "ALGOVOI_API_KEY": "algv_...",
        "ALGOVOI_TENANT_ID": "your-tenant-uuid",
        "ALGOVOI_PAYOUT_ADDRESS": "YOUR_WALLET_ADDRESS",
        "ALGOVOI_WEBHOOK_SECRET": "optional"
      }
    }
  }
}
```

Sign up for an AlgoVoi tenant at [algovoi.com](https://www.algovoi.co.uk) to get your API key.

## Tools

| Tool | Purpose |
|------|---------|
| `create_payment_link` | Hosted-checkout URL for Algorand / VOI / Hedera / Stellar |
| `verify_payment` | Check if a checkout token settled (optional tx_id) |
| `prepare_extension_payment` | In-page wallet flow params (Algorand / VOI) |
| `verify_webhook` | HMAC-SHA256 AlgoVoi webhook verification |
| `list_networks` | Supported chains + asset IDs |
| `generate_mpp_challenge` | IETF MPP 402 `WWW-Authenticate` response |
| `verify_mpp_receipt` | Verify MPP on-chain receipt |
| `verify_x402_proof` | Verify x402 base64 proof |

## Example prompts

> "Create an AlgoVoi payment link for $5 USDC on Algorand, labeled 'Order #42'."

> "Verify payment token abc123."

> "Generate an MPP 402 challenge for my /premium route, $0.01 per call, on Algorand and VOI."

## Dependencies

Only `mcp>=1.26.0`. The AlgoVoi HTTP client is bundled in the package and uses stdlib `urllib.request` — no `requests` / `httpx` needed.

## Development

```bash
git clone https://github.com/chopmob-cloud/AlgoVoi-Platform-Adapters
cd AlgoVoi-Platform-Adapters/mcp-server/python
pip install -e ".[test]"
pytest
```

Run the server directly for debugging:

```bash
ALGOVOI_API_KEY=algv_... \
ALGOVOI_TENANT_ID=... \
ALGOVOI_PAYOUT_ADDRESS=... \
  python -m algovoi_mcp
```

## License

Business Source License 1.1 — see [LICENSE](../../LICENSE).
