# Pagar.me MCP for AI Agents AI Agent Connect

> Pagar.me MCP lets you handle Brazilian payments directly through your AI client. Create Pix QR codes, generate Boleto Bancário, and manage recurring subscriptions without leaving your chat. It connects your agent to the Pagar.me payment gateway to handle customer registrations, order tracking, and real-time transaction statuses.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_d8ZIp00FEg3zpn3ieRdMWqLt57HQWqBBDudfBcN1/ai-agent-connect
- **Tags:** payment-gateway, pix, boleto, subscription-management, transaction-tracking, order-management

## Description

Imagine you're running a Brazilian SaaS or an e-commerce store and you need to handle payments quickly. Instead of jumping between a payment dashboard and your internal tools, you can just tell your AI agent what to do. This Connector bridges that gap, letting your agent handle the heavy lifting of the Brazilian payment landscape. You can ask it to set up a new customer with their CPF or CNPJ, generate a Pix payment link for a sale, or create a Boleto with a specific due date. It also handles the recurring side of things, making it easy to manage monthly subscriptions and check if those payments actually went through. Because Vinkius hosts this Connector, you get a reliable way to plug this entire payment infrastructure into your existing workflow. You'll stop copy-pasting data and start letting your agent manage the actual lifecycle of an order, from initial creation to final capture.

## Tools

### cancel_order
Stop an existing order to prevent it from being processed. Use this when a customer changes their mind before payment.

### capture_order
Finalize and collect funds from an order that has been authorized. This is the final step for completing credit card transactions.

### create_customer
Register a new customer profile using their CPF or CNPJ information. It keeps your payment gateway updated with the latest client data.

### get_customer
Pull specific details for a registered customer from the system. Use this to quickly check a client's profile or history.

### create_boleto_order
Create a new order specifically for payments made via Boleto Bancário. This helps customers who prefer bank slips over instant payments.

### get_order
Retrieve the full details of a specific order to check its current status. It's the fastest way to see if a payment is pending or paid.

### get_subscription
View the details of a recurring billing plan for a specific customer. Check active plans and billing dates in one step.

### list_orders
Get a list of the most recent orders to monitor recent sales activity. It provides a quick overview of your recent transaction flow.

### create_order
Create a new order using credit cards or custom payment methods. This is the standard way to start a new checkout process.

### create_pix_order
Generate an instant Pix QR code that expires in one hour. Give your customers an immediate way to pay via the Pix network.

### create_subscription
Set up a recurring billing cycle for a customer on a specific plan. This automates your monthly or yearly revenue collection.

## Prompt Examples

**Prompt:** 
```
Create a Pix order for R$50.00 for customer João Silva.
```

**Response:** 
```
### Pix Order Created

I've successfully generated the Pix payment for **João Silva**.

| Detail | Information |
|---|---|
| **Amount** | R$ 50.00 |
| **Status** | Pending |
| **Payment Method** | Pix |

**QR Code:** [Generated QR Image]

*Please share this QR code with the customer. It expires in 1 hour.*
```

**Prompt:** 
```
Show me the last 5 orders.
```

**Response:** 
```
### Recent Orders

Here are the last 5 transactions processed through Pagar.me:

1. **R$ 50.00** — Paid (Pix)
2. **R$ 120.00** — Pending (Credit Card)
3. **R$ 15.00** — Expired (Boleto)
4. **R$ 200.00** — Paid (Boleto)
5. **R$ 35.00** — Paid (Pix)

Let me know if you need details on a specific order.
```

**Prompt:** 
```
Create a monthly subscription of R$99.90 for customer 123 on plan 456.
```

**Response:** 
```
### Subscription Confirmed

I've set up the recurring billing for customer **123**.

- **Plan**: 456
- **Amount**: R$ 99.90
- **Frequency**: Monthly
- **Status**: Active
- **Next Billing Date**: 2026-04-01

Your agent has updated the subscription status in the gateway.
```

