Conekta MCP Server
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CONEKTA_API_KEY | Yes | Your Conekta private API key used to authenticate with the Conekta API. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_balanceB | Get the current account balance. |
| list_chargesB | List all charges with optional search and pagination. Args: limit: Max charges to return (1-250, default 20) search: Search filter next_page: Cursor for next page previous_page: Cursor for previous page |
| create_checkoutA | Create a payment link (checkout). Args: name: Checkout name for identification recurrent: false for single use, true for multiple payments expires_at: Expiration Unix timestamp (10 minutes to 365 days from now) allowed_payment_methods: Comma-separated payment methods (e.g., "card,cash,bank_transfer") order_template_currency: ISO currency code (e.g., MXN) item_name: Product name for the line item item_unit_price: Price per unit in cents (e.g., 50000 for $500.00 MXN) item_quantity: Number of units (default 1) needs_shipping_contact: Whether shipping contact info is required (default false) customer_info_customer_id: Existing Conekta customer ID (e.g., cus_2tXyF9BwPG14UMkAA) customer_info_name: Customer name (if not using existing customer) customer_info_email: Customer email (if not using existing customer) customer_info_phone: Customer phone E.164 (if not using existing customer) line_items_json: JSON array for multiple items, overrides item_name/unit_price/quantity: [{"name":"Item","unit_price":1000,"quantity":1}] monthly_installments_enabled: Enable monthly installments monthly_installments_options: Installment options (e.g., [3,6,9,12]) success_url: Redirect URL after successful payment failure_url: Redirect URL after failed payment |
| list_checkoutsB | List payment links (checkouts) with optional search and pagination. Args: limit: Max checkouts to return (1-250, default 20) search: Search filter next_page: Cursor for next page previous_page: Cursor for previous page |
| get_checkoutA | Get a payment link (checkout) by ID. Args: checkout_id: The Conekta checkout ID |
| cancel_checkoutC | Cancel a payment link (checkout). Args: checkout_id: The Conekta checkout ID to cancel |
| send_checkout_emailC | Send a payment link via email. Args: checkout_id: The Conekta checkout ID email: Recipient email address |
| send_checkout_smsB | Send a payment link via SMS. Args: checkout_id: The Conekta checkout ID phone: Recipient phone number in E.164 format |
| get_current_companyB | Get the current company information associated with the API key. |
| create_customerB | Create a new customer. Args: name: Customer full name email: Customer email address phone: Customer phone in E.164 format (e.g., +5215555555555) custom_reference: Optional custom reference for your system |
| list_customersA | List customers with optional search and pagination. Args: limit: Max number of customers to return (1-250, default 20) search: Search by name, email, phone, or custom reference next_page: Cursor for next page (from previous response) previous_page: Cursor for previous page (from previous response) |
| get_customerB | Get a customer by ID. Args: customer_id: The Conekta customer ID (e.g., cus_2tXyF9BwPG14UMkAA) |
| update_customerB | Update an existing customer. Only provided fields are updated. Args: customer_id: The Conekta customer ID name: New customer name email: New customer email phone: New customer phone custom_reference: New custom reference |
| list_eventsA | List system events with pagination. Args: limit: Max events to return (1-250, default 20) next_page: Cursor for next page previous_page: Cursor for previous page |
| get_eventB | Get an event by ID. Args: event_id: The Conekta event ID |
| create_orderA | Create a new order. Provide customer_info_customer_id for an existing customer, or name/email/phone for a new one. Args: currency: ISO currency code (e.g., MXN, USD) customer_info_customer_id: Existing Conekta customer ID customer_info_name: Customer name (if not using existing customer) customer_info_email: Customer email (if not using existing customer) customer_info_phone: Customer phone E.164 (if not using existing customer) checkout: Checkout object. Supported types: Integration: {"type":"Integration","allowed_payment_methods":["card"],"name":"Pago"} HostedPayment: {"type":"HostedPayment","allowed_payment_methods":["card"],"name":"Pago","success_url":"https://...","failure_url":"https://..."} line_items: Order line items: [{"name":"Item","unit_price":1000,"quantity":1}] charges: Order charges: [{"payment_method":{"type":"card","token_id":"tok_..."}}] shipping_contact: Shipping address: {"address":{"street1":"Nuevo Leon 254","postal_code":"06100","city":"Ciudad de Mexico","state":"Ciudad de Mexico","country":"MX"}} shipping_lines: Order shipping lines: [{"amount":500,"carrier":"FedEx"}] metadata: Metadata object: {"key":"value"} |
| list_ordersB | List orders with optional filters and pagination. Args: limit: Max orders to return (1-250, default 20) search: Search by email, reference, etc. payment_status: Filter by status (paid, pending, refunded, etc.) next_page: Cursor for next page previous_page: Cursor for previous page |
| get_orderB | Get order details by ID. Args: order_id: The Conekta order ID |
| update_orderC | Update an existing order. Args: order_id: The Conekta order ID metadata: Metadata object to update: {"key":"value"} |
| cancel_orderB | Cancel an order. Args: order_id: The Conekta order ID to cancel |
| capture_orderB | Capture a pre-authorized order payment. Args: order_id: The Conekta order ID to capture |
| create_planB | Create a subscription plan. Args: name: Plan name amount: Plan price in cents currency: ISO currency code (e.g., MXN, USD) interval: Billing interval (day, week, half_month, month, year) frequency: How often the interval repeats (default 1) trial_period_days: Number of trial days before first charge expiry_count: Number of billing cycles before plan expires |
| list_plansA | List subscription plans with optional search and pagination. Args: limit: Max plans to return (1-250, default 20) search: Search by plan name next_page: Cursor for next page previous_page: Cursor for previous page |
| get_planB | Get a subscription plan by ID. Args: plan_id: The Conekta plan ID |
| create_refundC | Create a refund for an order. Args: order_id: The Conekta order ID to refund amount: Refund amount in cents reason: Reason for the refund |
| list_subscriptionsB | List subscriptions for a customer. Args: customer_id: The Conekta customer ID limit: Max subscriptions to return (1-250, default 20) next_page: Cursor for next page previous_page: Cursor for previous page |
| get_subscriptionC | Get subscription details. Args: customer_id: The Conekta customer ID subscription_id: The subscription ID |
| create_subscriptionC | Create a subscription for a customer. Args: customer_id: The Conekta customer ID plan_id: The plan ID to subscribe to card_id: Payment source ID (uses default if not provided) |
| update_subscriptionC | Update a subscription. Args: customer_id: The Conekta customer ID subscription_id: The subscription ID plan_id: New plan ID card_id: New payment source ID |
| cancel_subscriptionC | Cancel a subscription. Args: customer_id: The Conekta customer ID subscription_id: The subscription ID to cancel |
| pause_subscriptionC | Pause a subscription. Args: customer_id: The Conekta customer ID subscription_id: The subscription ID to pause |
| resume_subscriptionC | Resume a paused subscription. Args: customer_id: The Conekta customer ID subscription_id: The subscription ID to resume |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 32 tools
Every tool has a clearly distinct purpose targeting specific resources and actions in the Conekta payment processing domain. For example, cancel_checkout, cancel_order, and cancel_subscription each handle different resource types, while create_checkout and create_order serve distinct payment flow purposes. There is no overlap or ambiguity between tools.
Tool names follow a perfectly consistent verb_noun pattern throughout the entire set. All 32 tools use this convention (e.g., create_customer, get_balance, list_orders, update_subscription) with no deviations in style or structure. The naming is predictable and easily parsable.
With 32 tools, this server feels overly heavy for a payment processing API. While the domain is complex, many tools could potentially be consolidated (e.g., send_checkout_email and send_checkout_sms could be a single tool with a channel parameter). The count exceeds the typical well-scoped range of 3-15 tools and may overwhelm agents.
The tool surface provides comprehensive CRUD/lifecycle coverage for all major Conekta entities: customers, orders, checkouts, subscriptions, plans, charges, and events. Every resource has create, get, list, and update/delete/cancel operations where applicable, plus specialized actions like capture, refund, pause/resume, and notification sending. There are no obvious gaps.