Voulti

io.github.csacanamPublished by GitHub account csacanamv0.1.0Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyFinance Business & Commerce

Server details

Identifier: io.github.csacanam/voulti
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account csacanam for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.csacanam%2Fvoulti.svg)](https://sourceweft.com/mcp/io.github.csacanam%2Fvoulti?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Voulti is a local MCP server that lets an AI assistant create crypto payment invoices and retrieve hosted checkout links for a merchant account.

What you can do: Create invoices for a merchant, with an amount in fiat and an optional reference, and get a hosted checkout link back for the customer to pay on-chain stablecoins (USDC, USDT and others) across five networks: Celo, Arbitrum, Polygon, Base and BSC. Look up an existing invoice by its identifier to check its details and status. Retrieve the payment link for an invoice so it can be shared or reused.
When to use it: Useful when an assistant needs to take payments for goods or services in stablecoins on behalf of a merchant, for example generating a checkout link inside a chat or an automated sales flow. Only relevant if you already have a Voulti merchant account and want agent-driven invoicing.
Requirements: Runs locally as an npm package (voulti-mcp) over stdio, so Node.js is needed. A Voulti merchant account is required; the merchant id can be supplied through the VOULTI_COMMERCE_ID environment variable or passed per call. No API key is needed. Network access to the Voulti API is required.

Before you install

This creates real payment requests that customers can pay on-chain, so invoices and links produced by the assistant have financial consequences. The merchant id identifies your account and should be treated as sensitive. The service handles crypto funds and wallet operations on the merchant side; review how funds are received and settled before relying on it.

Installation

In SourceWeft

Open Voulti in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[Voulti]

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

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

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

bash

# Prerequisites: Node 18+, pnpmpnpm installcd contracts/core && npm install
# Start Hardhat node (terminal 1)npx hardhat node
# Deploy + setup (terminal 2)cd contracts/corenpx 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

# Prerequisites: Node 18+, pnpmpnpm installcd contracts/core && npm install
# Start Hardhat node (terminal 1)npx hardhat node
# Deploy + setup (terminal 2)cd contracts/corenpx 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.

Source: README.md at commit e751ec2

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v0.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts

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