# Conekta MCP for AI Agents AI Agent Connect > Conekta MCP lets your AI agent handle Latin American payments, check transaction statuses, and pull sales data directly from the Conekta gateway. It bridges the gap between your e-commerce backend and your conversational tools so you can manage Mexican and LatAm transactions without switching tabs. ## Overview - **Category:** money-moves - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_xxg8ftRy7wneETCpQ8dhhfKrGCWQid3XQJJrRllB/ai-agent-connect - **Tags:** latam-payments, transaction-lookup, credit-card-processing, cash-payments, bank-transfers ## Description You are running an e-commerce business in Mexico or Latin America, and your payment data is currently trapped inside a dashboard you have to click through every time a customer asks a question. This Connector changes that by giving your AI agent a direct line to your Conekta account. Instead of hunting for a transaction ID or manually verifying a refund, you can just ask your agent to find the order, check if the payment cleared, or pull a list of recent chargebacks. It handles the heavy lifting of querying the gateway so you can focus on actually moving products. You can check if a specific customer's payment went through or summarize your daily revenue for a report directly in your chat. This means your support team can answer "where is my order?" in seconds. It means your finance team can get a summary of daily revenue without exporting CSVs. It means your sales team can create new orders directly from a conversation. You get a unified way to interact with your payment gateway without the friction of a traditional dashboard. You can find this and thousands of other specialized tools in the Vinkius catalog to build out your full business stack. ## Tools ### create_order Create a new order in Conekta with customer details and line items. This helps you move a customer from a chat to a confirmed sale in one step. ### get_customer Pull contact info, payment sources, and the full order history for a specific customer. You can use this to see a person's entire history without searching for individual IDs. ### get_order Get the charges, line items, and current payment status for a single order. This is useful for verifying if a specific payment was successful or declined. ### list_subscription_plans See all the active subscription plans currently offered in your Conekta account. This helps you keep your pricing tiers consistent across your platform. ### list_customers Get a complete list of all customer records stored in your Conekta account. Use this to audit your user base or find specific profiles quickly. ### list_events Retrieve webhook history to help you debug your payment integration. This lets you see what data your system is receiving without checking logs. ### list_orders Pull a paginated list of orders, which you can filter by payment status. It is the fastest way to see what sold today or find failed payments. ### search_customer_by_email Find a specific customer profile using their email address. Use this to quickly pull up a customer's details during a live support conversation. ## Prompt Examples **Prompt:** ``` Did the payment for order ord_9ak go through? ``` **Response:** ``` The payment for order ord_9ak was successful. Here are the details: * **Status:** Approved * **Amount:** $1,250.00 MXN * **Payment Method:** Credit Card * **Customer:** Carlos Mendoza * **Timestamp:** Today at 10:45 AM ``` **Prompt:** ``` Summarize our sales for today. ``` **Response:** ``` Here is the summary of today's transactions: * **Total Approved Transactions:** 24 * **Total Revenue:** $34,800.00 MXN * **Declined Transactions:** 2 * **Reason for Declines:** Insufficient funds ``` **Prompt:** ``` Find the customer with the email test@example.com. ``` **Response:** ``` I found the customer profile for test@example.com: * **Name:** Jane Doe * **Account Status:** Active * **Total Orders:** 5 * **Last Order Date:** October 12, 2023 ``` ## Capabilities ### Query payment statuses Instantly check if a specific transaction was successful or declined using an ID or email. ### Summarize daily revenue Get a breakdown of your total sales and successful transactions for any given day. ### Retrieve customer profiles Pull contact details and full payment histories for specific customers in your account. ### Create new orders Generate new orders with specific line items, quantities, and pricing from a chat. ### View webhook history Access your API event logs to debug payment integrations and webhook triggers. ### List subscription plans See all active subscription tiers and plans currently offered in your Conekta account. ## Use Cases ### Verifying a pending payment A customer claims they paid but the order is still pending. Use `get_order` to check the status and confirm if the funds cleared. ### Instant customer history lookup A support rep needs to see a customer's history. Use `get_customer` to pull the record instantly during a live chat. ### Daily sales summarization A manager wants a summary of today's performance. Use `list_orders` to find all successful sales from the last 24 hours. ### Webhook debugging An analyst needs to check for fraud or integration errors. Use `list_events` to see recent webhook activity and data. ## Benefits - Stop manually searching for transaction IDs. Use `get_order` to see payment status instantly. - Speed up support with `search_customer_by_email` to pull history without asking for more info. - Get a bird's-eye view of revenue using `list_orders` to see what's selling today. - Automate order creation with `create_order` to move from chat to checkout faster. - Simplify subscription management by pulling all plans with `list_subscription_plans`. - Debug your webhooks easily by pulling logs with `list_events` without opening the dev console. ## How It Works The bottom line is you get real-time access to your LatAm payment data through a simple chat interface. 1. Connect your Conekta Private API Key to your AI workspace. 2. Grant the agent permission to access your account data. 3. Ask your agent to pull transaction records or summarize sales. ## Frequently Asked Questions **Can Conekta MCP help with Mexican payments?** Yes, this Connector is specifically designed to connect your AI agent to the Conekta gateway, which is a leading payment processor for Mexico and Latin America. **Does Conekta MCP work with my existing online store?** It works with any store that uses Conekta as its payment gateway. Your agent will be able to pull and manage that data directly. **Can I use Conekta MCP to handle customer refunds?** Yes, your agent can check the status of specific orders and help you manage the refund process by pulling the correct transaction details. **Is it safe to connect my Conekta account to an AI agent?** Yes, the connection is secured using your Conekta Private API Key, ensuring that only your authorized agent can access your payment data. **Can Conekta MCP see my subscription plans?** Yes, it can retrieve a list of all active subscription plans in your account, making it easy to check your current pricing tiers. **Can I use Conekta MCP to create new orders?** Yes, your agent can create new orders by providing customer details and line items, allowing you to move from a chat to a confirmed sale quickly. **How do I securely obtain my Conekta Private API Key?** Log in to your Conekta dashboard as an administrator. In the left sidebar, click on 'Developers' (Desarrolladores), then navigate to 'API Keys' (Llaves API). Locate the 'Private Key' (Llave Privada) section—you may need to enter your password to reveal it. Copy this key and paste it into the secure input field below to connect the agent. **Can the AI agent create new charges or issue refunds directly?** No. This integration operates strictly in read-only mode to guarantee financial security. The conversational agent can query and extract data regarding transactions, customers, and overall payments, but it cannot authorize new charges or initiate refunds, protecting your account from unintended financial actions. **What kind of data can I ask the agent to retrieve from Conekta?** You can ask the agent to check the exact status of a specific payment ID, verify whether a charge was approved or declined, list recent successful orders, or summarize the daily transaction volume and associated processing fees.