Skip to content
MCP server

Tolstoy

Manage a Tolstoy ecommerce workspace from chat: products, media library, templates

Install
Pricing
Paid
Platforms
Web, API
Runs
Remotely
Version
1.3.0
Listing updated
3 days ago

About Tolstoy

Tolstoy is a paid MCP server for e-commerce. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://apilb.gotolstoy.com/mcp/v1/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tolstoy": {
      "url": "https://apilb.gotolstoy.com/mcp/v1/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (26)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Paid, from $20 a month

Tolstoy Plus $20/month ($16 billed yearly); Business from $100/month; Enterprise custom

Prices change. Check gotolstoy.com before you buy.

Tolstoy 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 to Tolstoy

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. Let Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions

    Not checked yet
    • Remote
    • Open source
    • 2 GitHub stars
    • E-commerce
  4. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security
  5. Search replacement filters, alarms and batteries, check fit and build a cart link

    • 7 tools
    • Remote
    • Free
    • E-commerce