How to Use the Conekta MCP in Claude

Q: How do I configure Conekta webhook tracking inside Claude Desktop?

Open your claudedesktopconfig.json file and add the server configuration under the mcpServers block to register the MCP Server. Once you restart the app, your agent can call listevents to show you live webhook logs.

Q: Can Claude Desktop create new MXN transactions via Conekta?

Yes, the agent calls createorder with the customer's details and item prices in cents. This generates a fresh order in your Mexican payment gateway instantly.

Q: Is it possible to search for a customer by email using Conekta in Claude Desktop?

You can ask your agent to find someone, and it will run searchcustomerbyemail to locate them. It returns their payment history and active subscriptions right in the chat window.

Q: How do I view subscription plans?

The agent invokes listsubscriptionplans to fetch all active recurring billing setups. You get the pricing details and billing cycles printed directly in your conversation.

Run Mexican payment operations directly from Claude Desktop by connecting this MCP Server to your live Conekta transaction data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Conekta MCP to Claude Desktop

Create your Vinkius account to connect Conekta to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Conekta with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run Conekta order operations inside Claude Desktop

The `create_order` tool lets you generate new customer transactions right from your Claude Desktop chat window. You provide the buyer's name, email, and line items, and the tool builds the order payload in MXN. When a customer asks for a quick invoice link, your agent uses `get_order` to pull the current charge status. You don't have to open a browser tab or copy-paste payment IDs anymore.

Track buyer profiles using the Conekta MCP Server

The `get_customer` tool pulls up-to-date payment methods and historical purchases for any buyer profile in your system. This lets Claude Desktop analyze customer behavior without you manually fetching CSV exports. If you only have an email address, `search_customer_by_email` scans your database to find the exact profile. Your agent instantly displays their active payment cards and past transaction volume.

Debug Mexican payment webhooks in Claude Desktop

The `list_events` tool exposes your raw API logs directly to Claude Desktop so you can trace failed webhooks. It shows you exactly what payload Conekta sent when a payment succeeded or failed. Pairing this with `list_orders` lets your agent cross-reference payment statuses with transaction histories. You can spot failing transactions in real-time without leaving your conversation.

Setup guide

Set up Conekta MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Conekta MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Conekta MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under conekta-mcp.

json

{
  "mcpServers": {
    "conekta-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Conekta. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Conekta now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Conekta MCP in Claude Desktop

Open your `claude_desktop_config.json` file and add the server configuration under the `mcpServers` block to register the MCP Server. Once you restart the app, your agent can call `list_events` to show you live webhook logs.

Yes, the agent calls `create_order` with the customer's details and item prices in cents. This generates a fresh order in your Mexican payment gateway instantly.

You can ask your agent to find someone, and it will run `search_customer_by_email` to locate them. It returns their payment history and active subscriptions right in the chat window.

The agent invokes `list_subscription_plans` to fetch all active recurring billing setups. You get the pricing details and billing cycles printed directly in your conversation.

Your Conekta API keys and customer payment records are processed locally through Claude Desktop's stdio transport via an MCP connection. Vinkius isolates the runtime in an ephemeral sandbox, meaning your raw order amounts and buyer emails are never stored or logged on our servers.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript