Tolstoy

Gere vídeos e imagens de marketing e gerencie sua biblioteca de mídia a partir de qualquer cliente de IA — para marcas de ecommerce nativas em IA.

GitHubExperimente este MCPPatrocinado

Documentação

Tolstoy MCP

Conecte qualquer cliente MCP — Claude, ChatGPT, Cursor, Gemini e outros — ao Tolstoy, a plataforma agêntica para marcas de ecommerce nativas de IA. Execute seu espaço de trabalho de vídeo comprável diretamente do chat: gere conteúdo de marketing, gerencie sua biblioteca de mídia, crie e publique widgets compráveis, navegue pelo seu catálogo, marque produtos e acompanhe o desempenho de anúncios.

O Tolstoy expõe seus servidores MCP remotos via Streamable HTTP. O servidor principal Tolstoy é protegido com OAuth 2.1 + PKCE — sem necessidade de colar chaves de API, seu cliente executa o login OAuth na primeira conexão. Shopper é um servidor público separado, sem autenticação, para o marketplace.

Servidor	Endpoint	O que faz
Tolstoy	`https://apilb.gotolstoy.com/mcp/v1/mcp`	Seu espaço de trabalho completo de vídeo comprável — gere e itere vídeos e imagens de marketing, gerencie sua biblioteca de mídia, crie e publique widgets compráveis, navegue pelo seu catálogo de produtos, marque produtos e revise o desempenho de anúncios no Meta.
Tolstoy Library	`https://apilb.gotolstoy.com/mcp/v1/library/mcp`	Mídia existente, tags de produtos, catálogo e widgets compráveis. Esta conexão com escopo restrito não expõe a geração do Studio nem as ferramentas de anúncios pagos.
Tolstoy Shopper	`https://apilb.gotolstoy.com/mcp/v1/shopper/mcp`	Compre em todas as lojas de marcas no Tolstoy — busca de produtos em todo o marketplace, detalhes completos dos produtos e experimentação virtual. Público, sem login.

Comece com um produto

Siga o guia do primeiro fluxo de trabalho para confirmar seu espaço de trabalho, encontrar vídeos existentes para um produto e revisar sua colocação comprável atual. Ele inclui caminhos de configuração separados para Cursor e Claude Library, exemplos de prompts e etapas de recuperação. O plugin do Cursor também inclui a habilidade tolstoy-product-media para este fluxo de trabalho.

Para relatórios, integrações ausentes ou problemas de transferência de arquivos, use o guia de relatórios e recuperação. Ele explica quais IDs de conexão e widget cada ferramenta de relatório aceita, como recuperar uma conexão ausente do Meta Ads e como fazer upload pelo navegador.

Ferramentas

O servidor principal Tolstoy expõe as seguintes ferramentas.

Studio — geração de conteúdo

generate_studio_content — inicia uma nova geração no Studio (imagem ou vídeo) a partir de um prompt.
iterate_studio_content — continua e refina uma geração existente do Studio na mesma sessão.
get_studio_session — verifica o status e recupera a mídia finalizada de uma geração.
list_studio_folders — lista seus projetos e pastas do Studio.
list_studio_chats — lista os chats dentro de um projeto ou pasta do Studio.

Biblioteca de mídia

list_assets — lista seus ativos de biblioteca mais recentes (vídeos, imagens, rascunhos de IA).
search_assets — busca na biblioteca por nome ou handle do criador.
get_asset — busca detalhes completos de um ativo, incluindo produtos marcados e playlists.
update_asset — renomeia um ativo ou alterna seu status de favorito.

Widgets compráveis

list_widgets — lista seus widgets de vídeo comprável no site (Stories, Carousel, Spotlight, For You Feed, Tile, Collection Grid, Bubble Feed), ao vivo ou rascunho.
get_widget — inspeciona um widget: tipo, status ao vivo, seleção de conteúdo e os vídeos reais que ele exibe (por produto para widgets compráveis em modo PDP).
create_widget — cria um novo widget comprável a partir de um modelo, com os padrões da plataforma.
update_widget — renomeia, publica/despublica, define o modo PDP ou altera a seleção de conteúdo de um widget.

