Official description7 sourcesMCP servers8d ago
Regenerating-World/pix-mcp
๐ โ๏ธ - Generate Pix QR codes and copy-paste strings with fallback across multiple providers (Efรญ, Cielo,โฆ
View on GitHub โDirect link ยท no redirect page
Official descriptionPix MCP Server v2.1.0 A lightweight Model Context Protocol (MCP) server that enables AI agents (Claude, Cursor, Windsurf) to generate static Pix QR codes via natural-language prompts.
Config template (adjust for your client)
claude mcp add pix-mcp -- npx -y pix-mcp
A pasteable skeleton generated from the repository name. Check the project README for the exact package and arguments.
- Star count
- 3 โ ยท Regenerating-World/pix-mcp ยท read from the repository page ยท (checked 2026-10-16 20:00:20)
- Source
- collected from the punkpeye/awesome-mcp-servers list ยท type: MCP server
- Harvest history
- first seen 2026-10-09 ยท last seen 2026-10-16 ยท seen 32ร ยท listed by 7 sources
- Score
- score 703 ยท 3 โ ยท 7 sources ยท mcp
FAQ (answers come from our records)
How do I install it?
We did not find an install command for this repository (our install coverage is only about 4%). Check its README or releases page.
Who is it for?
We filed it under these tags: MCP ๆๅก. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
Regenerating-World/pix-mcp๏ผfirst catalogued 2026-10-09๏ผlast seen 2026-10-16ใThere is no official certification or quality rating here โ we record sources and dates only.Third-party quality signals
Pix MCP Server v2.1.0
ไปฅไธๆๅฝ่ช่ฏฅไปๅบ็ README๏ผ็ๆฎต๏ผ ยท ๅจ GitHub ่ฏปๅฎๆด README โ
A lightweight Model Context Protocol (MCP) server that enables AI agents (Claude, Cursor, Windsurf) to generate static Pix QR codes via natural-language prompts.
๐ Features
- **๐ง MCP Tool**:
- generateStaticPix - Generate static Pix QR codes for any Pix key (no API required)
- **๐ Production-ready**: Comprehensive error handling and logging
- **๐ Type-safe**: Full TypeScript implementation with Zod validation
- **๐ฑ QR Code generation**: Automatic QR code creation for Pix payments
- **๐ฆ Zero Dependencies**: No external API keys or services required
- **๐ Open & Accessible**: Works without any registration or credentials
- **โ EMV 4.0 Compliant**: Follows BACEN PIX standards with proper CRC16-CCITT validation
๐ Quick Start
๐ง Usage
MCP Mode (Default)
HTTP Mode
Making Requests
HTTP API
MCP Tool
๐ Deployment
Railway
**โ ๏ธ Important:** After deploying to Railway, add these environment variables in the Railway dashboard:
- MCP_MODE=http
- NODE_ENV=production (optional)
Manual Deployment
๐ License
MIT
๐ง Configuration
Environment Variables
- MCP_MODE: Server mode (stdio for MCP, http for HTTP API) - Default: stdio
- NODE_ENV: Environment (development/production) - Default: development
- PORT: HTTP port when in HTTP mode - Default: 3000
๐ค Usage with AI Tools
Claude Desktop
1. Install the package globally:
2. Add to your Claude Desktop MCP configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%/Claude/claude_desktop_config.json on Windows):
3. Restart Claude Desktop and start using:
Cursor (with MCP support)
Add to your Cursor MCP settings:
Windsurf (with MCP support)
Configure in Windsurf MCP settings:
Any MCP-compatible tool
Your tool should support MCP servers. Configure using:
- **Command**: npx pix-mcp or pix-mcp (if installed globally)
- **Protocol**: stdio
- **Environment**: MCP_MODE=stdio
๐จ Available Tools
generateStaticPix
Creates a static Pix payment QR code following BACEN EMV 4.0 standards.
**Parameters:**
- pixKey (string): Valid Pix key (email, phone, CPF, CNPJ, or random key)
- amount (number): Payment amount in BRL (0.01 to 999,999.99)
- recipientName (string): Name of the payment recipient (max 25 chars)
- recipientCity (string): City of the payment recipient (max 15 chars)
**Returns:**
- Payment details (amount, recipient, city)
- Pix copy-paste code (EMV format)
- QR code image (base64 data URL)
- Success status and message
**Supported Pix Key Types:**
- ๐ง Email: example@email.com
- ๐ฑ Phone: +5511999999999
- ๐ค CPF: 12345678901 (11 digits)
- ๐ข CNPJ: 12345678000195 (14 digits)
- ๐ Random Key: 123e4567-e89b-12d3-a456-426614174000 (UUID format)
๐๏ธ Development
๐บ๏ธ Roadmap
Phase 1: MVP โ
- [x] generateStaticPix tool
- [x] Static Pix QR code generation
- [x] QR code generation
- [x] Claude Desktop compatibility
- [x] EMV 4.0 compliance
- [x] CRC16-CCITT validation
- [x] All Pix key types support
- [x] Public deployment
๐ Features
- **๐ง MCP Tool**:
- generateStaticPix - Generate static Pix QR codes for any Pix key (no API required)
- **๐ Production-ready**: Comprehensive error handling and logging
- **๐ Type-safe**: Full TypeScript implementation with Zod validation
- **๐ฑ QR Code generation**: Automatic QR code creation for Pix payments
- **๐ฆ Zero Dependencies**: No external API keys or services required
- **๐ Open & Accessible**: Works without any registration or credentials
- **โ EMV 4.0 Compliant**: Follows BACEN PIX standards with proper CRC16-CCITT validation
๐ Quick Start
๐ง Usage
MCP Mode (Default)
HTTP Mode
Making Requests
HTTP API
MCP Tool
๐ Deployment
Railway
**โ ๏ธ Important:** After deploying to Railway, add these environment variables in the Railway dashboard:
- MCP_MODE=http
- NODE_ENV=production (optional)
Manual Deployment
๐ License
MIT
๐ง Configuration
Environment Variables
- MCP_MODE: Server mode (stdio for MCP, http for HTTP API) - Default: stdio
- NODE_ENV: Environment (development/production) - Default: development
- PORT: HTTP port when in HTTP mode - Default: 3000
๐ค Usage with AI Tools
Claude Desktop
1. Install the package globally:
2. Add to your Claude Desktop MCP configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%/Claude/claude_desktop_config.json on Windows):
3. Restart Claude Desktop and start using:
Cursor (with MCP support)
Add to your Cursor MCP settings:
Windsurf (with MCP support)
Configure in Windsurf MCP settings:
Any MCP-compatible tool
Your tool should support MCP servers. Configure using:
- **Command**: npx pix-mcp or pix-mcp (if installed globally)
- **Protocol**: stdio
- **Environment**: MCP_MODE=stdio
๐จ Available Tools
generateStaticPix
Creates a static Pix payment QR code following BACEN EMV 4.0 standards.
**Parameters:**
- pixKey (string): Valid Pix key (email, phone, CPF, CNPJ, or random key)
- amount (number): Payment amount in BRL (0.01 to 999,999.99)
- recipientName (string): Name of the payment recipient (max 25 chars)
- recipientCity (string): City of the payment recipient (max 15 chars)
**Returns:**
- Payment details (amount, recipient, city)
- Pix copy-paste code (EMV format)
- QR code image (base64 data URL)
- Success status and message
**Supported Pix Key Types:**
- ๐ง Email: example@email.com
- ๐ฑ Phone: +5511999999999
- ๐ค CPF: 12345678901 (11 digits)
- ๐ข CNPJ: 12345678000195 (14 digits)
- ๐ Random Key: 123e4567-e89b-12d3-a456-426614174000 (UUID format)
๐๏ธ Development
๐บ๏ธ Roadmap
Phase 1: MVP โ
- [x] generateStaticPix tool
- [x] Static Pix QR code generation
- [x] QR code generation
- [x] Claude Desktop compatibility
- [x] EMV 4.0 compliance
- [x] CRC16-CCITT validation
- [x] All Pix key types support
- [x] Public deployment
- Source
- awesome ยท https://github.com/Regenerating-World/pix-mcp
- Browse by field
- MCP servers
- Traction
- 3 โ
- added
- yesterday
More in MCP servers
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.