voulti-mcp

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

Related MCP server: PayRam MCP Server

Networks

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

Cron Jobs

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

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

Requires env vars: OPENEXCHANGERATE_APPID, COINGECKO_APIKEY, RESEND_APIKEY.

Environment Variables

See .env.example for all required variables.