MostlyRender

Server MCP (agenti IA)

Consenti a un agente IA — Claude Desktop, Claude Code, Cursor, o qualsiasi client Model Context Protocol — di renderizzare immagini e PDF dai tuoi template, e di catturare screenshot di URL live, come tool call. È la stessa API REST che chiameresti tu stesso, esposta come tool degli agenti.

C’è un server MCP Mostly Tiny (mostlytiny-mcp). Puoi eseguirlo in due modi — limitato solo a MostlyRender, o connesso al tuo intero account Mostly Tiny. Entrambi espongono gli stessi tool di MostlyRender; scegli in base a quanta parte del toolkit vuoi.

# Consigliato — solo MostlyRender (una chiave API)

Esegui il server con una singola chiave MostlyRender ed espone solo i tool di render — una piccola superficie di tool focalizzata, che è quella che gli agenti più spesso scelgono. Crea una chiave in Settings → API keys (mr_live_… o mr_test_…), quindi:

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" }
    }
  }
}

Usa una chiave mr_test_… mentre stai configurando — i render di test non toccano il tuo utilizzo live.

# L’intero toolkit — ospitato, sign-in (senza chiave)

Usi più di un prodotto? Aggiungi il server ospitato per URL e accedi con il tuo account Mostly Tiny nel browser (OAuth 2.1 — nessuna chiave API da gestire). Ottieni i tool di ogni prodotto live contemporaneamente: renderizza un’immagine e crea un codice QR, genera un’informativa sulla privacy, aggiungi una mappa — da un’unica installazione.

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

In entrambi i casi, il tool sempre disponibile mostlytiny_catalog consente a un agente di scoprire il resto del portfolio (e come attivare un prodotto) — così puoi iniziare con MostlyRender e crescere nel toolkit senza reinstallare nulla.

# Tool di MostlyRender

Tool Cosa fa
mostlyrender_list_templates Elenca i tuoi template (id, name, dimensione, motore). Chiama questo per primo — ogni nome di livello è un parametro di render.
mostlyrender_render Renderizza un template in PNG / JPEG / WebP / PDF → URL di asset pubblico. Sostituisce i livelli per nome.
mostlyrender_render_batch Renderizza molte varianti di un template in un’unica chiamata.
mostlyrender_screenshot Cattura qualsiasi URL pubblico come immagine o PDF.
mostlyrender_render_by_url Renderizza al volo via URL firmato (immagini OG, tag <img>).
mostlyrender_get_render Verifica lo stato di un render asincrono e ottieni il suo URL risultato.
mostlyrender_get_account Restituisce il piano dell’account connesso, l’utilizzo e l’email.

# Un tipico flusso agente

L’agente scopre un template, vede che i suoi livelli sono denominati title, subtitle e badge, quindi lo renderizza — senza intervento umano:

text
Tu:    Crea un'immagine di lancio dal titolo "We raised our Series A".
Agente: → mostlyrender_list_templates   → tpl_launch (livelli: 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

Poiché il nome del livello è il parametro, un agente può introspezionare un template e riempirlo correttamente senza nulla di cablato. Vedi Templates as parameters.

# Autenticazione

Il server limitato si autentica con la tua chiave API — la stessa chiave usata da REST API e SDKs; il server ospitato usa invece il tuo account Mostly Tiny connesso. I render effettuati da un agente vengono fatturati esattamente come qualsiasi altro render: per utilizzo, mai bloccati.

Variabile Obbligatoria Predefinita
MOSTLYRENDER_API_KEY sì (modalità limitata) —
MOSTLYRENDER_BASE_URL no https://api.mostlyrender.com