Tolstoy

Genera videos e imágenes de marketing y gestiona tu biblioteca de medios desde cualquier cliente de IA — para marcas de comercio electrónico nativas de IA.

GitHubPrueba este MCPPatrocinado

Documentación

Tolstoy MCP

Conecta cualquier cliente MCP — Claude, ChatGPT, Cursor, Gemini y más — a Tolstoy, la plataforma agéntica para marcas de comercio electrónico nativas de IA. Gestiona tu espacio de trabajo de video comprable directamente desde el chat: genera contenido de marketing, administra tu biblioteca de medios, crea y publica widgets comprables, explora tu catálogo, etiqueta productos y realiza seguimiento del rendimiento de anuncios.

Tolstoy expone sus servidores MCP remotos a través de HTTP Streamable. El servidor principal de Tolstoy está protegido con OAuth 2.1 + PKCE — sin necesidad de pegar claves API, tu cliente ejecuta el inicio de sesión OAuth en la primera conexión. Shopper es un servidor público separado de marketplace, sin autenticación.

Servidor	Endpoint	Qué hace
Tolstoy	`https://apilb.gotolstoy.com/mcp/v1/mcp`	Tu espacio de trabajo completo de video comprable: genera e itera sobre videos e imágenes de marketing, administra tu biblioteca de medios, crea y publica widgets comprables, explora tu catálogo de productos, etiqueta productos y revisa el rendimiento de anuncios de Meta.
Tolstoy Library	`https://apilb.gotolstoy.com/mcp/v1/library/mcp`	Medios existentes, etiquetas de productos, catálogo y widgets comprables. Esta conexión limitada no expone la generación de Studio ni las herramientas de anuncios pagados.
Tolstoy Shopper	`https://apilb.gotolstoy.com/mcp/v1/shopper/mcp`	Compra en todas las tiendas de marcas en Tolstoy: búsqueda de productos en todo el marketplace, detalles completos de productos y prueba virtual. Público, sin inicio de sesión.

Comienza con un producto

Sigue la guía del primer flujo de trabajo para confirmar tu espacio de trabajo, encontrar videos existentes para un producto y revisar su ubicación comprable actual. Incluye rutas de configuración separadas para Cursor y Claude Library, ejemplos de prompts y pasos de recuperación. El plugin de Cursor también incluye la habilidad tolstoy-product-media para este flujo de trabajo.

Para informes, integraciones faltantes o problemas de transferencia de archivos, usa la guía de informes y recuperación. Explica qué IDs de conexión y widget acepta cada herramienta de informes, cómo recuperar una conexión faltante de Meta Ads y cómo subir archivos a través del navegador.

Herramientas

El servidor principal de Tolstoy expone las siguientes herramientas.

Studio — generación de contenido

generate_studio_content — inicia una nueva generación de Studio (imagen o video) a partir de un prompt.
iterate_studio_content — continúa y refina una generación existente de Studio en la misma sesión.
get_studio_session — verifica el estado y recupera el medio finalizado de una generación.
list_studio_folders — lista tus proyectos y carpetas de Studio.
list_studio_chats — lista los chats dentro de un proyecto o carpeta de Studio.

Biblioteca de medios

list_assets — lista tus activos de biblioteca más recientes (videos, imágenes, borradores de IA).
search_assets — busca en la biblioteca por nombre o identificador del creador.
get_asset — obtén detalles completos de un activo, incluidos productos etiquetados y listas de reproducción.
update_asset — renombra un activo o alterna su estado de favorito.

Widgets comprables

list_widgets — lista tus widgets de video comprable en el sitio (Stories, Carousel, Spotlight, For You Feed, Tile, Collection Grid, Bubble Feed), en vivo o en borrador.
get_widget — inspecciona un widget: tipo, estado en vivo, selección de contenido y los videos reales que muestra (por producto para widgets comprables en modo PDP).
create_widget — crea un nuevo widget comprable a partir de una plantilla, con los valores predeterminados de la plataforma.
update_widget — renombra, publica/despublica, configura el modo PDP o cambia la selección de contenido de un widget.

Productos y catálogo

