Renderball is an MCP server published by com.renderball, hosted at renderball.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 13 tools, including list_decks, create_deck, write_outline, get_brief, see_deck.
Designed, animated, editable presentations your AI writes on Renderball. No account needed to try.
Nothing else in the archive shares these values.
Inferred from the host name and headers: what a server runs on, not who runs it.
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 parameters.
{
"name": "list_decks",
"title": "List my decks",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List my decks",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| Parameter | 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 … |
| 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. |
{
"name": "create_deck",
"title": "Create a deck",
"description": "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.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Create a deck",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| tone | string | The register, e.g. 'confident, technical, CTO-to-CTO'. |
| pages * | array | |
| deck_id * | string |
{
"name": "write_outline",
"title": "Write the outline",
"description": "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.",
"inputSchema": {
"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
}
}
},
"annotations": {
"title": "Write the outline",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}The writing brief for a deck whose outline is already saved.
| Parameter | Type | Description |
|---|---|---|
| deck_id * | string |
{
"name": "get_brief",
"title": "Get the writing brief",
"description": "The writing brief for a deck whose outline is already saved.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"deck_id"
],
"properties": {
"deck_id": {
"type": "string",
"maxLength": 40,
"minLength": 10
}
}
},
"annotations": {
"title": "Get the writing brief",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| deck_id * | string |
{
"name": "see_deck",
"title": "See the rendered pages",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"deck_id"
],
"properties": {
"deck_id": {
"type": "string",
"maxLength": 40,
"minLength": 10
}
}
},
"annotations": {
"title": "See the rendered pages",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | 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. |
{
"name": "submit_deck",
"title": "Submit the deck file",
"description": "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.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Submit the deck file",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Whether a submitted deck is still importing, ready (with the editor link and the rendered pages, to check them), or failed (with the reason).
| Parameter | Type | Description |
|---|---|---|
| deck_id * | string |
{
"name": "deck_status",
"title": "Check an import",
"description": "Whether a submitted deck is still importing, ready (with the editor link and the rendered pages, to check them), or failed (with the reason).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"deck_id"
],
"properties": {
"deck_id": {
"type": "string",
"maxLength": 40,
"minLength": 10
}
}
},
"annotations": {
"title": "Check an import",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Turn on the public link for a deck and return it: anyone with the link can view the deck.
| Parameter | Type | Description |
|---|---|---|
| deck_id * | string |
{
"name": "share_deck",
"title": "Share a deck",
"description": "Turn on the public link for a deck and return it: anyone with the link can view the deck.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"deck_id"
],
"properties": {
"deck_id": {
"type": "string",
"maxLength": 40,
"minLength": 10
}
}
},
"annotations": {
"title": "Share a deck",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| page * | integer | Which page, 1 first. Page 1 must be saved before any other page's brief. |
| deck_id * | string |
{
"name": "get_page_brief",
"title": "Get one page's brief",
"description": "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.",
"inputSchema": {
"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
}
}
},
"annotations": {
"title": "Get one page's brief",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| ids * | array | Up to 4 example ids from the page brief's list, e.g. ["L3", "R12"]. |
| deck_id * | string |
{
"name": "get_examples",
"title": "Read example pages",
"description": "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.",
"inputSchema": {
"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
}
}
},
"annotations": {
"title": "Read example pages",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | 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. |
| 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). |
{
"name": "submit_page",
"title": "Submit one page",
"description": "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.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Submit one page",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}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").
| Parameter | 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. |
{
"name": "read_page",
"title": "Read one page",
"description": "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\").",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Read one page",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | 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'. |
{
"name": "edit_page",
"title": "Change part of a page",
"description": "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.",
"inputSchema": {
"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'."
}
}
},
"annotations": {
"title": "Change part of a page",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Renderball turns a deck you write into a designed, animated, editable presentation the user can finish in the Renderball editor and share. Write it the way the studio's own writer does, ONE PAGE AT A TIME: (1) create_deck with the user's brief, the brand (if you can open the brand's website, read its real colours and fonts there and declare them; always give the website; never invent a colour) AND your outline, one entry per page — the reply carries PAGE 1'S BRIEF with example pages chosen for it. (2) Study the examples, follow THE STUDIO'S METHOD, write page 1 (the file with Section0 and the deck's whole design system) and send it with submit_page with its direction (one sentence: the thing, the motion that acts out the claim, one craft detail). (3) Each submit_page reply carries the next page's brief and its examples: do the same for every page, with your full attention on each; a page is accepted only after its brief was handed to you. Where you can run helpers in parallel, a helper gets its page's full brief with get_page_brief and sends next_brief false. (4) When the last page is saved the deck is merged, checked and rendered: the reply carries the RENDERED PAGES as images and fix_these when our checks found something. Fix every item, and look at every page for overlapping or clipped text, odd spacing, an element off its page, or a picture that does not say the page's claim; resubmit just the pages you change with submit_page. (5) Give the user the editor link (editor_url). submit_deck takes a whole file only to replace a deck whose pages are all written. Every call needs the user's Renderball API key (Authorization: Bearer rb_live_…); without one, the reply says how the user gets one: tell them. Never invent facts, figures or quotes: the deck's truth check flags anything not in the brief. Ask the user for missing numbers instead of guessing.
Names, descriptions and schemas were written by the server and are shown as data.