Tolstoy Library

The Tolstoy Library MCP server turns any AI client into a control surface for your shoppable video workspace.

https://apilb.gotolstoy.com/mcp/v1/library/mcp

See Connect a client to add it. The tools below are grouped by what they manage.

Media assets

Your library of videos, images, social imports, and AI Studio drafts.

Tool	What it does
`list_assets`	List your most recent library assets, with optional type and favorite filters.
`search_assets`	Search the library by query (name, UGC creator).
`get_asset`	Fetch full details for one or more assets, including tagged products, playlists, and Shopify tags.
`update_asset`	Rename an asset or toggle its favorite status.

Shoppable widgets

Onsite video widgets shoppers see on your storefront — Stories, Carousel, Spotlight, For You Feed, Tile, Collection Grid, and Bubble Feed.

Tool	What it does
`list_widgets`	List your onsite shoppable widgets, live or draft, with type and status.
`get_widget`	Inspect a widget: type, live status, content selection, and the actual videos it shows — pass a `productId` to preview a specific product page.
`create_widget`	Create a new shoppable widget from a template, with the platform’s defaults.
`update_widget`	Rename, publish/unpublish, toggle PDP mode, or replace a widget’s content selection.

Setting a widget live activates it in Tolstoy; appearing on the storefront also needs the Tolstoy app embed enabled in your Shopify theme (a one-time setup per store). The publish result returns the exact steps.

Products & shoppability

Make videos shoppable by tagging store products on them.

Tool	What it does
`search_products`	Find a store product by title to get its product id.
`tag_video_product`	Tag (or untag) products on a video — tagged videos feed product-tagged playlists and show on those products’ pages.

Stores

Tool	What it does
`list_stores`	List the connected stores on your account. Widget, product, and ads tools can target any of them.

Paid ads

Read-only insight and creative upload for Meta ads — no tool moves ad spend.

Tool	What it does
`list_ad_campaigns`	List your Meta ad campaigns with real delivery status (not just paused/active).
`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 or spend is created.

Example: make a video shoppable end to end

“Make my unboxing video shoppable for the DBTK 1 shirt, put it in a Stories widget, publish it, and show me how my ads are doing.”

search_assets → find the unboxing video.
search_products → find DBTK 1’s product id.
tag_video_product → tag the product on the video.
create_widget → a Stories widget (starts as a draft).
get_widget with the product id → confirm the video shows on that product’s page.
update_widget with live: true → publish, then follow the returned app-embed steps.
get_ads_performance → check spend and ROAS.

Home

MCP

JavaScript SDK

Tolstoy Library

Media assets

Shoppable widgets

Products & shoppability

Stores

Paid ads

Example: make a video shoppable end to end

​Media assets

​Shoppable widgets

​Products & shoppability

​Stores

​Paid ads

​Example: make a video shoppable end to end

Media assets

Shoppable widgets

Products & shoppability

Stores

Paid ads

Example: make a video shoppable end to end