Tolstoy MCP

Connect any MCP client — Claude, ChatGPT, Cursor, Gemini, and more — to Tolstoy, the agentic platform for AI-native ecommerce brands. Run your shoppable video workspace right from chat: generate marketing content, manage your media library, build and publish shoppable widgets, browse your catalog, tag products, and track ad performance.

Tolstoy exposes its remote MCP servers over Streamable HTTP. The main Tolstoy server is secured with OAuth 2.1 + PKCE — no API keys to paste, your client runs the OAuth sign-in on first connect. Shopper is a separate public, no-auth marketplace server.

Tools

The main Tolstoy server exposes the following tools.

Studio — content generation

• `generate_studio_content` — start a new Studio generation (image or video) from a prompt.
• `iterate_studio_content` — continue and refine an existing Studio generation in the same session.
• `get_studio_session` — check status and retrieve the finished media for a generation.
• `list_studio_folders` — list your Studio projects and folders.
• `list_studio_chats` — list the chats inside a Studio project or folder.

Media library

• `list_assets` — list your most recent library assets (videos, images, AI drafts).
• `search_assets` — search the library by name or creator handle.
• `get_asset` — fetch full details for an asset, including tagged products and playlists.
• `update_asset` — rename an asset or toggle its favorite status.

Shoppable widgets

• `list_widgets` — list your onsite shoppable video widgets (Stories, Carousel, Spotlight, For You Feed, Tile, Collection Grid, Bubble Feed), live or draft.
• `get_widget` — inspect a widget: type, live status, content selection, and the actual videos it shows (per-product for PDP-mode shoppable widgets).
• `create_widget` — create a new shoppable widget from a template, with the platform's defaults.
• `update_widget` — rename, publish/unpublish, set PDP mode, or change a widget's content selection.

Products & catalog

• `list_collections` — list the catalog collections for a connected store.
• `search_products` — find store products by title or query.
• `browse_products` — browse catalog products and collections for a connected store.
• `tag_video_product` — tag (or untag) products on a video so it becomes shoppable in product-tagged playlists and PDP widgets.

Stores

• `list_stores` — list the connected stores on your account; widget, catalog, and product tools can target any of them.

Paid ads

• `list_ad_campaigns` — list your Meta ad campaigns with real delivery status (`effectiveStatus` truth-telling).
• `get_ads_performance` — Meta ads performance: spend, ROAS, CTR, purchases — per campaign, ad set, or ad.
• `publish_to_meta_ads_library` — push a library video or image into Meta Ads Manager, ready for ad creation (no campaign, no spend).

Shopper (separate public marketplace server — no auth)

• `search_products` — search products across every brand store on Tolstoy, one marketplace-wide catalog.
• `get_product` — full product details: description, variants, price, media, the brand's videos, and buy/cart links.
• `try_on` — open an interactive virtual try-on of a product (participating brands); the shopper uploads a photo and sees themselves wearing the actual item.

App-aware clients (ChatGPT, Claude) also get interactive views — a shoppable-widget card grid and asset previews — rendered inline in chat.

Connect

1. In your MCP client, add a custom connector / remote MCP server.

2. Paste the Tolstoy (or Shopper) endpoint above.

3. Sign in with your Tolstoy account when prompted (OAuth). Shopper needs no sign-in.

Per-client setup (Claude, ChatGPT, Cursor, Gemini CLI, Codex, Perplexity, Goose, Cherry Studio, and more) is available in the Tolstoy platform under Settings → MCP.

Cursor Marketplace plugin

This repository includes a Cursor plugin manifest in `.cursor-plugin/plugin.json`. Install the repository as a local plugin while developing, or install Tolstoy from the Cursor Marketplace after the listing is approved. The plugin adds the OAuth-secured Tolstoy workspace server. The public Tolstoy Shopper server remains available through the endpoint and client configuration documented above.

Example client config

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

Codex CLI

`codex mcp add` targets STDIO servers, so add the remote server to `~/.codex/config.toml` and run the OAuth login:

[mcp_servers.tolstoy]
url = "https://apilb.gotolstoy.com/mcp/v1/mcp"

[mcp_servers.tolstoy-shopper]
url = "https://apilb.gotolstoy.com/mcp/v1/shopper/mcp"

codex mcp login tolstoy

Authentication

OAuth 2.1 with PKCE, backed by Amazon Cognito. Discovery via RFC 9728 protected-resource metadata at the server's `/.well-known` endpoints. Each connection is bound to the Tolstoy workspace you authorize with. Shopper is a public marketplace server and requires no authentication.

Privacy, terms, and support

• Privacy policy
• Terms of use
• Support: support@gotolstoy.com
• Security overview: gotolstoy.com/security

Registry

Published in the official MCP Registry:

• `io.github.GoTolstoy/studio` — the main Tolstoy server
• `io.github.GoTolstoy/shopper`

The `server.json` for each is in `registry/`.

About

Tolstoy is the agentic platform for AI-native ecommerce brands, powering shoppable video for thousands of stores — https://www.gotolstoy.com