# Conekta MCP for AI Agents MCP

> Conekta gives your AI agent secure access to Latin American payment processing. Use this MCP to instantly check transaction statuses, build new e-commerce orders, and summarize sales data across Mexico and LATAM. It lets you manage everything from customer profiles to complex financial reporting directly through natural conversation.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Tags:** latam-payments, transaction-lookup, credit-card-processing, cash-payments, bank-transfers

## Description

This Conekta MCP connects your AI agent to the leading online payment gateway for Latin America. Forget jumping between multiple dashboards just to check a sale or find a customer's history. Your agent reads the data, so you don't have to click anything.

You can ask it to look up any specific transaction using an ID or an email address. It summarizes recent sales totals and tracks if payments are cleared or declined. Need to know who placed the order? The MCP pulls customer profiles and their entire payment history into one place for you. This functionality, hosted on Vinkius, means your AI client handles all this complex financial data retrieval without needing manual input.

It’s built for speed. When you need immediate answers about revenue totals or if a refund request went through, the agent gives it to you instantly.

## Tools

### create_order
Creates a new sale record in Conekta using customer details and line items, defaulting to MXN currency.

### get_customer
Retrieves detailed information about a specific user, including their contact info and past orders.

### get_order
Pulls comprehensive details for a single order, including all charges, line items, and payment status.

### list_customers
Gathers a list of customer records stored in Conekta's system.

### list_events
Retrieves an audit log of API events, useful for debugging payment integration issues.

### list_orders
Gets a paginated list of sales records from Conekta; you can filter results by payment status.

### list_subscription_plans
Fetches all available subscription plans managed within Conekta.

### search_customer_by_email
Finds and returns a customer's profile using only their email address.

## Prompt Examples

**Prompt:** 
```
Hey, check if the payment for order 'ord_9ak' went through. I need to know the final status.
```

**Response:** 
```
**Transaction Status Check**

The transaction `ord_9ak` was successfully processed.
*   **Amount:** $800.00 MXN
*   **Method:** Credit Card
*   **Status:** Cleared (Approved)
*   **Date/Time:** Today at 10:45 AM
The associated customer is 'Carlos Mendoza'.
```

**Prompt:** 
```
What was the total revenue from all successful sales today?
```

**Response:** 
```
**Today's Revenue Summary**

You processed 24 successfully approved transactions. The total processed revenue is **$34,800.00 MXN**. 

We also saw 2 attempts flagged as 'declined' due to insufficient funds. Do you want a detailed breakdown of the processing fees for those two?
```

**Prompt:** 
```
I need to create an order for John Smith, email john@test.com. Line items are one unit of Widget A at $50 and two units of Gadget B at $10 each.
```

**Response:** 
```
**Order Confirmation**

✅ New Order Created!
*   **Customer:** John Smith (john@test.com)
*   **Total Charge:** $70 MXN
*   **Status:** Pending Payment
The order ID is `ord_xxxxxx`. A payment attempt has been initiated.
```

## Capabilities

### Look up specific transactions
Check the status of any payment by providing a transaction ID or customer email.

### Analyze sales performance and revenue
Get summaries of daily totals, including successful payments, refunds, or chargebacks.

### Manage customer details
Retrieve complete profiles for specific customers, showing contact info and their full payment history.

### Create new sales records
Generate a brand new order using required details like the customer's name, email, phone number, and line items.

### View historical sales lists
Pull comprehensive, paginated lists of past orders or retrieve all records for a specific customer across time.

## Use Cases

### A customer asks if a disputed charge was processed.
The agent uses `get_order` to retrieve the specific order details, checking the current status and providing confirmation on whether it was paid or flagged for dispute.

### Need a report of all sales from last week.
Instead of filtering by date in multiple reports, the agent runs `list_orders` and applies filters to give you an immediate summary of total revenue and transaction counts.

### A new user needs to make a purchase right now.
The agent uses `create_order`, prompting only for necessary information, generating the sale record, and completing the payment process instantly.

### I need to find out everything about customer Jane Doe's account.
You ask the agent to run a search by email or use `get_customer` to pull all associated contact info, past orders, and payment methods in one consolidated summary.

## Benefits

- Need to know if a payment went through? You can instantly check status using the `get_order` tool or by searching with `search_customer_by_email`, giving you immediate answers without dashboard logins.
- Stop manual reporting. By grouping sales data, your agent pulls summaries of daily revenue and total successful transactions using `list_orders`, perfect for quick financial checks.
- When a customer calls about an old purchase, the MCP gives support agents full context by running `get_customer` to pull their entire payment history in one go.
- Creating new sales? Use the `create_order` tool to generate and process payments immediately from within your conversation, making checkout flows faster than ever.
- Track down problems fast. Instead of digging through logs, you can use `list_events` to pull an API event history for debugging payment failures.

## How It Works

The bottom line is, you tell your agent what you need in plain language, and it handles the complicated payment API calls behind the scenes.

1. Start by adding the Conekta integration to your AI workspace and securing the connection using your private API key.
2. Your agent uses this secure connection to communicate with Conekta's payment system, requesting specific data like transaction IDs or customer emails.
3. The MCP receives raw financial data—such as status codes, line item charges, and customer details—and relays a clean, summarized answer back to your AI client.

## Frequently Asked Questions

**How does the Conekta MCP help me with Latin American payments?**
The Conekta MCP gives your AI agent direct, conversational access to all of your e-commerce payment data in Mexico and LATAM. You can check transaction statuses or list sales totals without logging into any dashboard.

**Can I use the Conekta MCP to create new orders?**
Yes. The MCP includes a tool that lets you generate brand-new sale records, taking customer and product details from your chat conversation and submitting the order for payment immediately.

**What if I need to check a customer's full purchase history?**
You can ask the agent to retrieve detailed information about any specific user. It compiles their entire profile, including all associated orders and past payments, into one easy-to-read summary.

**Is Conekta MCP useful for financial reporting?**
Absolutely. You can ask the agent to summarize daily revenue or pull lists of chargebacks. It gathers aggregate data from your sales records so you don't have to export and compile spreadsheets.

**Does Conekta MCP only work with credit cards?**
No, it handles various payment types used in the region. You can analyze transactions regardless of whether they were processed via card, bank transfer, or other methods supported by Conekta.