voulti-mcp

voulti-mcp

MCP server for Voulti — accept crypto payments from any AI agent. Create an invoice with one call, share the hosted checkout link, and confirm payment. USDC, USDT and stablecoins on 5 networks (Celo, Base, Arbitrum, Polygon, BSC), instant self-custody settlement, 1% fee. No API key — all tools are free to call.

Install

Claude Code:

claude mcp add voulti -- npx -y voulti-mcp

Cursor / any MCP client (.mcp.json / mcp.json):

{
  "mcpServers": {
    "voulti": {
      "command": "npx",
      "args": ["-y", "voulti-mcp"],
      "env": {
        "VOULTI_COMMERCE_ID": "your-commerce-id"
      }
    }
  }
}

Configuration

Env var	Required	Description
VOULTI_COMMERCE_ID	no	Default merchant id, so the agent doesn't pass it on every call. Get it at app.voulti.com → Receive Payments → Developers (self-service signup, ~1 minute).
VOULTI_API_BASE	no	Default https://api.voulti.com.

No secrets, no wallet, no API key: Voulti's integration API is public, and settlement goes straight to the merchant's own wallet.

Tools

Tool	What it does
create_invoice	Invoice for a fixed amount (in the merchant's base currency) → hosted checkout link. Supports reference (your order id / client name) and custom expires_at (default 1 hour)
get_invoice	Payment status: Pending → Paid | Expired, with paid_tx_hash on-chain proof
get_payment_link	The merchant's permanent pay-what-you-want page (never expires)

Typical flow

• Human: "charge my client Andrés $150".
• create_invoice { amount_fiat: 150, reference: "andres-logo" } → send checkout_url to Andrés.
• Andrés pays with any wallet, in the stablecoin/network he prefers.
• get_invoice until status: "Paid" → funds are already in the merchant's wallet (minus 1%).

Full guide: voulti.com/skill.md · LLM index: voulti.com/llms.txt