Conekta MCP Server

Get the current account balance.

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 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 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 a payment link (checkout) by ID.

Args: checkout_id: The Conekta checkout ID

Cancel a payment link (checkout).

Args: checkout_id: The Conekta checkout ID to cancel

Send a payment link via email.

Args: checkout_id: The Conekta checkout ID email: Recipient email address

Send a payment link via SMS.

Args: checkout_id: The Conekta checkout ID phone: Recipient phone number in E.164 format

Get the current company information associated with the API key.

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 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 a customer by ID.

Args: customer_id: The Conekta customer ID (e.g., cus_2tXyF9BwPG14UMkAA)

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 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 an event by ID.

Args: event_id: The Conekta event ID

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 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 order details by ID.

Args: order_id: The Conekta order ID

Update an existing order.

Args: order_id: The Conekta order ID metadata: Metadata object to update: {"key":"value"}

Cancel an order.

Args: order_id: The Conekta order ID to cancel

Capture a pre-authorized order payment.

Args: order_id: The Conekta order ID to capture

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 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 a subscription plan by ID.

Args: plan_id: The Conekta plan ID

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 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 subscription details.

Args: customer_id: The Conekta customer ID subscription_id: The subscription ID

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 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 a subscription.

Args: customer_id: The Conekta customer ID subscription_id: The subscription ID to cancel

Pause a subscription.

Args: customer_id: The Conekta customer ID subscription_id: The subscription ID to pause

Resume a paused subscription.

Args: customer_id: The Conekta customer ID subscription_id: The subscription ID to resume