# Lunium — Brazilian PIX and stablecoin payments

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: LuniumPay
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/LuniumPay/lunium-agent-skills
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/lunium-brazilian-pix-and-stablecoin-payments

## What it 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.

## Requirements
- Remote server: `https://api.luniumpay.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http pix-brazilian-payments https://api.luniumpay.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add lunium-brazilian-pix-and-stablecoin-payments --url https://api.luniumpay.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "lunium-brazilian-pix-and-stablecoin-payments": {
            "url": "https://api.luniumpay.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "lunium-brazilian-pix-and-stablecoin-payments": {
            "type": "http",
            "url": "https://api.luniumpay.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http lunium-brazilian-pix-and-stablecoin-payments https://api.luniumpay.com/mcp
```

## When to use it
- 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
- 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.

## Similar
- [mcp-pix-bcb](https://affpapa.org/en/nevibecode/mcp/mcp-pix-bcb.md) — MCP server · ★ 279 repo stars
- [BananaCrystal: FX rates, swaps and payments in 140+ currencies](https://affpapa.org/en/nevibecode/mcp/bananacrystal-fx-rates-swaps-and-payments-in-140-currencies.md) — MCP server · ★ 4 repo stars
- [mcp-unblockpay](https://affpapa.org/en/nevibecode/mcp/mcp-unblockpay.md) — MCP server · ★ 279 repo stars
- [pluggy-payments](https://affpapa.org/en/nevibecode/skills/pluggy-payments.md) — skill · 446 installs
- [Coal - Payments for AI agents](https://affpapa.org/en/nevibecode/mcp/coal-payments-for-ai-agents.md) — MCP server · 1558 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
