Mcp Conekta

io.github.codesparPublished by GitHub account codesparv0.2.2Updated Oct 24, 2026

Conekta — Mexican payment gateway (cards, OXXO cash, SPEI)

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Local MCP server that lets an assistant manage Conekta payments: orders, charges, refunds, customers, payment sources and webhooks.

What you can do
  • Create, read, list, update and cancel orders, including line items and metadata
  • Create charges on orders, capture pre-authorized charges and refund charges
  • Create, read, list, update and delete customers
  • List, create and delete customer payment sources such as card tokens
  • List and retrieve webhook events, and create, update or delete webhook endpoints
When to use it
Useful when an assistant should work with a Mexican payment gateway: drafting or inspecting orders, handling customers and saved payment sources, issuing refunds, or managing webhook endpoints for a Conekta account.
Requirements
Runs as a local process via npx from the npm package @codespar/mcp-conekta. Requires a Conekta API key supplied in the CONEKTA_API_KEY environment variable, obtained from the Conekta dashboard. Optional MCP_HTTP and MCP_PORT variables enable an HTTP transport instead of stdio. Network access to the Conekta API is needed.
Before you install
The API key in CONEKTA_API_KEY grants access to a live payment account; keep it out of logs and shared configs. Tools can move real money and change data: charges, captures, refunds, order cancellation, customer and payment source deletion, and webhook creation or deletion. Prefer a test-mode key until behavior is verified.

Installation

In SourceWeft

  1. Open Mcp Conekta in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@codespar/mcp-conekta

MCP server for Conekta, the leading Mexican payment gateway supporting cards, OXXO cash payments, and SPEI bank transfers

[npm] [License: MIT]

Quick Start

bash
# Set your API keyexport CONEKTA_API_KEY="key_..."
# Run via stdionpx -y @codespar/mcp-conekta
# Run via HTTPMCP_HTTP=true MCP_PORT=3000 npx -y @codespar/mcp-conekta

Environment Variables

VariableRequiredDescription
CONEKTA_API_KEYYesAPI key from Conekta dashboard
MCP_HTTPNoSet to "true" to enable HTTP transport
MCP_PORTNoHTTP port (default: 3000)

Tools (21)

ToolPurpose
create_orderCreate a new order
get_orderGet order details by ID
list_ordersList orders with filters
create_customerCreate a customer
get_customerGet customer by ID
list_customersList customers
create_chargeCreate a charge for an existing order
refund_chargeRefund a charge
list_payment_sourcesList payment sources for a customer
get_webhook_eventsList webhook events (Conekta Events)
get_webhook_eventRetrieve a single webhook event by ID
update_customerUpdate a customer
delete_customerDelete a customer
create_payment_sourceCreate a payment source (card token) for a customer
delete_payment_sourceDelete a payment source from a customer
update_orderUpdate an order (line_items, metadata, etc.)
cancel_orderCancel an order
capture_chargeCapture a pre-authorized order (pre_authorized → paid)
create_webhookCreate a webhook endpoint
update_webhookUpdate a webhook endpoint
delete_webhookDelete a webhook endpoint

Auth

Uses Basic authentication with API key as username and empty password. API version v2.2.0 is set via the Accept header. Obtain your API key from the Conekta Dashboard.

API Reference

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

Authentication

Set these environment variables before launching the server:

  • CONEKTA_API_KEY (required, secret) — API key for Conekta

Issue credentials at the provider's developer portal: https://developers.conekta.com.

License

MIT

Source: packages/mexico/conekta/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts