# Pagar.me MCP > Pagar.me connects your AI agent to Brazil's payments system. Create orders using Pix, Boleto, or credit cards, manage recurring customer subscriptions, and track all transactions through natural conversation. Handle complex Brazilian financial flows without leaving your chat interface. ## Overview - **Category:** money-moves - **Price:** Free - **Tags:** payment-gateway, pix, boleto, subscription-management, transaction-tracking, order-management ## Description Need to process sales in Brazil? This MCP lets you connect your payment processing directly into your AI client. You can initiate orders for any item using multiple methods like Pix, Boleto, or a credit card. Need recurring revenue? Set up and manage customer subscriptions right from the conversation. It also handles core tasks like registering new customers and listing past transactions to keep your records clean. By connecting Pagar.me through Vinkius, you give your agent access to deep payment infrastructure. Your client can now track order status or create an instant Pix QR code—all without needing a web login. It’s about giving your AI workflow the financial muscle it needs for the Brazilian market. ## Tools ### create_boleto_order Creates a new order that requires payment using the Boleto method. ### cancel_order Marks an existing order as canceled in the system. ### capture_order Finalizes a previously authorized order, capturing the funds. ### create_customer Registers a new user account using their CPF or CNPJ identifiers. ### get_customer Retrieves all relevant details about an existing customer profile. ### get_order Fetches the full details, including items and payment status, for one specific order number. ### get_subscription Retrieves current billing cycle information for a customer's subscription plan. ### list_orders Lists the most recent orders processed through the gateway, giving you an overview of activity. ### create_order Generates a new order that accepts payments via credit card or custom payment methods. ### create_pix_order Creates an urgent, time-sensitive order specifically for immediate Pix payments. ### create_subscription Sets up a continuous billing cycle, defining the recurring plan for a customer. ## Prompt Examples **Prompt:** ``` Create a Pix order for R$50.00 for customer João Silva. ``` **Response:** ``` Pix order created! QR Code generated. Waiting for payment. ``` **Prompt:** ``` Show me the last 5 orders. ``` **Response:** ``` Found 5 orders: 1. R$ 50.00 (Pix - Paid). 2. R$ 120.00 (Card - Pending). 3. R$ 15.00 (Boleto - Expired). ``` **Prompt:** ``` Create a monthly subscription of R$99.90 for customer 123 on plan 456. ``` **Response:** ``` Subscription created successfully! Status: Active. Next billing date: 2026-04-01. ``` ## Capabilities ### Generate payments via Pix The system creates an immediate payment order and generates the necessary QR code. ### Process card or Boleto orders You can create new orders using traditional credit cards or generating a specific Boleto Bancário payment slip. ### Manage recurring billing The MCP sets up and updates subscription plans for existing customers. ### Handle customer profiles You can register new people or retrieve detailed history for established accounts using their CPF or CNPJ. ### Check order status The agent retrieves specific details on any existing order, letting you know if it's paid, pending, or canceled. ## Use Cases ### Fulfilling a new client payment A sales agent needs to onboard a new client. Instead of sending them a link, they ask their AI agent: 'Create an order for 3 months using the subscription tool and pay with a credit card.' The agent executes create_subscription and create_order in one go. ### Handling bulk transaction checks The ops team needs to know if payments went through yesterday. They simply ask their AI client: 'Show me the last 5 orders.' The agent uses list_orders and provides a formatted summary of payment statuses. ### Troubleshooting an expired payment A customer reports that a Boleto they paid never registered. The support agent asks: 'What is the status of order #987?' The agent uses get_order to confirm if the transaction was successful or expired. ### Automating product launches The marketing team wants to launch a limited-time sale. They instruct their AI agent: 'Generate an order for R$100 using create_pix_order.' The system instantly provides the payment details needed. ## Benefits - Process payments immediately through Pix or Boleto directly from your agent, removing the need for manual QR code generation outside of the chat. - Handle complex billing lifecycles by using create_subscription to set up recurring revenue streams, which is crucial for any SaaS model. - Keep track of everything with list_orders and get_order. You can query transaction history and status checks in one conversational step. - Build customer records accurately using create_customer, ensuring your agent always has the proper CPF or CNPJ data before placing an order. - The ability to capture funds using capture_order means you can authorize a sale now and take the money later when all conditions are met. ## How It Works The bottom line is that you get to manage complex sales and financial processes using simple chat commands, keeping everything contained in your AI workflow. 1. Subscribe to this MCP and provide your Pagar.me Secret Key in the Vinkius catalog. 2. Your AI client sends a natural language request (e.g., 'Create a Pix order for R$100'). 3. The MCP executes the payment flow, generating confirmation or necessary codes directly within the conversation. ## Frequently Asked Questions **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.