Bring Pix Payments
to Mastra AI
Efí Pay (Gerencianet) MCP Server · 8 tools available to AI Agents
What is the Efí Pay (Gerencianet) MCP Server?
The Efí Pay MCP Server connects your AI agent directly to one of Brazil's largest payment and digital account platforms (formerly Gerencianet). Command your agent to handle invoicing seamlessly using natural language.
What you can do
- Pix Management — Generate dynamic immediate charges (Pix Cob), check specific payment statuses in real-time, and send Pix directly to external keys.
- Traditional Invoicing — Emit traditional Brazilian bank slips (Boletos) with specified expiration dates, item totals, and payer documents (CPF/CNPJ).
- Account Overviews — Ask your agent to retrieve your current Efí account balance or pull a complete historical banking statement over a defined date range.
How it works
1. Subscribe to this server.
2. In your Efí Back Office, generate your Client_ID, Client_Secret and .p12 Certificate.
3. Convert your .p12 certificate into a Base64 string.
4. Input the credentials in your MCP-compatible client.
Who is this for?
- SaaS Founders — quickly issue a boleto for a customer directly from your terminal or chat without opening the bank Dashboard.
- E-commerce Ops — instantly verify whether a specific Pix
txidhas been paid to fulfill an order right from your internal agent. - Financial Controllers — extract statements and daily balances dynamically to aid reconciliation.
Built-in capabilities (8)
Gerar um banco slip tradicional brasileiro (Boleto)
Emitir cobrança imediata via Pix (Cob)
Consultar o resuldado / Saldo atual da conta digital (Efí Pay)
Consultar um único pagamento Pix recebido específico
Consultar o Resumo (Statement / Extrato) das movimentações da conta
Listar todos os Boletos e transações emitidos em um range de datas
Consultar cobranças Pix (Cob) recebidas ou geradas num intervalo
Enviar um Pix em tempo real para terceiros
Why Mastra AI?
Mastra's agent abstraction provides a clean separation between LLM logic and Efí Pay (Gerencianet) tool infrastructure. Connect 8 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
- —
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Efí Pay (Gerencianet) without touching business code
- —
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
- —
TypeScript-native: full type inference for every Efí Pay (Gerencianet) tool response with IDE autocomplete and compile-time checks
- —
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
Efí Pay (Gerencianet) in Mastra AI
Efí Pay (Gerencianet) and 2,500 other MCP servers. One platform. One governance layer.
Teams that connect Efí Pay (Gerencianet) to Mastra AI through Vinkius don't need to source, host, or maintain individual MCP servers. Every tool call runs inside a hardened runtime with credential isolation, DLP, and a signed audit chain.
Raw MCP | Vinkius | |
|---|---|---|
| Server catalog | Find and host yourself | 2,500+ managed |
| Infrastructure | Self-hosted | Sandboxed V8 isolates |
| Credential handling | Plaintext in config | Vault + runtime injection |
| Data loss prevention | None | Configurable DLP policies |
| Kill switch | None | Global instant shutdown |
| Financial circuit breakers | None | Per-server limits + alerts |
| Audit trail | None | Ed25519 signed logs |
| SIEM log streaming | None | Splunk, Datadog, Webhook |
| Honeytokens | None | Canary alerts on leak |
| Custom domains | Not applicable | DNS challenge verified |
| GDPR compliance | Manual effort | Automated purge + export |
Why teams choose Vinkius for Efí Pay (Gerencianet) in Mastra AI
The Efí Pay (Gerencianet) MCP Server runs on Vinkius-managed infrastructure inside AWS — a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts. All 8 tools execute in hardened sandboxes optimized for native MCP execution.
Your AI agents in Mastra AI only access the data you authorize, with DLP that blocks sensitive information from ever reaching the model, kill switch for instant shutdown, and up to 60% token savings. Enterprise-grade infrastructure, zero maintenance.
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
How Vinkius secures
Efí Pay (Gerencianet) for Mastra AI
Every tool call from Mastra AI to the Efí Pay (Gerencianet) MCP Server is protected by DLP redaction, cryptographic audit chains, V8 sandbox isolation, kill switch, and financial circuit breakers.
Frequently asked questions
How do I setup my Base64 Certificate and API credentials?
Log into your Efí account, go to API > Applications. Create an app to get the Client ID and Secret. Then generate a Production Certificate (.p12). Instead of uploading the file to Vinkius, use terminal command base64 -i your_cert.p12 to convert it into a plaintext string, and paste that robust text directly into the MCP configuration.
Can I automatically verify if a customer paid a Pix charge just by chatting with my AI?
Yes! Provide the agent the exact transaction id (txid) of the generated Pix. The agent will query the efi_get_pix_payment tool and immediately tell you if the status is active, answered, or expired.
Does the integration support transferring money out (Cash-out)?
Yes. Using the efi_send_pix action, you can initiate outbound immediate payments requesting the agent to process a value directly to a receiver Pix key.
Can I query a history of paid bank slips (Boletos) at the end of the day or month?
Certainly. The efi_list_boletos and efi_get_statement tool allows you to perform large queries parsing begin/end dates to return summaries directly in your terminal.
How does Mastra AI connect to MCP servers?
Create an MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.
Can Mastra agents use tools from multiple servers?
Yes. Pass multiple MCP clients to the agent constructor. Mastra merges all tool schemas and the agent can call any tool from any server.
Does Mastra support workflow orchestration?
Yes. Mastra has a built-in workflow engine that lets you chain MCP tool calls with branching logic, error handling, and parallel execution.
createMCPClient not exported
Install: npm install @mastra/mcp
Connect Efí Pay (Gerencianet) with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
Type-safe agent development for Python with first-class MCP support.
TypeScript toolkit for building AI-powered web applications.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Give your AI agents the power of Efí Pay MCP Server
Production-grade Efí Pay (Gerencianet) MCP Server. Verified, monitored, and maintained by Vinkius. Ready for your AI agents — connect and start using immediately.