# Searchspring MCP for AI Agents AI Agent Connect

> Searchspring. Connect your e-commerce catalog to your AI agent to perform natural language searches, filter thousands of SKUs by price or brand, and audit product metadata. It turns your store's data into a searchable knowledge base for your AI.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_44ngnKMHV7LnrsfvgkXeZwgaYIcvUjpmYWw4vK9v/ai-agent-connect
- **Tags:** site-search, merchandising, product-catalog, autocomplete, ecommerce, inventory-management, metadata-auditing, faceted-search

## Description

Searchspring lets you connect your e-commerce store to an AI agent so you can interact with your product catalog conversationally. Instead of digging through a complex admin dashboard or manually filtering rows in a spreadsheet, you can just ask your agent to find specific items. You can pull up product images, check if a specific SKU is in stock, or see what's trending in your autocomplete suggestions. It works by exposing your catalog's logic directly to your AI client, meaning you can move from a thought to a filtered list of products in seconds. If you're looking for a way to manage this at scale, Vinkius makes it easy to plug this into your existing workflow. Whether you're trying to spot merchandising gaps or just want a faster way to look up specs for a customer, this Connector handles the heavy lifting of navigating your catalog's hierarchy.

## Tools

### suggest_queries
Pulls the autocomplete suggestions your customers see. It helps you understand what people are actually looking for.

### search_brand
Lists all products associated with a specific brand. Use this to create brand-focused shopping experiences.

### search_category
Lists products within a specific category path. This helps the AI understand your store's hierarchy.

### search_custom
Executes searches using unique Searchspring parameters. This lets you use the full power of your specific setup.

### search_filtered
Filters products based on specific keys like size or color. It helps you find exact matches in a large catalog.

### search_pagination
Retrieves specific pages of search results. Use this to navigate through large sets of items.

### search_price_range
Finds products within a specific price bracket. It's the fastest way to show customers budget-friendly options.

### search_products
Performs a general search across your entire catalog. This is the go-to tool for broad product discovery.

### search_sku
Pulls every detail for a specific SKU. It's perfect for verifying exact specs or current stock levels.

### search_sorted
Sorts your search results by criteria like price or popularity. This makes it easy to show the most relevant items first.

## Prompt Examples

**Prompt:** 
```
Search our catalog for 'wireless headphones' and sort the results by price in ascending order.
```

**Response:** 
```
I've fetched the products sorted by price in ascending order:

| Product Name | Price | Status |
| :--- | :--- | :--- |
| Basic Wireless Buds | $19.99 | In Stock |
| Studio Sync Headphones | $34.50 | Low Stock |
| Noise-Canceling Overhead | $49.00 | In Stock |

Would you like to see the thumbnail images for these items?
```

**Prompt:** 
```
Fetch the product specs and current availability for SKU 'LPTOM-415'.
```

**Response:** 
```
**Product Details: Dell XPS 13 Ultrabook**

*   **Price:** $1,199
*   **Specs:** i7 processor, 16GB RAM, 512GB SSD
*   **Inventory Status:** ❌ OUT OF STOCK

This item is currently unavailable in our primary warehouse.
```

**Prompt:** 
```
Find all products by the brand 'Nike' that cost between $50 and $100.
```

**Response:** 
```
I found 12 results for **Nike** between $50 and $100. Here are the top matches:

*   **Revolution 6 Running Shoes** - $65.00
*   **Sportswear Club Fleece Hoodie** - $55.00
*   **Dri-FIT Training Pants** - $70.00

Would you like me to pull the full list or filter these by a specific category?
```

## Capabilities

### Filter products by attributes
Narrow down your inventory by size, color, or brand using natural language.

### Check SKU availability
Get real-time stock status and pricing for specific items instantly.

### View autocomplete trends
See what customers are typing into your search bar to understand search behavior.

### Audit category metadata
Verify that your product tags and descriptions are syncing correctly across your store.

### Sort and paginate results
Organize large lists by price or popularity without manual clicking.

## Use Cases

### Merchandising Audit
An e-commerce manager asks the AI to find all 'Mens Shoes' that are currently out of stock to see where they need to restock.

### Developer QA
A developer uses search_custom to verify that new JSON facets are being parsed correctly before the site goes live.

### Support Speed
A support agent asks for the specs of SKU 'LPTOM-415' to answer a customer's tech question without switching tabs.

### Trend Analysis
A marketing lead pulls suggest_queries to see which products are getting the most autocomplete traffic.

## Benefits

- Stop manual inventory lookups by using search_sku to get instant facts on any item.
- Identify merchandising gaps faster by asking the AI to find out-of-stock items in specific categories.
- Improve your search strategy by pulling real-time autocomplete data with suggest_queries.
- Validate your data integrity by auditing category trees and metadata with search_category.
- Create custom shopping experiences by combining search_price_range and search_sorted for tailored results.

## How It Works

The bottom line is that your AI gains a direct line to your e-commerce inventory for instant data retrieval.

1. Connect your Searchspring Site ID to the Connector.
2. Link your AI client to the Vinkius catalog.
3. Ask your agent to find products, check stock, or pull category data.

## Frequently Asked Questions

**Can I use Searchspring MCP to check if items are in stock?**
Yes. You can ask your agent to check the real-time status of any specific SKU, and it will return the current stock level and pricing.

**How does Searchspring MCP help with merchandising?**
It helps you identify gaps in your inventory by finding out-of-stock items in specific categories or brands instantly.

**Can I see what customers are searching for?**
Yes. You can pull autocomplete suggestions to see what your customers are actually typing into your search bar.

**Does Searchspring MCP work with my existing store?**
It works with any store using Searchspring or Athos Commerce. You just need to provide your unique Site ID.

**Can I filter by price and brand at the same time?**
Yes. Your agent can combine multiple filters, like brand and price range, to find exactly what you need in one go.

**Can I use Searchspring MCP to audit my categories?**
Yes. You can ask the AI to browse your category hierarchy to verify that your product metadata is syncing correctly.

**Can the AI filter catalog products by specific colors or variations?**
Yes. You can instruct the agent: 'Find all Men's Shirts and filter by color: Blue and size: Medium'. The agent will natively invoke `search_filtered` passing the specific parameter facets to narrow down exactly what is requested.

**Can I check autocomplete queries directly from the chat prompt?**
Absolutely. Use the prompt: 'What queries do you suggest when someone types "runn"?'. The agent fires `suggest_queries` simulating a shopper and returns search trends such as 'running shoes', 'running shorts', demonstrating what customers see.

**How do I ensure the integration only searches within a specific category?**
You can explicitly ask the AI to restrict the search. For example: 'Using the Searchspring API, list the top 5 products strictly in the Electronics > Audio category'. The agent invokes `search_category`, returning items isolated within that structural path.