
Tolstoy
Manage a Tolstoy ecommerce workspace from chat: products, media library, templates
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://apilb.gotolstoy.com/mcp/v1/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"tolstoy": {
"url": "https://apilb.gotolstoy.com/mcp/v1/mcp"
}
}
}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

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media
O'So MCP Server for PrestaShop
MCP serverLet Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions
Not checked yet- Remote
- Open source
- 2 GitHub stars
- E-commerce

SecureCloud
MCP serverSentinelOne and IT security catalog, prices, quotes and checkout links for Israel
- 7 tools
- Remote
- Free
- Security

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

MadMax Trade Supply parts
MCP serverSearch replacement filters, alarms and batteries, check fit and build a cart link
- 7 tools
- Remote
- Free
- E-commerce