Exposes Conekta's core payment operations as tools, enabling management of customers, orders, charges, refunds, subscriptions, and checkouts via the Conekta payment API.
Click on "Install 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 Servershow 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.
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/ -vResources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.