Lunium — Claude Code MCP server for Pix and stablecoins
Lunium — Brazilian PIX and stablecoin payments is an MCP server for Claude Code that connects Brazilian Pix payments with USDT or USDC settlement for payment flows and Pix verification without an API key.
MIT updated 2026-10-25
claude mcp add --transport http pix-brazilian-payments https://api.luniumpay.com/mcpWhat Lunium — Brazilian PIX and stablecoin payments does
Lunium connects Brazilian Pix payments with stablecoins. A project can receive Pix and settle in USDT or USDC, or use crypto to pay Pix. The MCP server uses HTTP at https://api.luniumpay.com/mcp and is listed for Claude Code, Codex, Cursor, GitHub Copilot, and Gemini CLI.
Add the server to Claude Code with the command in the FAQ. The accompanying skills cover Pix charges, custody, webhooks, crypto-funded Pix payments, and payment verification without a key. The README also describes scripts for scaffolding a project, checking a key, and running tests. Test scripts reject production keys and do not move real funds.
The integration material covers Next.js, Express, FastAPI, and Supabase. The init.mjs script can detect a project stack or take one through --stack; sandbox setup uses a test key. The MCP connection and the skills are separate parts: connecting the server alone does not create payment routes in your project.
What it helps with
- accept Pix and settle in USDT or USDC
- pay a Pix charge with crypto
- check whether a Pix payment cleared without an API key
- handle signed webhook events
- scaffold payment routes for Next.js or FastAPI
Example prompts for the agent
- Connect Lunium and help me set up Pix payments that settle in USDT.
- Show me how to pay a Pix charge with crypto through Lunium.
- Check whether this Pix payment cleared without using an API key.
How to install Lunium — Brazilian PIX and stablecoin payments
Platform CLI: remote server
claude mcp add --transport http pix-brazilian-payments https://api.luniumpay.com/mcpPlatform CLI: remote server
codex mcp add lunium-brazilian-pix-and-stablecoin-payments --url https://api.luniumpay.com/mcpConfig file
{
"mcpServers": {
"lunium-brazilian-pix-and-stablecoin-payments": {
"url": "https://api.luniumpay.com/mcp"
}
}
}Config file
{
"servers": {
"lunium-brazilian-pix-and-stablecoin-payments": {
"type": "http",
"url": "https://api.luniumpay.com/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http lunium-brazilian-pix-and-stablecoin-payments https://api.luniumpay.com/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Lunium — Brazilian PIX and stablecoin payments
How do I install Lunium in Claude Code?
Run claude mcp add --transport http pix-brazilian-payments https://api.luniumpay.com/mcp. This registers Lunium as an HTTP MCP server.
What does Lunium do?
It connects an agent to Brazilian Pix and stablecoin payment flows, including Pix receipts settled in USDT or USDC, crypto-funded Pix payments, and payment checks without an API key.
Which stacks does the scaffold script cover?
The README lists Next.js, Express, FastAPI, and Supabase. You can select one with --stack next|express|fastapi|supabase.