How to Use the Searchspring MCP in CrewAI

Q: How can I give different CrewAI agents access to different Searchspring tools?

When defining your Agent in CrewAI, use the toolfilter parameter on your MCP Server connection object. This lets you expose searchproducts to a researcher agent but not to a writer agent, for example.

Q: How do I build a CrewAI team to find the best-selling products in a category from Searchspring?

You could have one agent use searchcategory to get all products. A second agent could then use searchsorted with a "salesrank:desc" parameter to find the top items. CrewAI's shared memory lets them collaborate on the task.

Deploy autonomous e-commerce crews with CrewAI. Give your agents specialized roles for catalog research, analysis, and reporting.

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 CrewAI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Assemble Catalog Research Teams

Assign a "Researcher" agent the `search_products` and `search_filtered` tools. Its job is to gather raw product data based on a high-level goal, like "find all running shoes under $100." A second "Analyst" agent can then take that data, use `search_sorted` to rank it by price, and use `search_brand` to group it. CrewAI lets them share context, so the Analyst knows exactly what the Researcher found via the MCP server.

Build Competitor Monitoring Crews

Create a crew to watch competitor brand activity. One agent uses `search_brand` to periodically check the product count for a specific brand. It passes this number to a "Trend Analyst" agent. The Trend Analyst agent maintains a history. If it sees a sudden spike in products, it can delegate a task to a "Reporter" agent to use `search_products` with a recent date filter and summarize the new additions. This is how you build autonomous monitoring systems.

Content Generation with this MCP Server

Equip a "Copywriter" agent with tools from this MCP Server. It can be tasked with "writing a blog post about new hiking boots." The agent first uses `search_category` and `search_filtered` to find relevant products. It then hands the list of SKUs to a "Detailer" agent, which uses `search_sku` to get specs for each product. The Copywriter agent then uses this structured data to write its content, all without a human manually looking up product info.

Setup guide

Set up Searchspring MCP in CrewAI

Prerequisites

Python 3.10+ installed
crewai package (pip install crewai)
Active Vinkius subscription with a valid endpoint token

1

Install CrewAI
Run pip install crewai to install the framework. MCP support is built-in via the mcps parameter.
2

Add the MCP URL to your agent
Pass your Vinkius endpoint directly to the mcps list. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. CrewAI handles tool discovery and caching automatically.
3

Kick off your crew
Create a Crew with your agent and tasks. Call crew.kickoff() — the agent will automatically invoke Searchspring tools as needed.

crew.py

from crewai import Agent, Task, Crew

agent = Agent(
    role="Searchspring Analyst",
    goal="Access and analyze Searchspring data via MCP.",
    backstory="Expert analyst with direct Searchspring access.",
    mcps=[
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ],
)

task = Task(
    description="List recent Searchspring transactions",
    agent=agent,
    expected_output="A summary of recent activity",
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()
print(result)

Get your connection token →

Prerequisites

Python 3.10+ installed
crewai + crewai-tools packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install crewai crewai-tools. The MCPServerAdapter handles lifecycle management and tool conversion.
2

Connect with MCPServerAdapter
Use MCPServerAdapter as a context manager with SseServerParameters pointing to your Vinkius endpoint. The adapter automatically manages connection lifecycle.
3

Assign tools and run
Pass the returned mcp_tools to your agent's tools parameter. The adapter converts MCP tools to native BaseTool objects compatible with all CrewAI agents.

crew.py

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
from mcp import SseServerParameters

server_params = SseServerParameters(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

with MCPServerAdapter(server_params) as mcp_tools:
    agent = Agent(
        role="Searchspring Analyst",
        goal="Access and analyze Searchspring data via MCP.",
        backstory="Expert analyst with direct Searchspring access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent Searchspring transactions",
        agent=agent,
        expected_output="A summary of recent activity",
    )

    crew = Crew(agents=[agent], tasks=[task])
    result = crew.kickoff()
    print(result)

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 CrewAI

When defining your Agent in CrewAI, use the `tool_filter` parameter on your MCP Server connection object. This lets you expose `search_products` to a researcher agent but not to a writer agent, for example.

Yes, that's a great use case for a CrewAI team. An "Assistant" agent could use `suggest_queries` from Searchspring to brainstorm possible searches. It would then pass the best suggestions to a "Researcher" agent to execute.

You could have one agent use `search_category` to get all products. A second agent could then use `search_sorted` with a "sales_rank:desc" parameter to find the top items. CrewAI's shared memory lets them collaborate on the task.

The easiest way is to pass the Vinkius MCP server URL directly into the `mcps` list when you instantiate your Agent. CrewAI handles the connection and makes the tools available automatically.

The server only processes public e-commerce catalog data like product names and prices from Searchspring. Your CrewAI agent definitions, tasks, and internal memory are never sent or stored. Each tool call is handled in a stateless, ephemeral sandbox on Vinkius.

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