Produtos e catálogo

list_collections — lista as coleções do catálogo de uma loja conectada.
search_products — encontra produtos da loja por título ou consulta.
browse_products — navega pelos produtos e coleções do catálogo de uma loja conectada.
tag_video_product — marca (ou desmarca) produtos em um vídeo para que ele se torne comprável em playlists com tags de produto e widgets PDP.

Lojas

list_stores — lista as lojas conectadas na sua conta; as ferramentas de widget, catálogo e produto podem direcionar qualquer uma delas.

Anúncios pagos

list_ad_campaigns — lista suas campanhas de anúncios no Meta com status real de entrega (effectiveStatus dizendo a verdade).
get_ads_performance — desempenho bruto do Meta, incluindo gastos, CTR, ações e valores de ação, por campanha, conjunto de anúncios ou anúncio. Confirme o evento de conversão do comerciante antes de calcular o ROAS; não some diferentes tipos de ação.
publish_to_meta_ads_library — envia um vídeo ou imagem da biblioteca para o Meta Ads Manager, pronto para criação de anúncio (sem campanha, sem gastos).

Relatórios de widgets de IA

list_ai_widgets — encontra widgets criados com o AI Widget Builder.
get_ai_widget_analytics — lê as métricas salvas de um widget de IA. Ele aceita um widgetId de list_ai_widgets; o publishId de um widget de vídeo de loja de list_widgets não funciona aqui.

Shopper (servidor público separado do marketplace — sem autenticação)

search_products — busca produtos em todas as lojas de marcas no Tolstoy, um catálogo único para todo o marketplace.
get_product — detalhes completos do produto: descrição, variações, preço, mídia, vídeos da marca e links de compra/carrinho.
try_on — abre uma experimentação virtual interativa de um produto (marcas participantes); o comprador envia uma foto e se vê vestindo o item real.

Clientes com suporte a apps (ChatGPT, Claude) também recebem visualizações interativas — uma grade de cards de widgets compráveis e prévias de ativos — renderizadas inline no chat.

Conectar

No seu cliente MCP, adicione um conector personalizado / servidor MCP remoto.
Cole o endpoint do Tolstoy (ou Shopper) acima.
Faça login com sua conta Tolstoy quando solicitado (OAuth). O Shopper não exige login.

A configuração por cliente (Claude, ChatGPT, Cursor, Gemini CLI, Codex, Perplexity, Goose, Cherry Studio e outros) está disponível na plataforma Tolstoy em Configurações → MCP.

Plugin do Cursor Marketplace

Este repositório inclui um manifesto de plugin do Cursor em .cursor-plugin/plugin.json. Instale o repositório como um plugin local durante o desenvolvimento, ou instale o Tolstoy pelo Cursor Marketplace após a listagem ser aprovada. O plugin adiciona o servidor do espaço de trabalho Tolstoy protegido por OAuth. O servidor público Tolstoy Shopper permanece disponível pelo endpoint e configuração de cliente documentados acima.

Exemplo de configuração 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 tem como alvo servidores STDIO, então adicione o servidor remoto ao ~/.codex/config.toml e execute o login 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

Autenticação

OAuth 2.1 com PKCE, com suporte do Amazon Cognito. Descoberta via metadados de recurso protegido RFC 9728 nos endpoints /.well-known do servidor. Cada conexão está vinculada ao espaço de trabalho Tolstoy que você autorizar. Shopper é um servidor público de marketplace e não requer autenticação.

Privacidade, termos e suporte

Política de privacidade
Termos de uso
Suporte: support@gotolstoy.com
Visão geral de segurança: gotolstoy.com/security

Registro

Publicado no MCP Registry oficial:

io.github.GoTolstoy/studio — o servidor principal do Tolstoy
io.github.GoTolstoy/shopper

O server.json para cada um está em registry/.

Sobre

Tolstoy é a plataforma agêntica para marcas de ecommerce nativas de IA, impulsionando vídeo comprável para milhares de lojas — https://www.gotolstoy.com