mcp-conekta — Claude Code MCP server: what it does, how to install
Connects your coding agent to the Conekta payment gateway. Useful for managing Mexican card charges, OXXO cash vouchers, and SPEI bank transfers directly from prompts.
claude mcp add mcp-conekta -e CONEKTA_API_KEY=<CONEKTA_API_KEY> -- npx -y @codespar/mcp-conektaWhat mcp-conekta does
The server bridges your assistant with Conekta API v2.2.0. It provides 21 tools covering the full billing lifecycle, including customer records, payment cards, order creation, refunds, and webhook administration.
Transport runs via standard I/O by default, though an HTTP mode is available when passing MCP_HTTP=true on port 3000. Authentication relies on HTTP Basic Auth using your private token as the username with a blank password. Without a valid CONEKTA_API_KEY set in the environment, all payment operations fail immediately.
What it helps with
- create customer profiles and attach saved payment tokens
- generate orders for OXXO cash payments or SPEI transfers
- capture pre-authorized authorizations or issue refunds
- register and inspect endpoints for webhook events
Example prompts for the agent
- Create a Conekta order for 350 MXN paid via SPEI transfer for customer
cust_abc - Check the latest webhook events to verify charge status on order
ord_xyz - Refund the charge
ch_102030and mark the order as canceled
How to install mcp-conekta
Platform CLI
claude mcp add mcp-conekta -e CONEKTA_API_KEY=<CONEKTA_API_KEY> -- npx -y @codespar/mcp-conektaReplace <…> with your own values
Platform CLI
codex mcp add conekta --env CONEKTA_API_KEY=<CONEKTA_API_KEY> -- npx -y @codespar/mcp-conektaReplace <…> with your own values
Config file
{
"mcpServers": {
"conekta": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-conekta"
],
"env": {
"CONEKTA_API_KEY": "<CONEKTA_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"conekta": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-conekta"
],
"env": {
"CONEKTA_API_KEY": "<CONEKTA_API_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e CONEKTA_API_KEY=<CONEKTA_API_KEY> conekta npx -y @codespar/mcp-conektaReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-conekta
How to install mcp-conekta in Claude Code?
Run this command in your console: claude mcp add mcp-conekta -e CONEKTA_API_KEY=<CONEKTA_API_KEY> -- npx -y @codespar/mcp-conekta. Replace <CONEKTA_API_KEY> with your secret key from the Conekta panel.
What does mcp-conekta do?
It exposes 21 endpoints to interact with the Mexican billing service Conekta. The agent can look up charges, handle customer profiles, process card payments, and handle disputes or cancellations.
Does mcp-conekta support network transports other than stdio?
Yes, setting MCP_HTTP=true switches the server to HTTP mode. It listens on port 3000 unless you specify an alternative using MCP_PORT.
