mcpField
M
mcp-conekta

mcp-conekta

Local
github.com/codesparFinance275Updated 4w ago
Repository

About mcp-conekta

mcp-conekta is an MCP server for Conekta, a Mexican payment gateway supporting cards, OXXO cash payments and SPEI bank transfers. It suits developers who want agents to manage orders, customers and payments.

Key features

  1. 01Order creation, lookup, update and cancellation
  2. 02Customer and payment source management
  3. 03Charge creation and pre-authorized capture
  4. 04Refund processing
  5. 05Webhook event retrieval and endpoint management

Use cases

  1. 01Letting an agent create orders and charges for Mexican customers
  2. 02Checking order and charge status and issuing refunds
  3. 03Tracking payment status changes through webhook events

MCP support

This project is an MCP server that exposes 21 tools to MCP clients for calling the Conekta API to handle orders, customers, charges and webhooks.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "codespar-mcp-conekta": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-conekta"
      ],
      "env": {
        "CONEKTA_API_KEY": "<CONEKTA_API_KEY>"
      }
    }
  }
}
Run commandnpx -y @codespar/mcp-conekta
Environment variables to set
CONEKTA_API_KEYSecretAPI key for Conekta

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@codespar/mcp-conekta0.2.2

Tools

21

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
chargesarrayNoCharges for the order
currencystringYesCurrency code (e.g. MXN)
line_itemsarrayYesOrder line items
customer_infoobjectYesCustomer information
customer_info.namestringYesCustomer name
customer_info.emailstringYesCustomer email
customer_info.phonestringYesCustomer phone

Details

From the project 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

# Set your API key
export CONEKTA_API_KEY="key_..."

# Run via stdio
npx -y @codespar/mcp-conekta

# Run via HTTP
MCP_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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.