# Savanto

> Savanto is an open-source MCP server for e-commerce. MCP server that lets AI clients manage a Savanto store's catalog, content and analytics. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, Web, Self-hosted
- **Website:** https://savanto.ai/mcp
- **Repository:** https://github.com/savantoai/mcp-server
- **MCP Registry name:** io.github.SavantoAI/mcp-server
- **Categories:** [e-commerce](https://ai-powered.com/categories/e-commerce)
- **Listing updated:** 2026-11-21

## About

The README describes this as a local Model Context Protocol server that exposes a Savanto AI workspace to clients such as Claude, ChatGPT and Cursor. Instead of working through the dashboard, a store owner can set up and adjust the store's search and chat assistant through conversation with their own AI.

Once connected, the server offers a set of tools that mirror the Savanto REST API, covering workspaces, configuration, products and posts, taxonomies, prompts, webhooks, crawling, search, analytics, chat threads and diagnostics. The registry entry also lists a hosted remote endpoint that uses OAuth, while the npm package runs locally over stdio with a secret API key.

The tools are gated by the scopes of the key in use, so a client only sees tools it is allowed to call. Destructive operations such as deleting a workspace require an explicit confirmation flag. The project is aimed at store operators and agencies who run Savanto-powered search and chat on their sites.

## Features

- **Catalog and content management:** Create, update, bulk-import and delete products, posts and taxonomies from a chat client.
- **Prompt and assistant tuning:** Create and reorder assistant prompts and adjust chat configuration through natural language.
- **Analytics review:** Query search, chat and feedback analytics and pull up search logs and conversation threads.
- **Scope-gated tool surface:** Tools are registered only when the supplied key has the permissions to use them.
- **Guided playbooks:** Exposes MCP prompts for onboarding, auditing chats and debugging empty searches.
- **Local and hosted connection:** Runs as an npm stdio server with an API key, or connects to a hosted streamable-HTTP endpoint.

## Good for

- Bulk-add or hide seasonal products in a store catalog from a chat window
- Find searches that return no results and add content to cover them
- Review negative chat feedback and adjust the assistant's prompts
- Set up a new Savanto workspace with crawled content and branding

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp-server https://mcp.savanto.ai/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.savanto.ai/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "url": "https://mcp.savanto.ai/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-server": {
      "type": "http",
      "url": "https://mcp.savanto.ai/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "serverUrl": "https://mcp.savanto.ai/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://mcp.savanto.ai/mcp
```

Enter a Name (for example "Savanto"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-server": {
      "type": "http",
      "url": "https://mcp.savanto.ai/mcp"
    }
  }
}
```

## Tools

- `list_workspaces`: Lists workspaces the key can access.
- `create_workspace`: Creates a new workspace.
- `update_workspace`: Updates a workspace.
- `delete_workspace`: Deletes a workspace; requires confirm: true.
- `get_workspace_settings`: Reads workspace settings.
- `update_workspace_settings`: Updates workspace settings.
- `upsert_product`: Creates or updates a product.
- `upsert_post`: Creates or updates a post.
- `search_products`: Searches products in the store.
- `search_posts`: Searches posts in the store.
- `upsert_prompt`: Creates or updates an assistant prompt.
- `list_prompts`: Lists assistant prompts.
- `get_search_analytics`: Returns search analytics.
- `get_chat_analytics`: Returns chat analytics.
- `get_feedback_analytics`: Returns feedback analytics.
- `list_feedback`: Lists customer feedback.
- `chat`: Sends a message to the store assistant.
- `whoami`: Shows the identity and scopes of the current key.

## FAQ

### Which AI clients does Savanto work with?

The README lists Claude Desktop, Cursor, Cline and Roo, OpenAI Agents, and any other MCP-compatible client.

### What do I need to run the local server?

Node.js 20 or later and a secret Savanto API key starting with if_sk_, which you create in the dashboard.

### Is the server open source?

The README states the project is licensed under MIT.

### Does the server open a network port?

The README says the stdio server runs locally and never opens a network port, though the separate HTTP server mode does listen on a port.

### Is Savanto free?

Yes. Savanto is open source, so you can use and self-host it for free.

### How do I add Savanto to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp-server https://mcp.savanto.ai/mcp

### What are the best alternatives to Savanto?

The closest alternatives to Savanto are Hello Retail, VOC OpenAPI MCP, MCP Gateway, ShopSavvy and 1stPage — Amazon Seller & Vendor Analytics.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Hello Retail](https://ai-powered.com/mcp/hello-retail): Hello Retail is an MCP server for e-commerce.
- [VOC OpenAPI MCP](https://ai-powered.com/mcp/voc-openapi-mcp): VOC OpenAPI MCP is a freemium MCP server for developer tools.
- [MCP Gateway](https://ai-powered.com/mcp/mcp-gateway-6): MCP Gateway is an MCP server for e-commerce.
- [ShopSavvy](https://ai-powered.com/mcp/shopsavvy): ShopSavvy is a freemium MCP server for e-commerce.
- [1stPage — Amazon Seller & Vendor Analytics](https://ai-powered.com/mcp/1stpage-amazon-seller-and-vendor-analytics): 1stPage — Amazon Seller & Vendor Analytics is a freemium MCP server for marketing and seo.

---
Source: https://ai-powered.com/mcp/savanto
