How to Use the Conekta MCP in Windsurf

Q: How do I link Conekta to Windsurf for live payments?

Add the server configuration to your mcpconfig.json file inside the Windsurf settings. Once you hit refresh, Cascade detects the tools and starts executing payment queries.

Q: Can Windsurf handle Conekta order creation?

Yes, you can trigger createorder through the Cascade chat interface. Make sure you provide the customer name, email, and line items so the API accepts the request.

Q: What is the best way to list orders in Windsurf?

Use the listorders tool with a specific payment status filter. This narrows down the results so you only see the transactions that need your immediate attention.

Use the Conekta MCP server inside Windsurf to handle Latin American payment operations without leaving your IDE.

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 Windsurf

Create your Vinkius account to connect Conekta to Windsurf 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage transactions directly in Windsurf

Cascade can pull order history or current statuses by running `get_order`. It takes the raw JSON data and maps it straight into your project context. You avoid manual dashboard switching. Just ask Cascade to list recent activity with `list_orders` and watch it parse the payment status for you.

Automate customer lookups in Windsurf

Finding contact details happens instantly when you call `search_customer_by_email`. Your agent pulls the profile data and maps it to your local variables. Everything stays in the loop. You can even fetch full records using `get_customer` to verify billing addresses or payment sources before you commit code.

Debug payment flows in Windsurf

Troubleshoot failed charges by inspecting webhooks through `list_events`. This gives you a clear audit trail of exactly what happened during a transaction. Windsurf chains these calls to find patterns in your logs. You get the root cause without digging through the Conekta admin panel.

Setup guide

Set up Conekta MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Conekta MCP

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

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Conekta payment history." If connected, Cascade will call the Conekta tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.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 Windsurf

Add the server configuration to your `mcp_config.json` file inside the Windsurf settings. Once you hit refresh, Cascade detects the tools and starts executing payment queries.

Yes, you can trigger `create_order` through the Cascade chat interface. Make sure you provide the customer name, email, and line items so the API accepts the request.

Vinkius handles the connection using a secure endpoint token. Your credentials stay isolated, and the agent only accesses the specific data needed to complete your task.

Use the `list_orders` tool with a specific payment status filter. This narrows down the results so you only see the transactions that need your immediate attention.

It accesses customer contact info and payment sources required for transaction processing. This data stays within the ephemeral sandbox environment and is never logged by the provider.

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