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
| 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. |
| 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.
