Designed, animated, editable presentations your AI writes on Renderball. No account needed to try.
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Start a new presentation from a brief, the brand and your outline. The brand: if you can open the brand's website, read its real colours and fonts there first and declare them — the lead colour is usually the main buttons and the large coloured areas, not the link colour — and always give the website; never invent a colour. With the outline the reply carries PAGE 1'S BRIEF; write page 1 and send it with submit_page — each reply carries the next page's brief.
What the deck is for, who it is for, what it should argue and ask. Real facts only; the truth check refuses invented figures.
The page size, any you need: "wide" 1920×1080 (slides, the default), "square" 1080×1080 (a post), "vertical" 1080×1920 (a story, a poster, a menu), or any width × height in px written "1200x628" (each side 100 to 4096): a link card 1200x628, a portrait post 1080x1350, an A4-shaped page 1240x1754, a banner 1500x500. Pick the size the person asked for: never draw a page turned sideways to fake another size.
The brand as YOU know it: name, and only the colours, fonts and logo you actually have. Never guess a colour; leave it out.
How many pages you intend to write (default 5). Ignored when `outline` is given.
Your page-by-page outline (one entry per page: label, description, visual_concept, content with a headline). Send it here and the reply carries the brief to write from (page 1's brief when the deck is written page by page) — one call instead of create_deck + write_outline.
Key holders only: a website Renderball reads for colours, fonts and logo when no brand is declared.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Start a new presentation from a brief, the brand and your outline. The brand: if you can open the brand's website, read its real colours and fonts there first and declare them — the lead colour is usually the main buttons and the large coloured areas, not the link colour — and always give the website; never invent a colour. With the outline the reply carries PAGE 1'S BRIEF; write page 1 and send it with submit_page — each reply carries the next page's brief.
| Argument | Type | Description |
|---|---|---|
| size | string | The page size, any you need: "wide" 1920×1080 (slides, the default), "square" 1080×1080 (a post), "vertical" 1080×1920 (a story, a poster, a menu), or any width × height in px written "1200x628" (each side 100 to 4096): a link card 1200x628, a portrait post 1080x1350, an A4-shaped page 1240x1754, a banner 1500x500. Pick the size the person asked for: never draw a page turned sideways to fake another size. |
| brand | object | The brand as YOU know it: name, and only the colours, fonts and logo you actually have. Never guess a colour; leave it out. |
| brief* | string | What the deck is for, who it is for, what it should argue and ask. Real facts only; the truth check refuses invented figures. |
| pages | integer | How many pages you intend to write (default 5). Ignored when `outline` is given. |
| outline | object | Your page-by-page outline (one entry per page: label, description, visual_concept, content with a headline). Send it here and the reply carries the brief to write from (page 1's brief when the deck is written page by page) — one call instead of create_deck + write_outline. |
| brand_url | string | Key holders only: a website Renderball reads for colours, fonts and logo when no brand is declared. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"brief"
],
"properties": {
"size": {
"type": "string",
"maxLength": 24,
"description": "The page size, any you need: \"wide\" 1920×1080 (slides, the default), \"square\" 1080×1080 (a post), \"vertical\" 1080×1920 (a story, a poster, a menu), or any width × height in px written \"1200x628\" (each side 100 to 4096): a link card 1200x628, a portrait post 1080x1350, an A4-shaped page 1240x1754, a banner 1500x500. Pick the size the person asked for: never draw a page turned sideways to fake another size."
},
"brand": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 60,
"minLength": 1,
"description": "The brand's name as it should appear."
},
"text": {
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$",
"description": "The main text colour, only if known."
},
"fonts": {
"type": "object",
"properties": {
"body": {
"type": "string",
"maxLength": 60,
"description": "Body font family name, only if known."
},
"headline": {
"type": "string",
"maxLength": 60,
"description": "Headline font family name, only if known."
}
}
},
"voice": {
"type": "string",
"maxLength": 300,
"description": "How the brand speaks, in a sentence or two."
},
"accent": {
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$",
"description": "The lead brand colour (usually the main buttons and the large coloured areas, not the links), only if you know it from the user, their material or their site. Never invent one."
},
"website": {
"type": "string",
"maxLength": 200,
"description": "Their website, e.g. yourcompany.com. With an account, when you declare no colours, Renderball reads the site for its colours, fonts and logo — so give the website and leave colours you do not know out."
},
"logo_url": {
"type": "string",
"format": "uri",
"maxLength": 500,
"description": "A public https image of the logo (SVG or PNG), only if you have a real one."
},
"background": {
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$",
"description": "The page background colour, only if known."
}
},
"description": "The brand as YOU know it: name, and only the colours, fonts and logo you actually have. Never guess a colour; leave it out."
},
"brief": {
"type": "string",
"maxLength": 6000,
"minLength": 20,
"description": "What the deck is for, who it is for, what it should argue and ask. Real facts only; the truth check refuses invented figures."
},
"pages": {
"type": "integer",
"maximum": 16,
"minimum": 1,
"description": "How many pages you intend to write (default 5). Ignored when `outline` is given."
},
"outline": {
"type": "object",
"required": [
"pages"
],
"properties": {
"tone": {
"type": "string",
"maxLength": 300,
"description": "The register, e.g. 'confident, technical, CTO-to-CTO'."
},
"pages": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"description",
"visual_concept",
"content"
],
"properties": {
"label": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Short page title, 2-6 words (e.g. 'The Tracker Tax')."
},
"content": {
"type": "object",
"required": [
"headline"
],
"properties": {
"cta": {
"type": "object",
"required": [
"primary"
],
"properties": {
"primary": {
"type": "string",
"maxLength": 60
},
"secondary": {
"type": "string",
"maxLength": 80
}
}
},
"lede": {
"type": "string",
"maxLength": 400,
"description": "Supporting sentence or two."
},
"meta": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"value"
],
"properties": {
"label": {
"type": "string",
"maxLength": 60
},
"value": {
"type": "string",
"maxLength": 60
}
}
},
"maxItems": 6,
"description": "Stat tiles as label/value pairs — ONLY figures the user gave you."
},
"bullets": {
"type": "array",
"items": {
"type": "string",
"maxLength": 160
},
"maxItems": 6,
"description": "Up to 6 short points; no walls."
},
"caption": {
"type": "string",
"maxLength": 200,
"description": "Small mono caption, e.g. a source line."
},
"eyebrow": {
"type": "string",
"maxLength": 60,
"description": "Tiny label above the headline, e.g. 'THE PROBLEM'."
},
"headline": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "The one strong display line."
}
},
"description": "The approved copy. Every numeral here must come from the user's material — the deck's truth check enforces it."
},
"description": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What this page must accomplish in the argument, one or two sentences. Not shown on the page."
},
"visual_concept": {
"type": "string",
"maxLength": 1200,
"minLength": 1,
"description": "The composition and the one graphic device that expresses the page's argument: layout, the diagram/chart/mock, where the headline sits, colours by role. Concrete enough to draw from."
}
}
},
"maxItems": 16,
"minItems": 1
}
},
"description": "Your page-by-page outline (one entry per page: label, description, visual_concept, content with a headline). Send it here and the reply carries the brief to write from (page 1's brief when the deck is written page by page) — one call instead of create_deck + write_outline."
},
"brand_url": {
"type": "string",
"maxLength": 300,
"description": "Key holders only: a website Renderball reads for colours, fonts and logo when no brand is declared."
}
}
}Whether a submitted deck is still importing, ready (with the editor link and the rendered pages, to check them), or failed (with the reason).
| Argument | Type | Description |
|---|---|---|
| deck_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"deck_id"
],
"properties": {
"deck_id": {
"type": "string",
"maxLength": 40,
"minLength": 10
}
}
}Change part of a design that already exists, the way you edit a file: each edit replaces exact text from read_page (it must appear exactly once) with new text. Use it for any change the person asks for in an existing design — a headline, a colour, a picture, moving or removing something — instead of sending the whole page again: everything you do not touch stays as it is, the person's own edits included, and they see the change in their editor at once and can undo it. One page per call, or shared: true for the code every page shares. A refused edit changes nothing and says why. The reply shows the page as it looks now.
| Argument | Type | Description |
|---|---|---|
| page | integer | Which page to change, 1 first. Leave out only with shared: true. |
| edits* | array | Applied in order, all or nothing. |
| shared | boolean | true: the edits are to the code every page shares (palette, fonts, helpers), as read_page shows it. Only when the person asks to change the whole design. |
| deck_id* | string | |
| page_id | string | The page_id read_page gave for this page. If the person moved pages since, the edit is refused instead of landing on another page. |
| summary | string | What you changed, in a few plain words the person sees in their editor, e.g. 'Shortened the headline'. |
The writing brief for a deck whose outline is already saved.
| Argument | Type | Description |
|---|---|---|
| deck_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"deck_id"
],
"properties": {
"deck_id": {
"type": "string",
"maxLength": 40,
"minLength": 10
}
}
}Up to 4 of the studio's example pages, by the ids listed in a page brief — read the ones that fit the page you are about to write.
| Argument | Type | Description |
|---|---|---|
| ids* | array | Up to 4 example ids from the page brief's list, e.g. ["L3", "R12"]. |
| deck_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"deck_id",
"ids"
],
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 4
},
"maxItems": 4,
"minItems": 1,
"description": "Up to 4 example ids from the page brief's list, e.g. [\"L3\", \"R12\"]."
},
"deck_id": {
"type": "string",
"maxLength": 40,
"minLength": 10
}
}
}The full writing brief for ONE page: the studio's method, the rules, the examples chosen for that page, and (after page 1) page 1's file to continue. You rarely need it: page 1's brief comes with create_deck and each submit_page reply carries the next page's. Use it for a helper that writes one page with nothing in front of it.
| Argument | Type | Description |
|---|---|---|
| page* | integer | Which page, 1 first. Page 1 must be saved before any other page's brief. |
| deck_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"deck_id",
"page"
],
"properties": {
"page": {
"type": "integer",
"maximum": 16,
"minimum": 1,
"description": "Which page, 1 first. Page 1 must be saved before any other page's brief."
},
"deck_id": {
"type": "string",
"maxLength": 40,
"minLength": 10
}
}
}The user's Renderball documents, newest first, with editor links. Needs an account (a key). The design open in the person's editor right now comes first, marked open_now.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}Read one page of a design as it is NOW — the code the person's editor shows, including their own edits — before changing it. Use it whenever the person asks to change something in a design that already exists: their editor may hold edits you have not seen. The reply carries the page's code, the code every page shares (palette, fonts, helpers), the page's element ids and, when the person has the design open, the element they selected ("this").
| Argument | Type | Description |
|---|---|---|
| page* | integer | Which page, 1 first. |
| deck_id* | string | |
| with_shared | boolean | Default true: also return the code every page shares (palette, fonts, helpers). Send false when you already have it in this conversation. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"deck_id",
"page"
],
"properties": {
"page": {
"type": "integer",
"maximum": 16,
"minimum": 1,
"description": "Which page, 1 first."
},
"deck_id": {
"type": "string",
"maxLength": 40,
"minLength": 10
},
"with_shared": {
"type": "boolean",
"description": "Default true: also return the code every page shares (palette, fonts, helpers). Send false when you already have it in this conversation."
}
}
}The deck's rendered pages as images, page 1 first — look at them for overlapping or clipped text, odd spacing, an element off its page or a picture that does not say its page's claim, then fix that page and submit_page it again. Available once the deck has been rendered.
| Argument | Type | Description |
|---|---|---|
| deck_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"deck_id"
],
"properties": {
"deck_id": {
"type": "string",
"maxLength": 40,
"minLength": 10
}
}
}Turn on the public link for a deck and return it: anyone with the link can view the deck.
| Argument | Type | Description |
|---|---|---|
| deck_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"deck_id"
],
"properties": {
"deck_id": {
"type": "string",
"maxLength": 40,
"minLength": 10
}
}
}Replace the whole file of a deck whose pages are all written (while pages are still being written, submit_page each one — a whole file is refused then). Renderball checks it against the brief, renders every page and opens it in the editor. Returns 'ready' with the editor_url, or 'importing' — then poll deck_status.
| Argument | Type | Description |
|---|---|---|
| label | string | Who wrote it, e.g. 'claude-code'. Shown in the deck's trace. |
| source* | string | The complete deck file, exactly as the writing brief specifies. Raw file or a ```tsx fenced block. |
| deck_id* | string | |
| wait_seconds | integer | How long to wait for the import before returning (default 25). Use deck_status to keep checking. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"deck_id",
"source"
],
"properties": {
"label": {
"type": "string",
"maxLength": 40,
"description": "Who wrote it, e.g. 'claude-code'. Shown in the deck's trace."
},
"source": {
"type": "string",
"maxLength": 600000,
"minLength": 1500,
"description": "The complete deck file, exactly as the writing brief specifies. Raw file or a ```tsx fenced block."
},
"deck_id": {
"type": "string",
"maxLength": 40,
"minLength": 10
},
"wait_seconds": {
"type": "integer",
"maximum": 60,
"minimum": 0,
"description": "How long to wait for the import before returning (default 25). Use deck_status to keep checking."
}
}
}Save one page you wrote (page 1: the file with Section0 and the shared design; page N: only its Section), with its direction (one sentence: the thing, the motion that acts out the claim, one craft detail). A page is accepted only after its brief was handed to you. The reply carries the next page's brief; when every page is saved the deck is merged, checked and rendered and the reply carries the rendered pages. To rewrite one page of a finished design, submit just that page: it replaces that page only, and everything else stays as it is, the person's own edits included. To change part of a page, read_page and edit_page are lighter.
| Argument | Type | Description |
|---|---|---|
| page* | integer | |
| label | string | Who wrote it, e.g. 'claude-code'. Shown in the deck's trace. |
| source* | string | Page 1: the file with Section0 and every shared constant, helper and chrome. Page N: ONLY `export const Section{N-1}`. Raw code or a ```tsx fenced block. |
| deck_id* | string | |
| page_id | string | Rewriting a page of a finished design: the page_id read_page gave. If the person moved pages since, it is refused instead of replacing another page. |
| direction* | string | This page's direction in one sentence — the thing, the motion that acts out the claim, one craft detail. It goes into the page as its // Direction: line. |
Save a new page-by-page outline for a deck (pages written for the old one are dropped). The reply carries PAGE 1'S BRIEF; each submit_page reply carries the next page's.
| Argument | Type | Description |
|---|---|---|
| tone | string | The register, e.g. 'confident, technical, CTO-to-CTO'. |
| pages* | array | |
| deck_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"deck_id",
"pages"
],
"properties": {
"tone": {
"type": "string",
"maxLength": 300,
"description": "The register, e.g. 'confident, technical, CTO-to-CTO'."
},
"pages": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"description",
"visual_concept",
"content"
],
"properties": {
"label": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Short page title, 2-6 words (e.g. 'The Tracker Tax')."
},
"content": {
"type": "object",
"required": [
"headline"
],
"properties": {
"cta": {
"type": "object",
"required": [
"primary"
],
"properties": {
"primary": {
"type": "string",
"maxLength": 60
},
"secondary": {
"type": "string",
"maxLength": 80
}
}
},
"lede": {
"type": "string",
"maxLength": 400,
"description": "Supporting sentence or two."
},
"meta": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"value"
],
"properties": {
"label": {
"type": "string",
"maxLength": 60
},
"value": {
"type": "string",
"maxLength": 60
}
}
},
"maxItems": 6,
"description": "Stat tiles as label/value pairs — ONLY figures the user gave you."
},
"bullets": {
"type": "array",
"items": {
"type": "string",
"maxLength": 160
},
"maxItems": 6,
"description": "Up to 6 short points; no walls."
},
"caption": {
"type": "string",
"maxLength": 200,
"description": "Small mono caption, e.g. a source line."
},
"eyebrow": {
"type": "string",
"maxLength": 60,
"description": "Tiny label above the headline, e.g. 'THE PROBLEM'."
},
"headline": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "The one strong display line."
}
},
"description": "The approved copy. Every numeral here must come from the user's material — the deck's truth check enforces it."
},
"description": {
"type": "string",
"maxLength": 600,
"minLength": 1,
"description": "What this page must accomplish in the argument, one or two sentences. Not shown on the page."
},
"visual_concept": {
"type": "string",
"maxLength": 1200,
"minLength": 1,
"description": "The composition and the one graphic device that expresses the page's argument: layout, the diagram/chart/mock, where the headline sits, colours by role. Concrete enough to draw from."
}
}
},
"maxItems": 16,
"minItems": 1
},
"deck_id": {
"type": "string",
"maxLength": 40,
"minLength": 10
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"deck_id",
"edits"
],
"properties": {
"page": {
"type": "integer",
"maximum": 16,
"minimum": 1,
"description": "Which page to change, 1 first. Leave out only with shared: true."
},
"edits": {
"type": "array",
"items": {
"type": "object",
"required": [
"find",
"replace"
],
"properties": {
"find": {
"type": "string",
"maxLength": 20000,
"minLength": 1,
"description": "Exact text copied from read_page, character for character; it must appear exactly once."
},
"replace": {
"type": "string",
"maxLength": 40000,
"description": "What to put in its place; empty deletes it."
}
}
},
"maxItems": 30,
"minItems": 1,
"description": "Applied in order, all or nothing."
},
"shared": {
"type": "boolean",
"description": "true: the edits are to the code every page shares (palette, fonts, helpers), as read_page shows it. Only when the person asks to change the whole design."
},
"deck_id": {
"type": "string",
"maxLength": 40,
"minLength": 10
},
"page_id": {
"type": "string",
"maxLength": 80,
"description": "The page_id read_page gave for this page. If the person moved pages since, the edit is refused instead of landing on another page."
},
"summary": {
"type": "string",
"maxLength": 120,
"description": "What you changed, in a few plain words the person sees in their editor, e.g. 'Shortened the headline'."
}
}
}| next_brief | boolean | Default true: the reply carries the next page's brief. A helper writing just one page sends false. |
| wait_seconds | integer | When this page completes the deck: how long to wait for the import (default 25). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"deck_id",
"page",
"source",
"direction"
],
"properties": {
"page": {
"type": "integer",
"maximum": 16,
"minimum": 1
},
"label": {
"type": "string",
"maxLength": 40,
"description": "Who wrote it, e.g. 'claude-code'. Shown in the deck's trace."
},
"source": {
"type": "string",
"maxLength": 200000,
"minLength": 200,
"description": "Page 1: the file with Section0 and every shared constant, helper and chrome. Page N: ONLY `export const Section{N-1}`. Raw code or a ```tsx fenced block."
},
"deck_id": {
"type": "string",
"maxLength": 40,
"minLength": 10
},
"page_id": {
"type": "string",
"maxLength": 80,
"description": "Rewriting a page of a finished design: the page_id read_page gave. If the person moved pages since, it is refused instead of replacing another page."
},
"direction": {
"type": "string",
"maxLength": 400,
"minLength": 15,
"description": "This page's direction in one sentence — the thing, the motion that acts out the claim, one craft detail. It goes into the page as its // Direction: line."
},
"next_brief": {
"type": "boolean",
"description": "Default true: the reply carries the next page's brief. A helper writing just one page sends false."
},
"wait_seconds": {
"type": "integer",
"maximum": 60,
"minimum": 0,
"description": "When this page completes the deck: how long to wait for the import (default 25)."
}
}
}