Servidor MCP (agentes de IA)

Deixe um agente de IA — Claude Desktop, Claude Code, Cursor ou qualquer cliente Model Context Protocol — renderizar imagens e PDFs de seus templates, e fazer captura de tela de URLs ao vivo, como chamadas de ferramentas. É a mesma API REST que você chamaria você mesmo, exposta como ferramentas de agentes.

Há um servidor MCP Mostly Tiny (mostlytiny-mcp). Você pode executá-lo de duas maneiras — escopo apenas para MostlyRender, ou conectado à sua conta Mostly Tiny inteira. Ambos expõem as mesmas ferramentas de MostlyRender; escolha quanto do toolkit você deseja.

# Recomendado — apenas MostlyRender (uma chave API)

Execute o servidor com uma única chave MostlyRender e ele expõe apenas as ferramentas de renderização — uma superfície de ferramenta pequena e focada, que é o que agentes escolhem com mais confiabilidade. Crie uma chave em Settings → API keys (mr_live_… ou mr_test_…), depois:

Claude Code:

bash

claude mcp add mostly-tiny --env MOSTLYRENDER_API_KEY=mr_live_xxx -- npx -y mostlytiny-mcp

Claude Desktop / Cursor (claude_desktop_config.json · .cursor/mcp.json):

json

{
  "mcpServers": {
    "mostly-tiny": {
      "command": "npx",
      "args": ["-y", "mostlytiny-mcp"],
      "env": { "MOSTLYRENDER_API_KEY": "mr_live_xxx" }
    }
  }
}

Use uma chave mr_test_… durante a configuração — renderizações de teste não afetam seu uso ao vivo.

# O toolkit inteiro — hospedado, conexão (sem chave)

Usando mais de um produto? Adicione o servidor hospedado por URL e conecte-se à sua conta Mostly Tiny no navegador (OAuth 2.1 — sem chave API para gerenciar). Você obtém as ferramentas de todos os produtos ao vivo de uma vez: renderize uma imagem e crie um código QR, gere uma política de privacidade, adicione um mapa — a partir de uma única instalação.

bash

claude mcp add --transport http mostly-tiny https://mcp.mostlytiny.io

De qualquer forma, a ferramenta mostlytiny_catalog sempre ativa permite que um agente descubra o resto do portfólio (e como ativar um produto) — para que você possa começar com MostlyRender e crescer para o toolkit sem reinstalar nada.

# Ferramentas MostlyRender

Ferramenta	O que faz
`mostlyrender_list_templates`	Liste seus templates (`id`, `name`, tamanho, engine). Chame isto primeiro — cada nome de camada é um parâmetro de renderização.
`mostlyrender_render`	Renderize um template para PNG / JPEG / WebP / PDF → URL de ativo público. Substitui camadas por nome.
`mostlyrender_render_batch`	Renderize muitas variações de um template em uma única chamada.
`mostlyrender_screenshot`	Capture qualquer URL pública como uma imagem ou PDF.
`mostlyrender_render_by_url`	Renderize sob demanda via uma URL assinada (imagens OG, tags `<img>`).
`mostlyrender_get_render`	Verifique o status de uma renderização assíncrona e obtenha sua URL de resultado.
`mostlyrender_get_account`	Retorne o plano, uso e e-mail da conta conectada.

# Um fluxo típico de agente

O agente descobre um template, vê que suas camadas são nomeadas title, subtitle e badge, depois o renderiza — sem necessidade de intervenção humana:

text

Você:   Faça uma imagem de lançamento intitulada "We raised our Series A".
Agente: → mostlyrender_list_templates   → tpl_launch (camadas: title, subtitle, badge)
        → mostlyrender_render            { template: "tpl_launch",
                                           modifications: { title: "We raised our Series A",
                                                            badge: "News" } }
        ← https://img.mostlyrender.com/r/rnd_9f3a.png

Como o nome da camada é o parâmetro, um agente pode introspectar um template e preenchê-lo corretamente sem nada configurado. Veja Templates as parameters.

# Autenticação

O servidor com escopo autentica com sua chave API — a mesma chave que a REST API e SDKs usam; o servidor hospedado usa sua conta Mostly Tiny conectada em vez disso. As renderizações feitas por um agente são cobradas exatamente como qualquer outra renderização: por uso, nunca bloqueadas.

Variável	Obrigatório	Padrão
`MOSTLYRENDER_API_KEY`	sim (modo com escopo)	—
`MOSTLYRENDER_BASE_URL`	não	`https://api.mostlyrender.com`