How to Use the BigCommerce MCP in Windsurf

Q: Can Windsurf write code using my BigCommerce product data?

Yes, Cascade pulls live details using getproductdetails and writes React or Vue components directly in your workspace. It uses the real API schema to ensure your code matches the store's exact properties.

Get Windsurf to pull BigCommerce customer histories, orders, and products in a single autonomous sweep.

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

Autonomous Catalog Audits in Windsurf

The `list_products` tool identifies stock gaps and categorization errors across your storefront without you prompting every single step. Windsurf reads your workspace context, pulls your catalog data, and flags formatting errors or missing fields immediately. You ask Cascade to fix a broken product taxonomy, and it uses `list_catalog_categories` and `list_catalog_brands` to map the store's structure. It writes the update code and runs it while you watch the plan execute.

Instant Order Verification via Cascade

The `list_orders` tool finds recent purchases and feeds them directly into Windsurf's context window. Cascade looks at the raw JSON payload to inspect payment status and shipping details in one shot. If a customer complains about a missing shipment, Cascade invokes `get_order_details` to check the exact line items. It then pulls up your shipping service code to diagnose why the API call failed.

Run Support Workflows with this MCP Server

The `get_customer_details` tool fetches customer profiles so Cascade can build custom admin views right inside your editor. You get real-time buyer history side-by-side with your store configuration data. Cascade chains this tool with `get_store_info` to check currency settings and tax zones before generating a mock invoice template. You don't have to copy-paste payloads from a browser tab anymore.

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-alternative-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 local config file and add this server under the mcpServers key. Once saved, hit refresh in the Windsurf MCP panel to let Cascade auto-discover the tools.

Yes, Cascade pulls live details using `get_product_details` and writes React or Vue components directly in your workspace. It uses the real API schema to ensure your code matches the store's exact properties.

Cascade plans multi-step actions autonomously, meaning it can call `list_customers` and then immediately run `get_customer_details` for a specific ID to solve your prompt. You see the entire execution plan in the chat interface before it runs.

The server handles API throttling under the hood when Windsurf makes multiple rapid calls. If Cascade runs a long loop to fetch all catalog categories, the server queues the requests to avoid hitting platform limits.

Your customer emails and order histories stay inside the secure V8 sandbox. This server never writes your API credentials to disk, keeping your store data isolated from external trackers.

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