Pix MCP Server

The Pix MCP Server is a lightweight, zero‑dependency solution that brings the Brazilian Pix instant payment system into the world of AI assistants. By exposing a single, well‑defined tool——the server allows agents such as Claude, Cursor, or Windsurf to create fully‑compliant QR codes for any Pix key simply through natural‑language prompts. This removes the need for developers to integrate with external payment APIs, handle key validation, or manage cryptographic checksums; the server takes care of all that behind a clean MCP interface.

At its core, the server generates static Pix QR codes that adhere to BACEN’s EMV 4.0 specification, including proper CRC16‑CCITT validation. The implementation is written in TypeScript and uses Zod for runtime type safety, ensuring that only valid payment data reaches the QR‑generation logic. Comprehensive error handling and logging make the service production‑ready, while the ability to run in either MCP or HTTP mode gives teams flexibility: native AI tool integrations can use stdio, whereas web services can expose a REST endpoint.

Key capabilities include:

• Zero external dependencies – no API keys or third‑party services are required, simplifying deployment and reducing attack surface.
• Type safety and validation – every input is checked against strict schemas, preventing malformed QR codes.
• Open & accessible – the server works out of the box without registration, making it ideal for rapid prototyping or internal tooling.
• EMV 4.0 compliance – payments generated by the server are guaranteed to be accepted by any Pix‑enabled terminal or app.

Typical use cases span from e‑commerce checkout flows that need instant payment links, to chatbot assistants that can generate a QR code for a user’s lunch order or a small business invoice. In a development workflow, the server can be spun up locally during testing and later deployed to Railway or any cloud platform with minimal configuration. By integrating directly into the MCP ecosystem, developers can focus on business logic while delegating payment‑QR generation to a proven, standards‑compliant service.