Lunium — Brazilian PIX and stablecoin payments
RemoteAbout Lunium — Brazilian PIX and stablecoin payments
LuniumPay Agent Skills is a set of skills and scripts for coding agents integrating Brazilian Pix payments with stablecoins. It covers Pix collection and crypto payouts, crypto-funded Pix payments, webhooks, sandbox testing, and production setup across supported project stacks.
Key features
- 01Scaffold payment routes for supported stacks
- 02Test payment flows in a sandbox
- 03Set up production keys and webhooks
- 04Integrate Pix collection and stablecoin settlement
- 05Support crypto-funded Pix payments
Use cases
- 01Add Pix-to-USDT/USDC payment flows
- 02Test success and failure scenarios without real funds
- 03Configure signed webhook handling
- 04Set up a production payment integration
MCP support
The skills reference LuniumPay's MCP endpoint at https://api.luniumpay.com/mcp, which provides 20 tools. The project also guides agents through API-based payment integrations.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://api.luniumpay.com/mcpclaude mcp add --transport http com-luniumpay-pix-brazilian-payments https://api.luniumpay.com/mcp{"mcpServers":{"com-luniumpay-pix-brazilian-payments":{"type":"http","url":"https://api.luniumpay.com/mcp"}}}Open in Cursor{"servers":{"com-luniumpay-pix-brazilian-payments":{"type":"http","url":"https://api.luniumpay.com/mcp"}}}Open in VS Code{"mcpServers":{"com-luniumpay-pix-brazilian-payments":{"type":"http","url":"https://api.luniumpay.com/mcp"}}}{"mcpServers":{"com-luniumpay-pix-brazilian-payments":{"serverUrl":"https://api.luniumpay.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
20| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | No | Optional label so a human can recognise this key later in the dashboard, e.g. the name of your agent or project. |
| string | No | E-mail of the person who will test. Strongly recommended: LuniumPay sends them the integration guide (what LuniumPay is, manual, flowchart, next steps) once. Ask the human for it; never invent one. If you do not have it yet, create the key anyway and send it afterwards with lunium_contact. |
Details
From the project READMELuniumPay Agent Skills
PT · Pix ⇄ stablecoin no Brasil, integrado pelo seu agente de IA. Instale, peça "quero receber Pix e cair em USDT na minha carteira" e o agente faz tudo: chave em uma chamada, backend, QR, webhook, sandbox, produção. EN · Brazilian Pix ↔ stablecoin payments, integrated by your coding agent. Install, ask "accept Pix and settle in USDT to my wallet", and the agent does the rest.
Funciona em Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Antigravity e em qualquer agente que leia o padrão Agent Skills.
Instalar / Install
npx skills add LuniumPay/lunium-agent-skills
Claude Code, pelo marketplace de plugins (recebe atualizações):
/plugin marketplace add LuniumPay/lunium-agent-skills
/plugin install luniumpay@lunium-agent-skills
Manual: copie as pastas para o diretório de skills do agente
(.claude/skills/, .cursor/skills/, .codex/skills/, .agents/skills/).
O que vem / What's inside
| Skill | Use quando… | Extras |
|---|---|---|
luniumpay | Comece aqui. Pitch, árvore de decisão, roteiro de 7 passos, 11 regras, o que o sandbox simula | references/ estados, erros, checklist, FAQ do dono, prompts, MCP (20 tools), produção por stack · scripts/init.mjs, doctor.mjs, go-live.mjs |
luniumpay-pix-charge | Receber Pix → USDT/USDC na carteira (ou saldo) | receitas Next.js, Express, FastAPI, Supabase Edge, componente React de checkout · scripts/smoke.mjs |
luniumpay-custody | Saldo em reais sem carteira, subcontas, retenção/carência, saque em cripto, Pix com saldo | scripts/smoke-custody.mjs (inclui carência) |
luniumpay-webhooks | Receber eventos assinados com segurança | verificador oficial + teste |
luniumpay-crypto-sale | Pagar Pix com cripto (cash-out): catálogo, prévia, ordem, aceite, devolução | scripts/smoke-cashout.mjs |
luniumpay-usdt-wallet | Saldo em USDT e Pix pago com ele (chave ou copia e cola) | |
luniumpay-verify-payment | Provar que um Pix liquidou, sem chave |
Montar no seu projeto em um comando / Scaffold into your project
node luniumpay/scripts/init.mjs --email [email protected] # detecta Next.js, Express, FastAPI ou Supabase
Grava as rotas de cobrança, status e webhook da receita oficial no seu projeto (nunca sobrescreve), o
.env.example, cria uma chave de sandbox no .env local (0600, nunca impressa) e lista os próximos passos.
--stack next|express|fastapi|supabase força a stack; --dry só mostra o plano.
Testar sem dinheiro / Try with no money
export [email protected] # recebe 1 e-mail com o manual
node luniumpay/scripts/doctor.mjs # diagnóstico da chave (após criar)
node luniumpay-pix-charge/scripts/smoke.mjs cripto success
node luniumpay-pix-charge/scripts/smoke.mjs cripto failed
node luniumpay-custody/scripts/smoke-custody.mjs
node luniumpay-crypto-sale/scripts/smoke-cashout.mjs USDT polygon
node luniumpay-crypto-sale/scripts/smoke-cashout.mjs DEPIX liquid settlement_uncertain
node luniumpay-webhooks/scripts/verify-webhook.test.mjs
Os scripts criam uma chave de teste (lun_test_), cobram, simulam o Pix e leem o
estado final. Recusam chaves de produção. Nenhum dinheiro real se move.
Produção completa em um comando / Production in one command
node luniumpay/scripts/go-live.mjs --name "Minha Empresa" --email [email protected] \
--webhook https://seu-dominio.com/api/webhooks/lunium --vercel # ou --env .env.lunium.production
Cria a chave lun_live_… na hora (sem aprovação), cadastra o webhook com segredo, grava os segredos
no host (nunca imprime) e prova a entrega com POST /webhooks/test. Mesmo contrato do sandbox:
só a variável muda. Deploy por stack e primeira cobrança real: luniumpay/references/producao.md.
Só a chave, por curl: curl -X POST https://api.luniumpay.com/keys -H 'Content-Type: application/json' -d '{"name":"Minha Empresa","email":"[email protected]"}'.
Fonte de verdade / Source of truth
SKILL.md são curtos de propósito. O contrato vivo manda:
openapi.json · llms.txt ·
integration.json · sandbox ·
MCP https://api.luniumpay.com/mcp. Skills 2.2.0 · revisão 2026-10-25 · API 1.45.2.
Suporte: [email protected] · https://wa.me/27722944340 · Lunium Partners (Telegram)
Licença
MIT.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.