How to Use the Searchspring MCP in Windsurf

Q: How does Windsurf use Searchspring to build navigation?

Cascade calls searchcategory to fetch your live Searchspring catalog taxonomy. It then writes the sidebar code and maps the paths to dynamic frontend routes automatically.

Q: Can I test Searchspring custom parameters inside Windsurf?

Yes. Cascade uses this MCP server to call searchcustom with specific Searchspring parameters. It will execute the request, show you the raw JSON payload, and help you map those fields to your UI.

Q: How do I handle Searchspring sorting inside Windsurf?

Cascade chains searchsorted with your UI components. It writes the sorting dropdown, binds the change events, and updates the Windsurf product grid by calling the tool with the requested sort key.

Q: What happens if a Searchspring SKU search returns no results?

This MCP server returns an empty payload when searchsku finds nothing. Cascade detects this state and automatically writes fallback UI components, like a 'Product Not Found' block, to handle the empty state gracefully in Windsurf.

Get real-time Searchspring catalog data directly into Windsurf's Cascade agent to build and debug e-commerce storefronts instantly.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Searchspring MCP to Windsurf

Create your Vinkius account to connect Searchspring to Windsurf — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Searchspring with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Auto-generate Searchspring pages in Windsurf

Windsurf's Cascade agent chains multi-step search queries to build dynamic Searchspring product listings. The agent calls `search_products` to pull actual inventory items, then automatically parses the structure to write your frontend components. Instead of hardcoding dummy data, Cascade uses `search_category` to grab your live Searchspring hierarchy. It writes the exact React or Vue code needed to render the category tree, instantly matching your production store layout.

Build Searchspring navigation with this MCP Server

Cascade doesn't just ask you how to filter products; it figures out the Searchspring facet structure on its own. By executing `search_filtered` alongside `search_price_range`, the Windsurf agent maps out your store's filter sidebar in one autonomous run. It loops through the returned Searchspring attributes, writes the state management logic in your workspace, and hooks up the inputs. You get a working, live-filtered catalog UI without writing any boilerplate.

Debug Searchspring query logic in Cascade

When Searchspring relevance breaks, you don't need to open external dashboards. Ask Cascade to inspect query behavior, and it will run `suggest_queries` or `search_custom` to see exactly what Searchspring returns for tricky terms. The Windsurf agent compares the raw Searchspring JSON payload against your frontend rendering code, identifies where the parsing logic fails, and applies the fix directly to your codebase.

Setup guide

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

mcp_config.json

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

Cascade calls `search_category` to fetch your live Searchspring catalog taxonomy. It then writes the sidebar code and maps the paths to dynamic frontend routes automatically.

Yes. Cascade uses this MCP server to call `search_custom` with specific Searchspring parameters. It will execute the request, show you the raw JSON payload, and help you map those fields to your UI.

Cascade chains `search_sorted` with your UI components. It writes the sorting dropdown, binds the change events, and updates the Windsurf product grid by calling the tool with the requested sort key.

This MCP server returns an empty payload when `search_sku` finds nothing. Cascade detects this state and automatically writes fallback UI components, like a 'Product Not Found' block, to handle the empty state gracefully in Windsurf.

No. This integration only handles public Searchspring catalog metadata, SKU details, and search queries. Your customers' personal information and transaction histories are never accessed or processed by Windsurf.

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