## Capabilities

### Generate Pix QR codes
Create instant payment links for immediate customer checkout.

### Issue Boleto Bancário
Create bank slips with custom due dates for offline payments.

### Manage recurring billing
Set up and track monthly or yearly subscriptions for your customers.

### Register new customers
Save customer details including CPF and CNPJ directly into the gateway.

### Track order history
Pull a list of recent transactions to check payment statuses.

### Capture authorized payments
Finalize credit card transactions that are currently pending.

## Use Cases

### Instant Pix Checkout
A customer wants to buy a product now. You ask your agent to create a Pix order for R$50.00, and it gives them the QR code immediately.

### SaaS Billing Setup
A new user signs up for a monthly plan. You tell your agent to create a subscription for customer 123 on plan 456, and it handles the billing logic.

### Bulk Order Review
You need to see what happened today. Your agent uses list_orders to show you a summary of all paid and pending transactions.

### Customer Onboarding
You need to register a new client. You give your agent the customer's CPF, and it uses create_customer to get them into the system.

## Benefits

- Stop manual data entry by using create_customer to save Brazilian tax IDs like CPF or CNPJ directly into your payment gateway.
- Speed up checkouts by using create_pix_order to get QR codes to your customers instantly without leaving the chat.
- Automate recurring revenue by using create_subscription to handle monthly billing cycles for your SaaS users.
- Improve order visibility by using list_orders to get a quick summary of recent sales and payment statuses.
- Reduce payment friction by using create_boleto_order to generate bank slips with custom due dates for your clients.
- Simplify fulfillment by using capture_order to finalize authorized credit card payments with a single command.

## How It Works

The bottom line is you can manage your entire Brazilian payment flow through a simple chat interface.

1. Subscribe to the Pagar.me MCP on Vinkius.
2. Provide your Pagar.me Secret Key in the configuration.
3. Use your AI client to create orders, manage subscriptions, or check payment statuses.

## Frequently Asked Questions

**Can I use Pagar.me MCP to accept Pix payments?**
Yes, you can use this Connector to generate instant Pix QR codes for your customers. Your agent handles the request and gives you the code to share immediately.

**Does Pagar.me MCP support Boleto Bancário?**
Yes, it allows your agent to create Boleto orders with custom due dates. This is great for customers who prefer bank slips over instant payments.

**How do I manage recurring billing with Pagar.me MCP?**
You can tell your agent to create subscriptions for your customers. It handles the setup of recurring plans and can check the status of existing ones.

**Can I register new customers through the Pagar.me MCP?**
Yes, your agent can register new customers using their CPF or CNPJ. This keeps your customer data synced with your payment gateway.

**Can I track my sales history using Pagar.me MCP?**
You can ask your agent to list recent orders. It will pull a summary of your latest transactions so you can see what's pending or paid.

**Is Pagar.me MCP good for Brazilian SaaS businesses?**
It's ideal for Brazilian SaaS because it handles Pix, Boleto, and recurring subscriptions, which are the primary ways people pay in Brazil.

**How do I get my Secret Key?**
Log in to the Pagar.me dashboard, navigate to **Settings > API Keys** and copy your **Secret Key** (starts with `sk_...`). No complex OAuth apps, no webhooks — just connect and start processing payments.

**Does it support Pix and Boleto?**
Yes! Generate instant Pix QR Codes or Boletos right in the chat. Your agent handles the entire checkout flow — creating the order, retrieving the payment code, and allowing the customer to pay without ever leaving the conversation.

**Can I manage subscriptions?**
Yes. Just tell your AI agent to subscribe a new customer. It will register the customer, attach them to your predefined SaaS recurring plan, and confirm the active billing status — all in a single prompt without touching a dashboard.

**Can I manage complete customer profiles and track their transaction histories?**
Absolutely. View detailed customer records, pull entire order histories, and verify payment statuses instantly — perfect for SaaS founders, customer support teams, and digital agencies handling multiple accounts.