Voulti

io.github.csacanam由 GitHub 账号 csacanam 发布v0.1.0更新于 Oct 24, 2026

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

已验证STDIO仅桌面金融商业与电商

概览

AI 生成的概览

Voulti 是一个本地 MCP 服务器，让 AI 助手为商户创建加密货币收款发票并获取托管结账链接。

可以做什么
为商户创建发票，填写法币金额和可选备注，返回托管结账链接，供客户在 Celo、Arbitrum、Polygon、Base 和 BSC 五个网络上用 USDC、USDT 等稳定币付款。按发票标识查询已有发票，查看其详情和状态。获取发票的付款链接，便于分享或重复使用。
适用场景
适合助手代表商户以稳定币收取商品或服务款项的场景，例如在对话或自动化销售流程中生成结账链接。仅当你已有 Voulti 商户账户并希望由智能体驱动开票时才需要。
运行要求
以 npm 包 voulti-mcp 通过 stdio 在本地运行，需要 Node.js。需要 Voulti 商户账户；商户 ID 可通过环境变量 VOULTI_COMMERCE_ID 提供，也可在每次调用时传入。无需 API 密钥。需要能访问 Voulti API 的网络。
安装前请注意
它会生成客户可实际链上付款的收款请求，助手创建的发票和链接具有真实资金影响。商户 ID 标识你的账户，应视为敏感信息。该服务涉及加密资金和商户侧钱包操作，依赖前请先了解资金的接收与结算方式。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Voulti，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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

Networks

NetworkChain IDTokens
Celo42220USDC, USDT, COPm
Arbitrum42161USDC, USD₮0
Polygon137USDC, USDT0
Base8453USDC
BSC56USDC, 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

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

API Endpoints

MethodPathAuthDescription
POST/commercesPrivyRegister commerce
GET/commerces/:idPublicCommerce info
GET/commerces/:id/balancesPrivyMulti-chain balances
POST/invoicesPrivyCreate invoice
GET/invoices/:idPublicInvoice details + tokens
POST/blockchain/createPublicCreate on-chain invoice
GET/blockchain/status/:idPublicOn-chain invoice status
POST/deposit/generatePublicGenerate HD deposit address
GET/deposit/status/:idPublicDeposit monitoring status
GET/statsPublicRevenue stats (building in public)
GET/prices/ratesPublicFiat + token rates from DB
POST/prices/update-fiat-ratesCronUpdate fiat rates (OpenExchangeRates)
POST/prices/update-token-pricesCronUpdate token prices (CoinGecko)

Cron Jobs

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

JobURLScheduleDescription
Fiat ratesPOST /prices/update-fiat-ratesEvery hourUpdates USD→COP/EUR/BRL/MXN/ARS rates from OpenExchangeRates
Token pricesPOST /prices/update-token-pricesEvery hourUpdates USDC/USDT/COPm rates from CoinGecko
Expire invoicesPOST /orders/expire-ordersEvery minuteMarks expired invoices as Expired
Process emailsPOST /notifications/process-emailsEvery minuteSends payment confirmation emails via Resend
Process webhooksPOST /notifications/process-url-confirmationsEvery minuteCalls 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.

来源：README.md，提交 e751ec2

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分