How do I install Voulti?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Voulti need an API key?

The publisher lists these environment variables: VOULTI_COMMERCE_ID.

What transport does Voulti use?

Voulti runs locally over stdio.

When was Voulti last checked?

Last checked 2026-11-09. Accept crypto payments from AI agents: invoices + hosted checkout on 5 chains. No API key.

Voulti MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Credentials from the publisher

VOULTI_COMMERCE_ID — Default merchant id (from app.voulti.com → Receive Payments → Developers). Optional — can be passed per call.

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1VOULTI_COMMERCE_ID=<value> claude mcp add io.github.csacanam-voulti -- npx -y voulti-mcp@0.1.0

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.csacanam-voulti": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ],9      "env": {10        "VOULTI_COMMERCE_ID": "<value>"11      }12    }13  }14}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.1.0
API key

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Crypto payment gateway for merchants. Accept USDC, USDT and stablecoins on 5 networks.

Architecture

apps/
  checkout/     React + Vite — customer payment page
  merchant/     Next.js — merchant dashboard
  api/          Fastify — backend API

contracts/
  core/         DerampProxy + modules (Hardhat, Solidity ^0.8.28)

packages/
  shared/       Shared utilities

assets/
  brand/        The logo, and the icons every app is derived from

Networks

Network	Chain ID	Tokens
Celo	42220	USDC, USDT, COPm
Arbitrum	42161	USDC, USD₮0
Polygon	137	USDC, USDT0
Base	8453	USDC
BSC	56	USDC, USDT

For AI agents

Voulti is agent-usable end to end — the integration API needs no API key:

MCP server: claude mcp add voulti -- npx -y voulti-mcp — tools create_invoice, get_invoice, get_payment_link. See mcp/README.md.
Agent skill: npx skills add csacanam/voulti — or read it at voulti.com/skill.md.
Plain HTTP: POST https://api.voulti.com/invoices with { commerce_id, amount_fiat, reference? } → hosted checkout link. LLM index: voulti.com/llms.txt.

Features

Self-service registration — merchant connects wallet, names business, done
Two payment methods — Connect Wallet or Pay by Address (QR + deposit)
Multi-chain balances — aggregated by token, network auto-selected
Send funds — withdraw to any wallet from dashboard
HD wallet sweep — automatic deposit detection and settlement
Partial/over payment handling — auto-refund on overpay, wait on partial
i18n — Spanish and English

Smart Contracts

Modular proxy architecture deployed on 5 networks:

DerampProxy — entry point, routes calls to modules
DerampStorage — centralized data store
AccessManager — roles, token/commerce whitelisting
InvoiceManager — invoice lifecycle
PaymentProcessor — payment execution, fee calculation
TreasuryManager — service fee collection
WithdrawalManager — commerce fund withdrawals

See contracts/core/deployed-addresses/PRODUCTION.md for all addresses.

Operator Wallet

0x21581Cb82D9a66126fBe7639f4AF55DdfEA48E26 — deploys contracts, whitelists commerces, sends gas for HD wallet sweeps.

Local Development

# Prerequisites: Node 18+, pnpm
pnpm install
cd contracts/core && npm install

# Start Hardhat node (terminal 1)
npx hardhat node

# Deploy + setup (terminal 2)
cd contracts/core
npx hardhat run scripts/setup-local.ts --network localhost

# Start API (terminal 3)
pnpm dev:api

# Start checkout (terminal 4)
pnpm dev:checkout

# Start merchant dashboard (terminal 5)
pnpm dev:merchant

API Endpoints

Method	Path	Auth	Description
POST	/commerces	Privy	Register commerce
GET	/commerces/:id	Public	Commerce info
GET	/commerces/:id/balances	Privy	Multi-chain balances
POST	/invoices	Privy	Create invoice
GET	/invoices/:id	Public	Invoice details + tokens
POST	/blockchain/create	Public	Create on-chain invoice
GET	/blockchain/status/:id	Public	On-chain invoice status
POST	/deposit/generate	Public	Generate HD deposit address
GET	/deposit/status/:id	Public	Deposit monitoring status
GET	/stats	Public	Revenue stats (building in public)
GET	/prices/rates	Public	Fiat + token rates from DB
POST	/prices/update-fiat-rates	Cron	Update fiat rates (OpenExchangeRates)
POST	/prices/update-token-prices	Cron	Update token prices (CoinGecko)

Cron Jobs

Configure these as scheduled jobs in DigitalOcean (or any scheduler):

Job	URL	Schedule	Description
Fiat rates	`POST /prices/update-fiat-rates`	Every hour	Updates USD→COP/EUR/BRL/MXN/ARS rates from OpenExchangeRates
Token prices	`POST /prices/update-token-prices`	Every hour	Updates USDC/USDT/COPm rates from CoinGecko
Expire invoices	`POST /orders/expire-orders`	Every minute	Marks expired invoices as Expired
Process emails	`POST /notifications/process-emails`	Every minute	Sends payment confirmation emails via Resend
Process webhooks	`POST /notifications/process-url-confirmations`	Every minute	Calls commerce confirmation URLs

Base URL: https://api.voulti.com

Requires env vars: OPENEXCHANGERATE_APPID, COINGECKO_APIKEY, RESEND_APIKEY.

Environment Variables

See .env.example for all required variables.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Voulti?

Does Voulti need an API key?

What transport does Voulti use?

When was Voulti last checked?

Documentation

Architecture

Networks

For AI agents

Features

Smart Contracts

Operator Wallet

Local Development

API Endpoints

Cron Jobs

Environment Variables