How to Use the Ecwid MCP in Windsurf

Q: Can Windsurf update my Ecwid inventory automatically?

Yes. Cascade can chain searchproducts to find low-stock items and then execute updateinventory to adjust the quantities. You set the threshold rule, and the agent handles the API calls.

Q: Does the Ecwid MCP integration support custom app storage?

It does. The getappstorage tool pulls key-value pairs from your custom app state. Windsurf reads this data to maintain context across complex store operations.

Q: How does Windsurf handle Ecwid order searches?

Cascade uses searchorders to filter by status, date, or customer. It returns the raw JSON containing totals and fulfillment data directly into your active editor session.

Let Windsurf Cascade automate your Ecwid store operations directly from 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 Ecwid MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Catalog Management via Windsurf MCP Server

The `search_products` tool lets Windsurf scan your entire storefront inventory. You give Cascade a target—like finding all items tagged for a summer sale—and it pulls IDs, SKUs, pricing, and stock levels without you clicking through a dashboard. Once it finds the target items, Cascade can chain into `get_product` to pull deep attribute data or SEO info. If stock needs adjusting, it fires `update_inventory` automatically. You just watch the logs as your store updates in real time.

Order and Customer Auditing

The `search_orders` tool exposes fulfillment and payment statuses straight to your editor. Cascade reads the parameters, fetches the matching records, and parses buyer details and order totals. If a specific transaction looks weird, the agent hits `get_order` for the exact ID. It can then run `search_customers` to pull up the buyer's history. You get a complete audit trail written into your workspace without leaving the IDE.

Store Configuration and Logic

The `get_profile` tool gives your agent read access to the core Ecwid store configuration. Windsurf checks this to understand your base settings before it attempts to write custom logic. For promotional campaigns, Cascade calls `list_categories` and `list_coupons`. It can even hit `get_app_storage` to read custom app state data, allowing the agent to map out complex discount rules across specific product categories.

Setup guide

Set up Ecwid 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 Ecwid 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 Ecwid payment history." If connected, Cascade will call the Ecwid tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "ecwid-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 Ecwid. 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 Ecwid 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 Ecwid MCP in Windsurf

Open the Settings menu and navigate to Cascade. Click the MCP Servers UI to add it, or just use the built-in MCP Marketplace for a one-click install. Hit refresh and Cascade will auto-discover the tools.

Yes. Cascade can chain `search_products` to find low-stock items and then execute `update_inventory` to adjust the quantities. You set the threshold rule, and the agent handles the API calls.

It does. The `get_app_storage` tool pulls key-value pairs from your custom app state. Windsurf reads this data to maintain context across complex store operations.

Cascade uses `search_orders` to filter by status, date, or customer. It returns the raw JSON containing totals and fulfillment data directly into your active editor session.

Vinkius isolates every session in a V8 sandbox. When Cascade pulls buyer details via `search_customers`, that sensitive PII stays within an ephemeral environment. The connection uses a single endpoint token, and zero trust rules apply to every query.

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