list_collections — lista las colecciones del catálogo de una tienda conectada.
search_products — encuentra productos de la tienda por título o consulta.
browse_products — explora productos y colecciones del catálogo de una tienda conectada.
tag_video_product — etiqueta (o desetiqueta) productos en un video para que sea comprable en listas de reproducción etiquetadas con productos y widgets PDP.

Tiendas

list_stores — lista las tiendas conectadas en tu cuenta; las herramientas de widgets, catálogo y productos pueden apuntar a cualquiera de ellas.

Anuncios pagados

list_ad_campaigns — lista tus campañas de anuncios de Meta con estado de entrega real (effectiveStatus que dice la verdad).
get_ads_performance — rendimiento bruto de Meta, incluidos gasto, CTR, acciones y valores de acción, por campaña, conjunto de anuncios o anuncio. Confirma el evento de conversión del comerciante antes de calcular el ROAS; no sumes diferentes tipos de acciones.
publish_to_meta_ads_library — envía un video o imagen de la biblioteca a Meta Ads Manager, listo para la creación de anuncios (sin campaña, sin gasto).

Informes de widgets de IA

list_ai_widgets — encuentra widgets creados con el AI Widget Builder.
get_ai_widget_analytics — lee las métricas guardadas de un widget de IA. Acepta un widgetId de list_ai_widgets; el publishId de un widget de video de tienda de list_widgets no funciona aquí.

Shopper (servidor público separado de marketplace — sin autenticación)

search_products — busca productos en todas las tiendas de marcas en Tolstoy, un catálogo único en todo el marketplace.
get_product — detalles completos del producto: descripción, variantes, precio, medios, videos de la marca y enlaces de compra/carrito.
try_on — abre una prueba virtual interactiva de un producto (marcas participantes); el comprador sube una foto y se ve usando el artículo real.

Los clientes con capacidad de aplicación (ChatGPT, Claude) también obtienen vistas interactivas — una cuadrícula de tarjetas de widgets comprables y vistas previas de activos — renderizadas en línea en el chat.

Conectar

En tu cliente MCP, agrega un conector personalizado / servidor MCP remoto.
Pega el endpoint de Tolstoy (o Shopper) anterior.
Inicia sesión con tu cuenta de Tolstoy cuando se te solicite (OAuth). Shopper no requiere inicio de sesión.

La configuración por cliente (Claude, ChatGPT, Cursor, Gemini CLI, Codex, Perplexity, Goose, Cherry Studio y más) está disponible en la plataforma de Tolstoy en Configuración → MCP.

Plugin de Cursor Marketplace

Este repositorio incluye un manifiesto de plugin de Cursor en .cursor-plugin/plugin.json. Instala el repositorio como plugin local durante el desarrollo, o instala Tolstoy desde Cursor Marketplace después de que la publicación sea aprobada. El plugin agrega el servidor de espacio de trabajo de Tolstoy protegido con OAuth. El servidor público Tolstoy Shopper sigue disponible a través del endpoint y la configuración del cliente documentados anteriormente.

Ejemplo de configuración de cliente

{
  "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 apunta a servidores STDIO, así que agrega el servidor remoto a ~/.codex/config.toml y ejecuta el inicio de sesión OAuth:

[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

Autenticación

OAuth 2.1 con PKCE, respaldado por Amazon Cognito. Descubrimiento mediante metadatos de recursos protegidos RFC 9728 en los endpoints /.well-known del servidor. Cada conexión está vinculada al espacio de trabajo de Tolstoy que autorizas. Shopper es un servidor público de marketplace y no requiere autenticación.

Privacidad, términos y soporte

Política de privacidad
Términos de uso
Soporte: support@gotolstoy.com
Resumen de seguridad: gotolstoy.com/security

Registro

Publicado en el Registro MCP oficial:

io.github.GoTolstoy/studio — el servidor principal de Tolstoy
io.github.GoTolstoy/shopper

El server.json para cada uno está en registry/.

Acerca de

Tolstoy es la plataforma agéntica para marcas de comercio electrónico nativas de IA, que impulsa video comprable para miles de tiendas — https://www.gotolstoy.com