# Tolstoy

> Tolstoy is a paid MCP server for e-commerce. Manage a Tolstoy ecommerce workspace from chat: products, media library, templates. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Starting price:** $20 a month
- **Platforms:** Web, API
- **Website:** https://www.gotolstoy.com/mcp
- **Repository:** https://github.com/gotolstoy/mcp
- **MCP Registry name:** io.github.GoTolstoy/tolstoy
- **Categories:** e-commerce, design and media
- **Listing updated:** 2026-11-14

## About

Tolstoy runs two remote servers over Streamable HTTP with OAuth 2.1 and PKCE, so there are no API keys to paste. The main one reaches a store's workspace: it searches products and variants, reads the brand profile (logos, colours, fonts, audience, size guide), searches and inspects library videos and images, uploads media, and reads saved fashion models, content templates, projects, creative skills and credit usage. A second server, Tolstoy Closet, lets a shopper save and find the clothes they own and open a private link into the Shopbots app.

Some tools do more than read. analyze_media asks one question about a video or audio file and spends credits without changing the library, and get_agent_chat and stop_agent follow or stop a Tolstoy Agent chat, including ones started on the platform. Clients that can run shell commands can upload local files in two steps; others open an upload panel.

The repository doubles as a Claude plugin with a product-media skill. Setup guides cover ChatGPT, Claude, Cursor, Codex CLI, Perplexity, Replit, Base44, Gemini CLI, Grok, Manus, Le Chat and Goose.

## Features

- **Product search:** Finds catalogue products with variants and ids, and opens a panel to connect a catalogue.
- **Media library tools:** Searches videos and images, reads details, analyses clips and uploads files.
- **Brand context:** Reads logos, colours, fonts, audience and size guide for on-brand output.
- **Templates and projects:** Searches templates, projects and folders, plus saved fashion models.
- **Credit usage:** get_usage shows credit balances for the billing period.
- **Closet server:** A separate endpoint saves and removes a shopper's own clothes.

## Good for

- Shortlist library videos for one product page
- Upload missing product media from a terminal agent
- Check credit usage before a batch generation
- Pull brand colours and fonts into a creative brief
- Save a shopper's wardrobe items for styling in Shopbots

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http tolstoy https://apilb.gotolstoy.com/mcp/v1/mcp
```

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

```sh
https://apilb.gotolstoy.com/mcp/v1/mcp
```

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

```json
{
  "mcpServers": {
    "tolstoy": {
      "url": "https://apilb.gotolstoy.com/mcp/v1/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "tolstoy": {
      "type": "http",
      "url": "https://apilb.gotolstoy.com/mcp/v1/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tolstoy": {
      "serverUrl": "https://apilb.gotolstoy.com/mcp/v1/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tolstoy": {
      "type": "http",
      "url": "https://apilb.gotolstoy.com/mcp/v1/mcp"
    }
  }
}
```

## Tools

- `search_products`: Find products in the store's catalogue with variants and ids.
- `get_brand_context`: Read the store's brand profile.
- `connect_products`: Open the Tolstoy panel to connect a product catalogue.
- `search_media`: Search library videos and images.
- `get_media`: Read a media item's details.
- `analyze_media`: Ask one question about a video or audio file; spends credits.
- `start_media_upload`: Begin uploading a local file.
- `finish_media_upload`: Complete a local file upload.
- `upload_media_from_panel`: Open the panel to pick files to upload.
- `search_fashion_models`: Find saved models.
- `save_fashion_model`: Save images of a person as a model.
- `search_templates`: Find content templates.
- `get_template`: Read a content template.
- `search_projects`: List projects and folders.
- `list_skills`: Read Tolstoy's creative skills.
- `get_skill`: Read one creative skill.
- `get_agent_chat`: Read a Tolstoy Agent chat.
- `stop_agent`: Stop a Tolstoy Agent chat.
- `get_generation`: Read a generation's status and saved items.
- `list_voices`: Search the voice library.
- `get_usage`: Read credit balances and usage.
- `open_tolstoy`: Open Tolstoy in the client.
- `search_closet`: List or search a shopper's saved clothes.
- `add_closet_items`: Save clothes to the closet.
- `remove_closet_items`: Remove saved items.
- `get_shopbots_link`: Create a private link to the Shopbots app.

## FAQ

### How does sign-in work?

Your client runs an OAuth 2.1 sign-in with PKCE on first connect; no API keys are used.

### What is Tolstoy Closet?

A second endpoint for a shopper's private closet: search, add and remove saved clothes and get a Shopbots link.

### Do I need a Tolstoy plan?

Tolstoy's pricing page lists Plus at $20 a month ($16 billed yearly), Business tiers from $100, and Enterprise on custom terms.

### Which clients are supported?

Any client that accepts a remote MCP server; setup guides exist for ChatGPT, Claude, Cursor, Codex CLI and others.

### Is Tolstoy free?

No. Tolstoy is a paid product. Paid plans start at $20 a month.

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

Run this command in your terminal: claude mcp add --transport http tolstoy https://apilb.gotolstoy.com/mcp/v1/mcp

### What are the best alternatives to Tolstoy?

The closest alternatives to Tolstoy are HyperFrames by HeyGen, ffmpeg-skill, O'So MCP Server for PrestaShop, SecureCloud and AvatarSay — Fictional Character & Talking Video MCP.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.

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