PagBank PagSeguro MCP. Manage Brazilian Payments (Pix, Boleto, Cards) from Chat
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
PagBank PagSeguro connects your AI agent directly to Brazil's major payment flows. Use this server to generate Pix QR codes, Boleto payments, and checkout links for credit cards.
You can also check account balances, search transactions by date range, or issue full/partial refunds—all via natural conversation.
What your AI agents can do
Cancel transaction
Cancels a payment, allowing you to process full or partial refunds on existing transactions.
Create boleto payment
Generates the required data and link for a Boleto Bancário payment slip.
Create checkout link
Creates a unified payment checkout link that supports multiple items and card installments.
Creates an instant payment request by generating a unique QR code for the specified amount.
Creates a Boleto Bancário payment slip, providing a non-card option for customers.
Generates a single URL and code that handles payments involving multiple items or credit card installments.
Retrieves the current available balance of your connected PagBank account.
Looks up specific payment records using a transaction code or searches history within defined date ranges.
Cansels existing transactions, supporting both full and partial refund amounts.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
PagBank PagSeguro: 9 Tools for Brazilian Payments
These tools let your AI agent handle everything from generating instant Pix codes to managing complex transaction histories and issuing refunds.
019d75eecancel transaction
Cancels a payment, allowing you to process full or partial refunds on existing transactions.
019d75eecreate boleto payment
Generates the required data and link for a Boleto Bancário payment slip.
019d75eecreate checkout link
Creates a unified payment checkout link that supports multiple items and card installments.
019d75eecreate pix payment
Generates an immediate Pix QR code and data for instant payments.
019d75eeget balance
Retrieves the current, available funds balance from your PagBank account.
019d75eeget installment options
Looks up valid installment payment options for a specific credit card brand and purchase total.
019d75eeget order
Fetches the full details of an order using its unique ID.
019d75eeget transaction
Retrieves specific records and details for a payment transaction based on a given code.
019d75eesearch transactions
Searches through your historical payments, filtering results by a specified date range.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with PagBank PagSeguro, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Your AI client connects directly to Brazil’s major payment flows through this server. You can generate Pix QR codes, Boleto payments, and checkout links for credit cards—all without ever leaving your chat window.
Making Payments:
When you need to process an immediate transaction, use the create_pix_payment tool; it generates a unique QR code and all the necessary data so customers can pay instantly. If you're dealing with clients who don't use cards or prefer manual payment options, you'll run create_boleto_payment, which builds the required Boleto Bancário payment slip details.
For payments involving multiple products or if a customer needs to spread out the cost using credit card installments, you’ll hit up create_checkout_link. This single function builds one unified URL and code that handles all those complex options for you.
Managing Funds & Orders:
Before you process anything, you need to know what cash you've got. Run the get_balance tool anytime you want to check your current available funds from your PagBank account. If a customer gives you an order ID, use get_order to pull up every single detail about that purchase.
You can also get specifics on any payment by running get_transaction, which pulls detailed records using a specific transaction code. Need to find out what happened last month? Just run search_transactions; it lets you scope your historical payments down by specifying a date range.
Handling Returns and Adjustments:
If something goes wrong, these tools fix it. You can cancel existing transactions—whether the refund is for the full amount or just a partial amount—by executing cancel_transaction. This keeps your books clean. Furthermore, if you need to check what specific installment plans are available for a client's credit card brand given a purchase total, you’ll use get_installment_options.
How PagBank PagSeguro MCP Works
- 1 First, provide your PagBank Production or Sandbox Access Token when connecting the server.
- 2 Next, ask your AI agent to perform a task (e.g., 'Check my balance' or 'Create a Pix payment of R$25').
- 3 The agent calls the appropriate tool, gets confirmation/data back, and executes the action within your chat client.
The bottom line is that you treat complex financial operations like simple conversational commands.
Who Is PagBank PagSeguro MCP For?
This is for Brazilian e-commerce managers and developers who deal with payments daily. If you're tired of switching between the dashboard, manually copying codes, and juggling different payment methods (Pix, Boleto, Cards), this saves your time. You need a single point of control to manage money moves from chat.
Uses the agent to monitor daily transactions, check balances, and issue refunds without logging into the payment portal.
Accepts payments instantly from customers by generating Pix codes or Boleto links through conversation.
Integrates payment validation and transaction logging into AI-driven workflows, avoiding complex SDK boilerplate code.
What Changes When You Connect
- Process payments without leaving your chat. You can generate Pix QR codes or Boleto links directly through natural conversation.
- Audit funds instantly. Use
get_balanceto check your current available account balance whenever you need it. - Handle complex orders easily. The
create_checkout_linktool builds payment URLs that support multiple items and credit card installments. - Reconcile history fast. Instead of digging through dashboards, use
search_transactionsorget_transactionto find any payment record by date range or code. - Manage returns reliably. Use
cancel_transactionto issue refunds—you can specify if you need the refund to be partial or full.
Real-World Use Cases
A customer needs a quick payment link after checkout.
The customer asks their agent, 'I need a payment option for 3 items.' The agent recognizes this requires card installments and calls create_checkout_link. This generates a single URL the customer can use immediately.
Checking if there's enough money before fulfilling an order.
Before confirming fulfillment, the team lead asks their agent to confirm funds. The agent calls get_balance, providing real-time confirmation of available cash before proceeding with shipping.
Troubleshooting a payment that failed yesterday.
The user needs to verify an old sale. They ask the agent, 'Show me transactions from last Tuesday.' The agent calls search_transactions using the date range, finding the specific record needed.
Issuing a partial refund for damaged goods.
A customer reports damage and needs a partial credit. The agent uses get_order to confirm the original sale details, then calls cancel_transaction, specifying only the reduced amount.
The Tradeoffs
Trying to manage payments via manual API polling.
Writing a script that constantly polls the payment gateway's status endpoint every 5 seconds until it gets a 'SUCCESS' code. This is inefficient, rate-limited, and complex to maintain.
→
Instead, use get_transaction or search_transactions. These tools let you target specific records by ID or date range, keeping your agent calls focused and minimizing unnecessary API hits.
Assuming all payment methods are covered by one link.
Using only create_checkout_link when the customer specifically requests a Pix QR code. This fails because the checkout link doesn't generate instant, scannable Pix data.
→
If you know the method, use the dedicated tool. To make Pix payments, call create_pix_payment. If they prefer Boleto, call create_boleto_payment.
Forgetting to validate payment options first.
Attempting to generate a checkout link for an expensive item without first checking installment plans. This results in the customer being presented with invalid or incomplete payment choices.
→
Always check get_installment_options before building a high-value create_checkout_link. That validates what card brands can actually offer.
When It Fits, When It Doesn't
Use this server if you need to automate the entire Brazilian payment lifecycle within an AI conversation. This covers generating multiple payment formats (Pix, Boleto, Card) and managing the money trail (Balance, Search, Refund). Don't use it if your only goal is to read data; for pure reporting, a specialized database connector might be cleaner.
Crucially: If you need to initiate an action (create payment, refund, check balance), this is the tool. If you are just verifying schema or structuring text output, you don't need it. Remember, get_order gives you the initial context, but you must follow up with a dedicated tool like create_pix_payment to actually move the money.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by PagBank. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 9 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
The manual process of managing Brazilian payments is a mess of dashboards and clicks.
Today, if you need to settle an order, your team spends time jumping between the payment portal dashboard, manually copying transaction codes from PDF receipts, and then refreshing multiple tabs just to confirm funds. It's slow, tedious, and prone to copy/paste errors.
With PagBank PagSeguro MCP Server, that whole workflow collapses into a single chat command. You tell your agent what you need—say, 'Refund transaction 12345.' The agent calls `cancel_transaction`, handles the API call, and gives you an immediate, confirmed status update.
PagBank PagSeguro MCP Server: Payment & Transaction Tools
You stop needing to manually create unique payment methods for every customer. Instead of generating a Pix code or Boleto link in a separate system, you tell your agent the details, and it calls `create_pix_payment` or `create_boleto_payment`. The necessary codes are generated instantly.
This means payments flow from conversation to confirmation without friction points. It's direct, reliable, and keeps the entire payment lifecycle—from request to refund—inside your agent.
Common Questions About PagBank PagSeguro MCP
How do I find out if my account has enough money using PagBank PagSeguro MCP Server? +
Call get_balance. This tool retrieves the current available funds from your connected PagBank account, giving you an immediate financial snapshot.
What is the difference between `get_transaction` and `search_transactions`? +
get_transaction requires a specific code to pull one record. Use search_transactions when you only know a date range, allowing you to filter through multiple records at once.
Can I use the PagBank PagSeguro MCP Server for partial refunds? +
Yes, call cancel_transaction. This tool allows you to specify both full or partial refund amounts on an existing payment record.
What should I do if a customer wants to pay using a credit card with installments? +
Use create_checkout_link to generate the link. This tool handles the complexity of multiple items and installment options, simplifying the payment for the user.
What kind of access token is required when using the `get_balance` tool? +
You must provide a valid PagBank Access Token. Use your Sandbox credentials for testing and switch to Production tokens before live use. The agent confirms connectivity by checking token scope against account read permissions.
If I only have an Order ID, how does the `get_order` tool retrieve all necessary details? +
The get_order tool uses the unique order identifier to pull comprehensive data. It returns payment status, associated transaction codes, and item lists in a single payload.
When generating an instant payment using `create_pix_payment`, can I update the amount or reference number after calling the tool? +
No. The parameters—amount, currency, and reference code—must be provided to create_pix_payment at the time of execution. Changes require a new invocation with updated values.
If I use the `get_transaction` tool and find an error status, what does that mean for the payment lifecycle? +
The agent receives the specific PagBank failure code from get_transaction. This indicates why the transaction failed (e.g., insufficient funds or expired details), allowing you to troubleshoot immediately.
How do I get a PagBank Access Token? +
Log in to your PagBank Account. Go to Account > Credentials (or Developer section) and generate your Production Token. Copy the token and paste it below.
Can I generate Pix payments? +
Yes! Use the create_pix_payment action. It returns the QR Code data (Base64 and copy-paste text) that you can display for the user to pay instantly.
Does it support Boleto? +
Yes! Use the create_boleto_payment action. You need to provide the payer's Name and CPF to generate the Boleto link and barcode.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
TikTok Ads
Equip your AI agent with direct access to TikTok Ads — manage campaigns, track ad performance, and optimize spend without opening TikTok Ads Manager.
Swan
Empowers algorithmic control over European Bank Accounts. Execute SEPA transfers and manage Virtual Corporate Cards programmatically.
Apple Search Ads
Manage and optimize your Apple Search Ads campaigns — track performance, keywords, and search terms via AI.
You might also like
Carta
Equip your AI agent with direct access to Carta — query cap tables, review equity grants, and monitor 409A valuations without opening the equity management dashboard.
Bleez
Power your Brazilian e-commerce with a platform that integrates payments, inventory, and logistics for the local market.
Caiyun Weather / 彩云天气
China's leading high-precision weather service — get minute-level precipitation and air quality via AI.