Skip to main content
Glama
Conekta MCP Server

Conekta MCP Server

Official
by conekta

Conekta MCP Server

MCP server for the Conekta payment API. Exposes Conekta's core payment operations as tools for the Model Context Protocol.

Setup

# Install dependencies
uv sync

# Set your Conekta API key
export CONEKTA_API_KEY=key_your_api_key

# Run the server
uv run python -m conekta_mcp

By default the server uses the stdio transport for local MCP clients such as Claude Desktop.

Related MCP server: Vaultix MCP Server

Hosted MCP

The server is available remotely over Streamable HTTP at:

https://mcp.conekta.com/mcp

Use this endpoint if you want to connect to the hosted Conekta MCP server. Send your Conekta API key in the request header:

Authorization: Bearer key_xxx

Configuration (Hosted / Streamable HTTP)

If your MCP client supports remote servers over HTTP, the JSON config should include the hosted URL and the Authorization header.

Example:

{
  "mcpServers": {
    "conekta": {
      "url": "https://mcp.conekta.com/mcp",
      "headers": {
        "Authorization": "Bearer key_xxx"
      }
    }
  }
}

Notes:

  • Replace key_xxx with your real Conekta private API key.

  • The header must be exactly Authorization.

  • The value must include the Bearer prefix.

Claude Code (CLI)

claude mcp add --transport http conekta https://mcp.conekta.com/mcp \
  --header "Authorization: Bearer key_xxx"

Replace key_xxx with your real Conekta private API key.

Configuration (Claude Desktop / stdio)

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "conekta": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/mcp", "run", "python", "-m", "conekta_mcp"],
      "env": {
        "CONEKTA_API_KEY": "key_your_api_key"
      }
    }
  }
}

Available Tools

Resource

Tools

Balance

get_balance

Customers

create_customer, list_customers, get_customer, update_customer

Orders

create_order, list_orders, get_order, update_order, cancel_order, capture_order

Charges

list_charges

Refunds

create_refund

Plans

create_plan, list_plans, get_plan

Subscriptions

list_subscriptions, get_subscription, create_subscription, update_subscription, cancel_subscription, pause_subscription, resume_subscription

Checkouts

create_checkout, list_checkouts, get_checkout, cancel_checkout, send_checkout_email, send_checkout_sms

Events

list_events, get_event

Companies

get_current_company

Docker

docker run --pull=always -i --rm \
  -e CONEKTA_API_KEY=key_your_api_key \
  ghcr.io/conekta/mcp-server:latest

Configuration (Claude Desktop with Docker / stdio)

{
  "mcpServers": {
    "conekta": {
      "command": "docker",
      "args": ["run", "--pull=always", "-i", "--rm", "-e", "CONEKTA_API_KEY", "ghcr.io/conekta/mcp-server:latest"],
      "env": {
        "CONEKTA_API_KEY": "key_your_api_key"
      }
    }
  }
}

Development

# Install with dev dependencies
uv sync --extra dev

# Run tests
uv run pytest tests/ -v

Available Tools

32 tools
cancel_checkoutC

Cancel a payment link (checkout).

Args: checkout_id: The Conekta checkout ID to cancel

Inputs: checkout_id (required). Returns: result

cancel_orderB

Cancel an order.

Args: order_id: The Conekta order ID to cancel

Inputs: order_id (required). Returns: result

cancel_subscriptionC

Cancel a subscription.

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

Inputs: customer_id (required), subscription_id (required). Returns: result

capture_orderB

Capture a pre-authorized order payment.

Args: order_id: The Conekta order ID to capture

Inputs: order_id (required). Returns: result

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

Inputs: name (required), recurrent (required), expires_at (required), allowed_payment_methods (required), +14 more. Returns: result

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

Inputs: name (required), email (required), phone (required), custom_reference. Returns: result

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"}

Inputs: currency (required), customer_info_customer_id, customer_info_name, customer_info_email, +7 more. Returns: result

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

Inputs: name (required), amount (required), currency (required), interval (required), +3 more. Returns: result

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

Inputs: order_id (required), amount (required), reason (required). Returns: result

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)

Inputs: customer_id (required), plan_id (required), card_id. Returns: result

get_balanceB

Get the current account balance.

Inputs: no named parameters. Returns: result

get_checkoutA

Get a payment link (checkout) by ID.

Args: checkout_id: The Conekta checkout ID

Inputs: checkout_id (required). Returns: result

get_current_companyB

Get the current company information associated with the API key.

Inputs: no named parameters. Returns: result

get_customerB

Get a customer by ID.

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

Inputs: customer_id (required). Returns: result

get_eventB

Get an event by ID.

Args: event_id: The Conekta event ID

Inputs: event_id (required). Returns: result

get_orderB

Get order details by ID.

Args: order_id: The Conekta order ID

Inputs: order_id (required). Returns: result

get_planB

Get a subscription plan by ID.

Args: plan_id: The Conekta plan ID

Inputs: plan_id (required). Returns: result

get_subscriptionC

Get subscription details.

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

Inputs: customer_id (required), subscription_id (required). Returns: result

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

Inputs: limit, search, next_page, previous_page. Returns: result

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

Inputs: limit, search, next_page, previous_page. Returns: result

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)

Inputs: limit, search, next_page, previous_page. Returns: result

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

Inputs: limit, next_page, previous_page. Returns: result

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

Inputs: limit, search, payment_status, next_page, +1 more. Returns: result

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

Inputs: limit, search, next_page, previous_page. Returns: result

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

Inputs: customer_id (required), limit, next_page, previous_page. Returns: result

pause_subscriptionC

Pause a subscription.

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

Inputs: customer_id (required), subscription_id (required). Returns: result

resume_subscriptionC

Resume a paused subscription.

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

Inputs: customer_id (required), subscription_id (required). Returns: result

send_checkout_emailC

Send a payment link via email.

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

Inputs: checkout_id (required), email (required). Returns: result

send_checkout_smsB

Send a payment link via SMS.

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

Inputs: checkout_id (required), phone (required). Returns: result

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

Inputs: customer_id (required), name, email, phone, +1 more. Returns: result

update_orderC

Update an existing order.

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

Inputs: order_id (required), metadata. Returns: result

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

Inputs: customer_id (required), subscription_id (required), plan_id, card_id. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 32 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness5/5

    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.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables AI agents to interact with multiple payment providers (Stripe, Paystack) through a unified API. Supports payment initialization, verification, refunds, customer management, and invoicing without requiring knowledge of specific provider implementations.
      2
      -
    • F
      license
      B
      quality
      Not graded
      maintenance
      Enables Claude to interact with the Vaultix Payment API for managing charges, customers, refunds, payment links, payouts, and balance transactions. Supports Brazilian payment methods including PIX, card, and boleto payments.
      32
      -
    • A
      license
      A
      quality
      D
      maintenance
      Connects AI agents to Mercado Pago, the leading payment platform in Latin America. Create payment links, search payments, get payment details, issue refunds, and retrieve merchant info.
      5
      34 npm
      3
      MIT