# Renderball

> Designed, animated, editable presentations your AI writes on Renderball. No account needed to try.

- name: com.renderball/renderball
- version: 1.1.0
- connection class: R0 (autonomous)
- trust: 92/100
- quality: 73/100 (needs work)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.renderball%2Frenderball
- tools: https://api.protogrid.dev/v1/servers/com.renderball%2Frenderball/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "renderball": {
      "type": "http",
      "url": "https://renderball.com/api/mcp"
    }
  }
}
```


## Trust

- hygiene: 100
- liveness: 97
- freshness: 85
- provenance: 85
- drivers: +repository +dns-namespace +website +reachable +uptime-92% ~updated-34d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 73/100 (needs work)

### protocol: 88 (weight 25)

- pass `protocol.modern`: supports 2026-07-28 (server/discover)
- pass `protocol.stateless`: answers without a session
- pass `protocol.transport`: streamable HTTP
- warn `protocol.list_ttl`: tools/list declares ttlMs 0, so clients re-fetch it on every use

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 86 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 13 of 13 tools declare readOnlyHint or destructiveHint
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: submit_deck (idempotentHint); get_examples (idempotentHint); submit_page (idempotentHint); …
- pass `tools.token_cost`: about 4,378 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 25 (weight 15)

- warn `stability.changes`: 50 tool changes in 30 days
- fail `stability.rug_pull`: 2 tools kept their name but changed most of their description in 30 days; review before trusting them

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 13, about 4,378 tokens to load them all
- tool set hash: 4de13f3b3e72b2ceb6e8c32e1f555106
- tools last changed: 2026-10-16T09:28:13.753Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.renderball/renderball.svg)](https://protogrid.dev/servers/com.renderball/renderball)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-16 `create_deck` changed (inputSchema)
- 2026-10-14 `create_deck` changed (inputSchema)
- 2026-10-12 `edit_page` changed (inputSchema)
- 2026-10-12 `read_page` changed (inputSchema)
- 2026-10-12 `submit_page` changed (inputSchema)
- 2026-10-12 `get_examples` changed (inputSchema)
- 2026-10-12 `get_page_brief` changed (inputSchema)
- 2026-10-12 `share_deck` changed (inputSchema)
- 2026-10-12 `deck_status` changed (inputSchema)
- 2026-10-12 `submit_deck` changed (inputSchema)

Full history: https://api.protogrid.dev/v1/servers/com.renderball%2Frenderball/changes

## Remotes

- https://renderball.com/api/mcp (streamable-http, auth none, reachable true, uptime30d 0.9166667)

## Packages

_none_

## Tools (13)

- `create_deck`: 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.
- `deck_status`: Whether a submitted deck is still importing, ready (with the editor link and the rendered pages, to check them), or failed (with the reason).
- `edit_page`: 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.
- `get_brief`: The writing brief for a deck whose outline is already saved.
- `get_examples`: 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.
- `get_page_brief`: 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.
- `list_decks`: 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.
- `read_page`: 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").
- `see_deck`: 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.
- `share_deck`: Turn on the public link for a deck and return it: anyone with the link can view the deck.
- `submit_deck`: 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.
- `submit_page`: 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.
- `write_outline`: 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.