How to Use the Searchspring MCP in VS Code Copilot

Q: How does my team use VS Code Copilot to check product data in Searchspring?

Once the MCP server is configured in your project's .vscode/mcp.json, any developer can open Copilot Chat and ask. For example, 'Using Searchspring, find products in the Tents category.' The agent uses the searchcategory tool and shows the results.

Q: Can we test complex, multi-filter searches with Searchspring and VS Code Copilot?

Yes. The searchfiltered tool accepts multiple key-value pairs. You can ask Copilot, 'Run a Searchspring search for products with filters brand:arcteryx,color:red,' and it will construct and execute the correct tool call.

Connect your entire team to your Searchspring catalog directly within VS Code Copilot for consistent, live data.

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 VS Code Copilot

Create your Vinkius account to connect Searchspring to VS Code Copilot — 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 VS Code Copilot

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Standardize Catalog Access for Your Team

Commit the `.vscode/mcp.json` file to your repository. Now every developer on the team gets the same Searchspring tools in Copilot automatically. No individual setup, no mismatched configurations. When a new developer joins, they just pull the repo and Copilot is ready to use `search_sku` to check product details or `search_filtered` to test facet combinations. This MCP server ensures your entire team builds against the same live catalog data from day one.

Validate Search Logic from Your Editor

Use Copilot Chat to debug your e-commerce front-end. If a search result looks wrong, you can immediately ask the agent to run the same query using the Searchspring tools. For example, 'Show me page 3 of results for *laptops* sorted by price descending.' Copilot will use `search_products`, `search_sorted`, and `search_pagination` to replicate the search. You can compare the direct API response to what your front-end is rendering to quickly find the bug. It's much faster than digging through network tabs.

Prototype with Real-time Searchspring Data

When you're building a new feature, you need realistic data. Ask Copilot to 'Get autocomplete suggestions for *hiking boots* using Searchspring's `suggest_queries` tool.' It will fetch the live suggestions for you to use in your code. This works for any product data. Need to see what's in a specific price band? The `search_price_range` tool gives you an immediate answer. You're no longer coding blind against a stale data file.

Setup guide

Set up Searchspring MCP in VS Code Copilot

Prerequisites

VS Code 1.99 or later with GitHub Copilot extension
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run "MCP: Add Server". Select HTTP (Streamable) as the server type. VS Code will create .vscode/mcp.json in your workspace.
2

Add the Searchspring MCP

Paste the JSON snippet shown on the right into your .vscode/mcp.json. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Switch to Agent mode

Open Copilot Chat (Cmd+Shift+I / Ctrl+Shift+I) and switch to Agent mode using the dropdown. MCP tools are only available in Agent mode — they do not appear in Edit or Ask modes.
4

Verify the connection

In the Copilot Chat input, type # to list available tools. You should see the Searchspring tools listed. Try asking: "List my recent Searchspring transactions" and Copilot will invoke them automatically.

.vscode/mcp.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 VS Code Copilot

Once the MCP server is configured in your project's `.vscode/mcp.json`, any developer can open Copilot Chat and ask. For example, 'Using Searchspring, find products in the *Tents* category.' The agent uses the `search_category` tool and shows the results.

Yes. The `search_filtered` tool accepts multiple key-value pairs. You can ask Copilot, 'Run a Searchspring search for products with filters *brand:arcteryx,color:red*,' and it will construct and execute the correct tool call.

It guarantees every engineer is building and testing against the same live product catalog and search logic. There are no discrepancies from one developer's machine to another. This prevents 'works on my machine' problems related to data.

When you put Copilot Chat in Agent mode, it detects the available tools from your MCP configuration. When your prompt matches a tool's purpose—like asking to 'find a product by SKU'—it knows to use the `search_sku` tool.

The server processes your search terms, brand names, and category filters to query the Searchspring catalog. All requests pass through a Vinkius-managed ephemeral sandbox. Your Searchspring API credentials are encrypted at rest and never exposed to the client or logged.

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