media_asset_list
List the assets you own, newest first, optionally filtered to one project or one stored file kind. Returns each asset's id, kind, status, credit cost, and — for completed assets — a short-lived signed URL into Putty's own storage. Use it to find an asset id for `media_edit_image`, `media_generate_video`, or `media_vectorize_logo`, to see what a marketing pack produced, or to check how much a project has spent on media. Only the caller's own assets are ever returned; a project id belonging to another user yields an empty list, and an asset id belonging to another user is a plain not-found in the tools that take one.
List the assets you own, newest first, optionally filtered to one project or one stored file kind. Returns each asset's id, kind, status, credit cost, and — for completed assets — a short-lived signed URL into Putty's own storage.
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_asset_list", "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
Use it to find an asset id for media_edit_image, media_generate_video, or media_vectorize_logo, to see what a marketing pack produced, or to check how much a project has spent on media. Only the caller's own assets are ever returned; a project id belonging to another user yields an empty list, and an asset id belonging to another user is a plain not-found in the tools that take one.
The full request and response shape, and a live playground, live on the generated reference at GET /mcp/tools.
media_status
Check on one asset you own: what state it is in, what it cost, and — once it is `completed` — a short-lived signed URL to the file in Putty's own storage. Poll this after `media_generate_image`, `media_edit_image`, `media_generate_video`, or `media_compose_graphic`. The URL is always one Putty signed: generated files are copied into our bucket before the asset completes, and a third-party provider URL is never returned to a user. Omit `url` and read `status` as `queued` or `in_progress` and wait a few seconds; on `failed` or `rejected`, `failureReason` says why and the job is terminal. An asset id belonging to another user is reported as a plain not-found.
Privy
Thirteen tools over the caller's own Privy user, wallets, wallet actions, and transactions.