# Efí Pay MCP for AI Agents AI Agent Connect

> Efí Pay MCP lets you manage Brazilian payments directly through your AI agent. You can generate dynamic Pix charges, issue Boletos, and check your account balances or transaction histories without switching tabs. It handles the heavy lifting of connecting to one of Brazil's largest payment platforms so you can focus on closing deals.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_6xawcLNxsvGzte9MFJUeGDOzAPkg5ZBhkJomgify/ai-agent-connect
- **Tags:** pix-payments, digital-banking, invoicing, financial-automation, transaction-status, payment-gateway

## Description

If you're running a business in Brazil, you know the friction of jumping between your customer chat and your banking portal. It's a constant cycle of logging in, finding the right menu, and copying long strings of numbers into a message. This Connector changes that by bringing your Efí Pay account directly into your AI workspace. Instead of manual data entry, you can just tell your agent to handle the invoicing. You can issue bank slips with specific dates, send real-time Pix charges, and pull full statements for your monthly reconciliation. It takes care of the technical handshake with the payment platform, so you can treat your financial operations like a conversation. It's one of the many ways you can connect your professional stack through the Vinkius catalog to make your daily routine feel less like a chore and more like actual work.

## Tools

### efi_get_balance
Check your current Efí Pay account balance instantly. This gives you a real-time view of your available funds.

### efi_get_pix_payment
Look up the status of a specific Pix transaction using its ID. This helps you confirm if a customer's payment was successful.

### efi_create_boleto
Generate a traditional Brazilian bank slip with specific dates and amounts. This creates a formal payment document for your customers.

### efi_get_statement
Pull a summary of all account movements and transactions. This provides a full history of your banking activity.

### efi_list_boletos
List all issued bank slips and their statuses over a date range. This helps you track which invoices are still unpaid.

### efi_create_pix_charge
Create a dynamic Pix Cob charge with an expiration time for customers. This generates a unique payment link for immediate settlement.

### efi_list_pix_charges
View all Pix Cob charges, whether paid or pending, in a specific timeframe. This lets you monitor all active payment requests.

### efi_send_pix
Send a real-time Pix payment to any external key or recipient. This lets you pay others directly from your agent.

## Prompt Examples

**Prompt:** 
```
Create a Pix charge for R$ 200.00 that expires in 15 minutes.
```

**Response:** 
```
I've generated that Pix charge for you. Here is the copy-paste string and the dynamic BR Code for your customer:

**Payment Details:**
- **Amount:** R$ 200.00
- **Status:** Pending
- **Copy & Paste:** `00020003...` 

Let me know if you need anything else!
```

**Prompt:** 
```
Is the payment for txid 987654321 confirmed?
```

**Response:** 
```
Checking the status... 

✅ **Confirmed**

The Pix transaction `987654321` is marked as **CONCLUIDA**. The funds have been successfully deposited into your account balance.
```

**Prompt:** 
```
List all the bank slips we've issued this week.
```

**Response:** 
```
I've pulled the records for you. You've issued **12 Boletos** this week:

| Date | Amount | Status |
|---|---|---|
| Oct 24 | R$ 450.00 | Paid |
| Oct 25 | R$ 1,200.00 | Pending |
| Oct 26 | R$ 300.00 | Paid |

Would you like me to send a reminder for the pending one?
```

## Capabilities

### Generate dynamic Pix charges
Create unique Pix Cob payments with expiration times for your customers.

### Issue traditional bank slips
Generate Brazilian Boletos with specific dates, amounts, and payer details.

### Check real-time payment status
Verify if a specific Pix transaction was successful using its unique ID.

### Retrieve account balances
Get a real-time look at your current Efí Pay account balance.

### Download historical statements
Pull a full summary of all account movements over a specific date range.

### Send Pix payments
Send real-time Pix payments to external keys or recipients instantly.

## Use Cases

### Instant Order Verification
A customer sends a Pix txid. The ops lead asks the agent to check if it's confirmed using `efi_get_pix_payment` before marking the order as Paid.

### On-the-Fly Invoicing
A customer requests a custom quote. The founder asks the agent to create a boleto for the amount using `efi_create_boleto` and paste the details into the chat.

### Automated Monthly Audits
A controller needs to see all transactions from last month. They ask the agent to pull the statement using `efi_get_statement` and summarize the totals.

### Direct Vendor Payments
A business needs to pay a vendor immediately. They tell the agent to send a Pix payment using `efi_send_pix` to the vendor's key.

## Benefits

- Stop tab-switching by using `efi_create_pix_charge` to send payment links directly in your customer chat.
- Speed up order fulfillment by using `efi_get_pix_payment` to verify funds before you ship products.
- Automate your bookkeeping by pulling historical data with `efi_get_statement` for easy reconciliation.
- Reduce manual errors in invoicing by using `efi_create_boleto` to set exact expiration dates and totals.
- Get a real-time pulse on your cash flow with `efi_get_balance` available at any moment.
- Track your outstanding debt easily by using `efi_list_boletos` to see what's still unpaid.

## How It Works

The bottom line is you get a direct line to Brazilian payment processing without leaving your chat interface.

1. Get your Client_ID, Client_Secret, and .p12 certificate from your Efí Back Office.
2. Convert that .p12 certificate into a Base64 string.
3. Paste those credentials into your MCP-compatible client.

## Frequently Asked Questions

**What can I do with the Efí Pay MCP?**
You can manage your Brazilian payments directly through your AI agent. This includes creating Pix charges, issuing bank slips, and checking your account balances or history.

**How does this help with Pix payments?**
It lets you generate instant Pix Cob charges and verify payment statuses in real-time. This means you can confirm customer payments and share payment links without leaving your chat app.

**Can I use this to send money to others?**
Yes, the Connector allows your agent to send real-time Pix payments to external keys or recipients on your behalf.

**How do I get my bank statements?**
You can simply ask your agent to pull your historical statements. It will retrieve a summary of your account movements over any date range you specify.

**Is this for Brazilian businesses only?**
Yes, this Connector is specifically designed for the Efí Pay (formerly Gerencianet) ecosystem, which is a primary payment platform for businesses operating in Brazil.

**Can I check if a customer's payment went through?**
Absolutely. By providing the transaction ID (txid), your agent can check the status of a Pix payment and tell you immediately if it's confirmed.

**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 Connector 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.