How to Use the BigCommerce MCP in Windsurf

Run your BigCommerce store directly through Windsurf with Cascade chaining multi-step catalog and order updates.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect BigCommerce MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated Inventory Audits in Windsurf

`list_products` lets Windsurf fetch your catalog while `get_product` grabs deep details for any mismatched SKU Cascade finds. Cascade handles the entire inspection loop on its own, scanning your inventory and correcting stock counts without requiring you to approve every single step. You just tell your agent to find out-of-stock items, and it pulls the entire BigCommerce list, flags the gaps, and writes a Markdown report. It makes managing thousands of SKUs inside your IDE feel like a local file search.

Cascade Customer Lookup Sequences

`list_customers` gives Cascade the power to search your buyer database, pairing it with `list_orders` to map buying behavior instantly. This MCP Server lets your agent trace a user's entire history, finding their lifetime spend and active coupons in seconds. Instead of jumping between tabs, tell Windsurf to find your top ten buyers and write a personalized email draft for each. Cascade chains the queries, pulls the data, and leaves the drafts in your workspace.

Live Order and Coupon Syncing

`get_order` pulls live transactional payloads directly into Windsurf, while `list_coupons` matches active discounts against those invoices. Cascade uses these tools to run automated verification checks on disputed purchases right inside your editor. When a customer complains about a discount code, you can have your agent fetch the order products, verify the coupon status, and output the exact discrepancy. It saves you from digging through the BigCommerce admin panel for every support ticket.

Setup guide

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

mcp_config.json

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

Open your Windsurf settings, head to Cascade MCP Servers, and add the Vinkius URL under your config file. Cascade will instantly discover the store tools and let you query your storefront.

Cascade runs multi-step sequences using this MCP to collect, filter, and structure order data in one go. You specify the target orders, and your agent chains the calls to compile the list.

Cascade plans a sequence of tool calls using your store metadata and executes them back-to-back. You set the goal, and the agent pulls products or customer records until the task is complete.

Yes, your agent uses the brand tools to find the exact brand ID, then applies that filter to narrow down your inventory. It makes catalog cleanup incredibly fast.

Your customer records, order details, and store metadata stay inside the secure Vinkius sandbox. This MCP Server only passes the raw JSON payloads requested by your agent to your local IDE.

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