MCP-server (AI-agenten)

Laat een AI-agent — Claude Desktop, Claude Code, Cursor, of elke andere Model Context Protocol-client — afbeeldingen en PDF’s van je templates renderen, en live URL’s screenshotten, als tool-aanroepen. Het is dezelfde REST API die je zelf zou aanroepen, blootgesteld als agent-tools.

Er is één Mostly Tiny MCP-server (mostlytiny-mcp). Je kunt hem op twee manieren uitvoeren — beperkt tot alleen MostlyRender, of ingelogd op je hele Mostly Tiny-account. Beide stellen dezelfde MostlyRender-tools beschikbaar; kies wat je van de toolkit wilt gebruiken.

# Aanbevolen — alleen MostlyRender (één API-sleutel)

Voer de server uit met een enkele MostlyRender-sleutel en hij stelt alleen de render-tools beschikbaar — een klein, gericht tool-oppervlak, dat agents het meest betrouwbaar kiezen. Maak een sleutel aan in Settings → API keys (mr_live_… of mr_test_…), en voer dan uit:

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

Gebruik een mr_test_…-sleutel terwijl je bezig bent met instellen — test-renders raken je live-gebruik niet aan.

# De hele toolkit — gehost, inloggen (geen sleutel)

Gebruik je meer dan één product? Voeg de gehoste server toe via URL en log in met je Mostly Tiny-account in de browser (OAuth 2.1 — geen API-sleutel om te beheren). Je krijgt de tools van elk live product tegelijk: render een afbeelding en maak een QR-code, genereer een privacybeleid, voeg een kaart toe — vanuit één installatie.

bash

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

Hoe dan ook, de altijd beschikbare mostlytiny_catalog-tool laat een agent de rest van de portfolio ontdekken (en hoe je een product inschakelt) — zodat je kunt beginnen met MostlyRender en in de toolkit groeien zonder opnieuw te installeren.

# MostlyRender-tools

Tool	Wat het doet
`mostlyrender_list_templates`	Lijst je templates op (`id`, `name`, grootte, engine). Roep dit eerst aan — elke laagnaam is een render-parameter.
`mostlyrender_render`	Render een template naar PNG / JPEG / WebP / PDF → openbare asset-URL. Overschrijf lagen op naam.
`mostlyrender_render_batch`	Render veel variaties van één template in één aanroep.
`mostlyrender_screenshot`	Vang een openbare URL vast als afbeelding of PDF.
`mostlyrender_render_by_url`	Render-on-the-fly via een ondertekende URL (OG-afbeeldingen, `<img>`-tags).
`mostlyrender_get_render`	Controleer de status van een async render en krijg zijn resultaat-URL.
`mostlyrender_get_account`	Geef de verbonden account’s plan, gebruik en e-mail terug.

# Een typische agent-workflow

De agent ontdekt een template, ziet dat de lagen title, subtitle en badge heten, en rendert het dan — geen menselijk ingrijpen:

text

Jij:   Maak een launch-afbeelding met de titel "We hebben onze Series A opgehaald".
Agent: → mostlyrender_list_templates   → tpl_launch (layers: title, subtitle, badge)
       → mostlyrender_render            { template: "tpl_launch",
                                          modifications: { title: "We hebben onze Series A opgehaald",
                                                           badge: "Nieuws" } }
       ← https://img.mostlyrender.com/r/rnd_9f3a.png

Omdat de laagnaam is de parameter, kan een agent een template introspectie en deze correct invullen zonder dat iets is ingesteld. Zie Templates as parameters.

# Verificatie

De beperkte server verifieert zich met je API-sleutel — dezelfde sleutel die de REST API en SDK’s gebruiken; de gehoste server gebruikt je ingelogde Mostly Tiny-account in plaats daarvan. Renders gemaakt door een agent worden gefactureerd net als elke andere render: per gebruik, nooit geblokkeerd.

Variabele	Vereist	Standaard
`MOSTLYRENDER_API_KEY`	ja (beperkte modus)	—
`MOSTLYRENDER_BASE_URL`	nee	`https://api.mostlyrender.com`