putty
MCPMediaMedia

media_vectorize_logo

Turn a generated logo raster into an SVG so it stays sharp at every size a brand kit is used at — a favicon, a 512×512 token logo, a print run. Pass the asset id of a `completed` image the caller owns (one from `media_generate_image` with `kind: "logo"`, or any uploaded mark); another user's asset is a plain not-found. The source is left untouched and the SVG comes back as a new tracked asset, so a poor trace costs one job and not the original. Returns immediately with a `queued` asset id and the work runs on the media queue; `media_status` gives the signed URL once it completes. Refuses a source that is not a logo, and refuses source images asking for a real brand's mark.

Turn a generated logo raster into an SVG so it stays sharp at every size a brand kit is used at — a favicon, a 512×512 token logo, a print run.

Input

The tool takes a single JSON object. Every field, its type, and an example are on the generated reference at GET /mcp/tools, under this tool's name.

Calling it

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": { "name": "media_vectorize_logo", "arguments": {} }
}

Put your arguments in place of the empty object. A call that fails comes back as a normal result carrying isError: true and a message naming what went wrong, not as a JSON-RPC protocol error.

Notes

Pass the asset id of a completed image the caller owns (one from media_generate_image with kind: "logo", or any uploaded mark); another user's asset is a plain not-found. The source is left untouched and the SVG comes back as a new tracked asset, so a poor trace costs one job and not the original. Returns immediately with a queued asset id and the work runs on the media queue; media_status gives the signed URL once it completes. Refuses a source that is not a logo, and refuses source images asking for a real brand's mark.

The full request and response shape, and a live playground, live on the generated reference at GET /mcp/tools.

media_compose_graphic

Compose a graphic that has WORDS on it: render one of the four committed HTML layouts to PNG in a sandbox with headless Chromium, in the brand kit's real palette, fonts, and type scale. Use this for an Open Graph card (`og`, 1200×630), an X header (`x-header`, 1500×500), a square post (`post-square`, 1080×1080), or a portrait post (`post-portrait`, 1080×1350) — anything where misspelled text would be visible. Image models garble text, so a card with copy is never generated as an image; generate a text-free `background` with `media_generate_image` and pass its asset id as `backgroundAssetId`, or omit it to use the brand's background colour. Returns immediately with a signed URL into Putty's own storage; the provider's URL is never exposed. Costs 0 credits — the background, if you want one, is charged to its own asset.

media_brand_pack

Build a whole marketing pack from a brand kit as one tracked job: a favicon set, an Open Graph card (1200×630), an X header (1500×500), a profile picture, a 512×512 token logo, and three launch-post images. Every output that has WORDS on it is composed from the kit's real HTML layout in a sandbox, and every text-free one is generated. Returns one entry per output with its asset id; composed cards come back `completed` with a signed URL, generated images come back `queued` and are polled with `media_status`. Pass `include` to take a subset, and `projectId` to attach the assets to a project. The promo `video` is deliberately excluded unless you ask for it by name, and asking for it returns `needs_confirmation` with the cost and submits nothing — call again without `video` to build the rest. Refuses a kit that impersonates a real brand. No third-party URL is ever returned: everything lands in Putty's own storage.

On this page