Conekta MCP Server
OfficialExposes Conekta's core payment operations as tools, enabling management of customers, orders, charges, refunds, subscriptions, and checkouts via the Conekta payment API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Conekta MCP Server show my current account balance"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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_mcpBy 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/mcpUse 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_xxxConfiguration (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_xxxwith your real Conekta private API key.The header must be exactly
Authorization.The value must include the
Bearerprefix.
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 |
|
Customers |
|
Orders |
|
Charges |
|
Refunds |
|
Plans |
|
Subscriptions |
|
Checkouts |
|
Events |
|
Companies |
|
Docker
docker run --pull=always -i --rm \
-e CONEKTA_API_KEY=key_your_api_key \
ghcr.io/conekta/mcp-server:latestConfiguration (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/ -vAvailable Tools
32 toolscancel_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
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.
Maintenance
Related MCP Connectors
Read payment settings, orders and receipts, create payment links and API keys.
Create and manage checkout pages, event ticketing, forms, customers, payments and subscriptions.
Read Instamojo payment requests, payments and refunds; create payment links and refund payments.
Dodo Payments API: payments, subscriptions, customers, products, refunds, licenses, usage.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceEnables 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-
- FlicenseBqualityNot gradedmaintenanceEnables 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-
- AlicenseAqualityDmaintenanceConnects 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.534 npm3MIT
- FlicenseAqualityDmaintenanceEnables interaction with the Yugo Payments API to manage payins, payouts, and accounts through auto-generated MCP tools.8-