io.github.csacanam/voulti

Accept crypto payments from AI agents: invoices + hosted checkout on 5 chains. No API key.

Que pouvez-vous faire avec io.github.csacanam/voulti ?

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

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package voulti-mcp

Claude Code

claude mcp add voulti -e 'VOULTI_COMMERCE_ID=<VOULTI_COMMERCE_ID>' -- npx -y voulti-mcp@0.1.0

Configuration JSON (Claude Desktop, Cursor, VS Code)

{
    "mcpServers": {
        "voulti": {
            "command": "npx",
            "args": [
                "-y",
                "voulti-mcp@0.1.0"
            ],
            "env": {
                "VOULTI_COMMERCE_ID": "<VOULTI_COMMERCE_ID>"
            }
        }
    }
}

Variables d'environnement

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

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire

Architecture
Networks
For AI agents
Features
Smart Contracts
Operator Wallet
Local Development
API Endpoints
Cron Jobs
Environment Variables

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.

Questions fréquentes

Qu'est-ce que io.github.csacanam/voulti ?

Accept crypto payments from AI agents: invoices + hosted checkout on 5 chains. No API key.

Comment installer io.github.csacanam/voulti ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add voulti -e 'VOULTI_COMMERCE_ID=<VOULTI_COMMERCE_ID>' -- npx -y voulti-mcp@0.1.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.csacanam/voulti ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

io.github.csacanam/voulti est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.csacanam/voulti ?

Il est publié par csacanam. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.

Détails du serveur

Référencé dans: Registre MCP officiel
Éditeur: csacanam
Catégorie: Finance et paiements
Exécution: Local
Étoiles GitHub: ★ 0
Licence: MIT
Langage: Solidity
Dernier commit: 29 sept. 2026
Tickets ouverts: 0
Version: 0.1.0
Publié le: 12 juil. 2026

io.github.csacanam/voulti

Serveurs similaires

Prax Data Services Screen EVM wallets, contracts and transactions against sanctions, exploit, phishing and...
Astro Agents - verifiable planetary timing data and astrology Verifiable market-timing data for trading bots: Gann lines, events, analogues. Pay per ...
AlphaPrime Generate and backtest futures trading strategies from Claude with AlphaPrime (Valynox).
Holiday Ready Travel Insurance Quotes Retrieve Holiday Ready travel insurance quotes.
falcon.sol structures Price crypto structured notes (autocallables, shark fins, range accruals) via Monte Car...
falcon.sol comps falcon.sol: SEC EDGAR financials, trading comps, credit and LBO via x402 (free preview).
Finlynq Self-hostable personal finance app: track and query income, expenses, budgets, investme...
vn-skills Vietnam: VietQR, address, tax ID, CCCD, phone, holiday, names, number/date format, luna...

Finance et paiements