Magnific

User plan + credits. Check before paid generations. Returns plan.{tier,productName,isUnlimitedMode}, credits.{available,totalPlan,spent,hasExtraCredits}. No history.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Long-poll 1..8 creations until terminal or `timeoutSeconds` (default 25, max 25). In-progress entries get `poll_after_seconds` for the next call.

{
  "type": "object",
  "properties": {
    "identifiers": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "timeoutSeconds": {
      "type": "number"
    }
  },
  "required": [
    "identifiers"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Single creation complete data — metadata + URLs (`url` full-res, `previewUrl` ~1024px, `thumbnailUrl` ~400px).

{
  "type": "object",
  "properties": {
    "creationIdentifier": {
      "type": "string"
    }
  },
  "required": [
    "creationIdentifier"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Search user creations as raw TOON text. Use `creations_get` for one id. `reference` required with from=folder/project-root. Defaults: history, page 1.

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "enum": [
        "history",
        "folder",
        "project-root",
        "all-assets",
        "favorites",
        "downloads",
        "trash",
        "upload",
        "v3-upload",
        "v3-favorites",
        "v3-trash"
      ]
    },
    "reference": {
      "type": "string"
    },
    "query": {
      "type": "string"
    },
    "page": {
      "type": "number"
    },
    "folderReference": {
      "type": "string"
    },
    "fileType": {
      "type": "string",
      "enum": [
        "image",
        "video",
        "audio"
      ]
    },
    "toolNames": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "excludeToolNames": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Filterable gallery widget (image/video/audio). Use instead of `creations_search` when user wants to browse their library.

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "enum": [
        "history",
        "folder",
        "project-root",
        "all-assets",
        "favorites",
        "downloads",
        "trash",
        "upload",
        "v3-upload",
        "v3-favorites",
        "v3-trash"
      ]
    },
    "reference": {
      "type": "string"
    },
    "query": {
      "type": "string"
    },
    "fileType": {
      "type": "string",
      "enum": [
        "image",
        "video",
        "audio"
      ]
    },
    "toolNames": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Step 1 for local/user files: get presigned PUT URL(s). Upload bytes outside MCP, then call `creations_finalize_upload`.

{
  "type": "object",
  "properties": {
    "mimeType": {
      "type": "string",
      "enum": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "video/mp4",
        "video/quicktime",
        "video/webm",
        "video/x-m4v"
      ]
    },
    "count": {
      "type": "number"
    }
  },
  "required": [
    "mimeType"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Step 2 after PUT from `creations_request_upload`: convert temp path(s) to creations. Images <=25MB, videos <=200MB.

{
  "type": "object",
  "properties": {
    "path": {
      "type": "string"
    },
    "uploads": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "path": {
            "type": "string"
          }
        },
        "required": [
          "path"
        ]
      }
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Upload public image URL in one step. For local/user files use `creations_request_upload` then `creations_finalize_upload`.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Import a file the user attached in the host (e.g. a ChatGPT upload) as a creation, then use the returned identifier in image tools. Use this instead of asking for a URL when the user already uploaded a local file. For a public URL use `creations_upload_image`.

{
  "type": "object",
  "properties": {
    "file": {
      "type": "object",
      "properties": {
        "download_url": {
          "type": "string"
        },
        "file_id": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        }
      },
      "required": [
        "download_url",
        "file_id"
      ]
    }
  },
  "required": [
    "file"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Move creations into `targetFolderReference`. Identifiers from `images_generate`/`creations_search`. Foreign identifier → abort. Target folder must belong to user.

{
  "type": "object",
  "properties": {
    "targetFolderReference": {
      "type": "string"
    },
    "creationIdentifiers": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "targetFolderReference",
    "creationIdentifiers"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Toggle heart/favorite reaction on a user-owned creation.

{
  "type": "object",
  "properties": {
    "creationIdentifier": {
      "type": "string"
    },
    "folderReference": {
      "type": "string"
    },
    "unlike": {
      "type": "boolean"
    }
  },
  "required": [
    "creationIdentifier",
    "folderReference"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Add a comment (or reply) to a user-owned creation.

{
  "type": "object",
  "properties": {
    "creationIdentifier": {
      "type": "string"
    },
    "folderReference": {
      "type": "string"
    },
    "text": {
      "type": "string"
    },
    "replyToCommentId": {
      "type": "string"
    }
  },
  "required": [
    "creationIdentifier",
    "folderReference",
    "text"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List folders/projects as raw TOON text. No params=top level; `onlyProjects`=projects; `parentReference`=children. Refs work with creations/folder tools.

{
  "type": "object",
  "properties": {
    "parentReference": {
      "type": "string"
    },
    "onlyProjects": {
      "type": "boolean"
    },
    "page": {
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Fetch folder metadata by `reference`. Use before `creations_search` (`from=folder`). Foreign refs error.

{
  "type": "object",
  "properties": {
    "reference": {
      "type": "string"
    }
  },
  "required": [
    "reference"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Create folder/project. No `parentReference`: workspace root. `type` defaults: project at root, folder when nested.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "parentReference": {
      "type": "string"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Rename a folder by `reference`.

{
  "type": "object",
  "properties": {
    "reference": {
      "type": "string"
    },
    "name": {
      "type": "string"
    }
  },
  "required": [
    "reference",
    "name"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Move a folder and its files to trash.

{
  "type": "object",
  "properties": {
    "reference": {
      "type": "string"
    }
  },
  "required": [
    "reference"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

English markdown status report for a project/folder. Last 7 days default, max 30.

{
  "type": "object",
  "properties": {
    "reference": {
      "type": "string"
    },
    "days": {
      "type": "number"
    }
  },
  "required": [
    "reference"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Lean spaces catalog as raw TOON text. Share each `webUrl`; call `spaces_show` only for inline canvas preview. Do not use `creations_search`.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "ownership": {
      "type": "string",
      "enum": [
        "all",
        "mine",
        "shared"
      ]
    },
    "page": {
      "type": "number"
    },
    "perPage": {
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Create empty Space. Share `space.webUrl`; only call `spaces_show` when inline preview is requested.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "description": {
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Read-only board context, raw TOON. Default: current page + pageIndex (other pages, counts). pageId: another page on demand. scope=all: whole board (costly). selectedElementIds: selected nodes. Needs view perm.

{
  "type": "object",
  "properties": {
    "spaceId": {
      "type": "string"
    },
    "selectedElementIds": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "selectedConnectionIds": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "currentPageId": {
      "type": "string"
    },
    "pageId": {
      "type": "string"
    },
    "scope": {
      "type": "string"
    }
  },
  "required": [
    "spaceId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Read-only. Like `spaces_state` but scoped to `nodeIds` + their connections. Cheaper than full board. Needs view perm.

{
  "type": "object",
  "properties": {
    "spaceId": {
      "type": "string"
    },
    "nodeIds": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "currentPageId": {
      "type": "string"
    }
  },
  "required": [
    "spaceId",
    "nodeIds"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Run Space workflow from `startNodeId`. Modes: singular, connected default, downstream. Poll with `spaces_run_status`.

{
  "type": "object",
  "properties": {
    "spaceId": {
      "type": "string"
    },
    "startNodeId": {
      "type": "string"
    },
    "mode": {
      "type": "string",
      "enum": [
        "singular",
        "connected",
        "downstream"
      ]
    }
  },
  "required": [
    "spaceId",
    "startNodeId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Poll `spaces_run`. `timeoutSeconds` long-polls up to 25s. In-progress returns `poll_after_seconds`; terminal call `creations_show`.

{
  "type": "object",
  "properties": {
    "workflowRunIdentifier": {
      "type": "string"
    },
    "timeoutSeconds": {
      "type": "number"
    }
  },
  "required": [
    "workflowRunIdentifier"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

External MCP only. Start headless Space edit. Poll `spaces_edit_status` until allTerminal, then verify with `spaces_state`.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "spaceId": {
      "type": "string"
    },
    "threadId": {
      "type": "string"
    },
    "selectedElementIds": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "selectedConnectionIds": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "anchorElementId": {
      "type": "string"
    },
    "anchorDirection": {
      "type": "string",
      "enum": [
        "left",
        "right",
        "up",
        "down"
      ]
    }
  },
  "required": [
    "query",
    "spaceId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Wait for `spaces_edit` like `creations_wait`: long-polls up to `timeoutSeconds` (default 25, max 25). Snapshot-only when 0. Terminal → `spaces_state`.

{
  "type": "object",
  "properties": {
    "operationId": {
      "type": "string"
    },
    "threadId": {
      "type": "string"
    },
    "runId": {
      "type": "string"
    },
    "timeoutSeconds": {
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Generate/edit images. No refs=TTI. references[] (max 12; see field docs). Defaults: mode=auto, ratio=1:1, count<=8. resolution/quality per images_models_list. UI clients: after generating, MUST call `creations_show` with all identifiers; never stop at links.

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string"
    },
    "mode": {
      "type": "string"
    },
    "aspectRatio": {
      "type": "string",
      "enum": [
        "1:1",
        "21:9",
        "16:9",
        "9:16",
        "2:3",
        "3:4",
        "1:2",
        "2:1",
        "5:4",
        "4:5",
        "3:2",
        "4:3"
      ]
    },
    "references": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "image",
              "style",
              "character",
              "product",
              "locations"
            ]
          },
          "identifier": {
            "type": "string"
          }
        },
        "required": [
          "type",
          "identifier"
        ]
      }
    },
    "count": {
      "type": "number"
    },
    "resolution": {
      "type": "string"
    },
    "quality": {
      "type": "string"
    },
    "folderReference": {
      "type": "string"
    }
  },
  "required": [
    "prompt"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Cut-out subject on transparent PNG. Color BG: `images_color_background`. AI scene: `images_generate` with reference + prompt "replace the background with X".

{
  "type": "object",
  "properties": {
    "creationIdentifier": {
      "type": "string"
    },
    "folderReference": {
      "type": "string"
    }
  },
  "required": [
    "creationIdentifier"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

AI upscale 2x/4x (Magnific, premium). Exact pixels: `images_resize`. Aspect: `images_crop`. Default scale=2.

{
  "type": "object",
  "properties": {
    "creationIdentifier": {
      "type": "string"
    },
    "scale": {
      "type": "string",
      "enum": [
        "2x",
        "4x"
      ]
    },
    "folderReference": {
      "type": "string"
    }
  },
  "required": [
    "creationIdentifier"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

AI skin enhancer. faithful preserves identity; creative reinterprets; flexible uses presets. Defaults: faithful, sharpen=0, smartGrain=0.

{
  "type": "object",
  "properties": {
    "creationIdentifier": {
      "type": "string"
    },
    "version": {
      "type": "string",
      "enum": [
        "faithful",
        "creative",
        "flexible"
      ]
    },
    "sharpen": {
      "type": "number"
    },
    "smartGrain": {
      "type": "number"
    },
    "skinDetail": {
      "type": "number"
    },
    "optimizedFor": {
      "type": "string",
      "enum": [
        "enhance_skin",
        "enhance_everything",
        "improve_lighting",
        "transform_to_real",
        "no_make_up"
      ]
    },
    "folderReference": {
      "type": "string"
    }
  },
  "required": [
    "creationIdentifier"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

AI relight. 1-4 lights with azimuth/elevation enums, type neutral|gel, intensity 1-10. Gel uses hex `color`.

{
  "type": "object",
  "properties": {
    "creationIdentifier": {
      "type": "string"
    },
    "lights": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "azimuth": {
            "type": "number"
          },
          "elevation": {
            "type": "number"
          },
          "type": {
            "type": "string",
            "enum": [
              "neutral",
              "gel"
            ]
          },
          "color": {
            "type": "string"
          },
          "intensity": {
            "type": "number"
          }
        },
        "required": [
          "azimuth",
          "elevation"
        ]
      }
    },
    "resolution": {
      "type": "string",
      "enum": [
        "1k",
        "2k"
      ]
    },
    "numImages": {
      "type": "number"
    },
    "folderReference": {
      "type": "string"
    }
  },
  "required": [
    "creationIdentifier",
    "lights"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Reframe camera around subject. Defaults: rotate=45, vertical=0, closeup=5.

{
  "type": "object",
  "properties": {
    "creationIdentifier": {
      "type": "string"
    },
    "rotate": {
      "type": "number"
    },
    "vertical": {
      "type": "number"
    },
    "closeup": {
      "type": "number"
    },
    "folderReference": {
      "type": "string"
    }
  },
  "required": [
    "creationIdentifier"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Generate image-variation grid. Modes: angles|demographics|expressions|age|storyboard|custom. Defaults: angles, 3x3, 1:1, 4k.

{
  "type": "object",
  "properties": {
    "creationIdentifier": {
      "type": "string"
    },
    "variationMode": {
      "type": "string",
      "enum": [
        "angles",
        "demographics",
        "expressions",
        "age",
        "storyboard",
        "custom"
      ]
    },
    "prompt": {
      "type": "string"
    },
    "gridRows": {
      "type": "number"
    },
    "gridCols": {
      "type": "number"
    },
    "aspectRatio": {
      "type": "string",
      "enum": [
        "1:1",
        "21:9",
        "16:9",
        "9:16",
        "4:3",
        "4:5",
        "5:4",
        "3:4",
        "3:2",
        "2:3"
      ]
    },
    "resolution": {
      "type": "string",
      "enum": [
        "2k",
        "4k"
      ]
    },
    "selectedAngles": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "selectedEthnicities": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "selectedGenders": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "male",
          "female"
        ]
      }
    },
    "folderReference": {
      "type": "string"
    }
  },
  "required": [
    "creationIdentifier"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Center-crop to `aspectRatio`. Pixels: `images_resize`. AI upscale: `images_upscale`. Ratios: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9.

{
  "type": "object",
  "properties": {
    "creationIdentifier": {
      "type": "string"
    },
    "aspectRatio": {
      "type": "string",
      "enum": [
        "1:1",
        "16:9",
        "9:16",
        "4:3",
        "3:4",
        "3:2",
        "2:3",
        "21:9"
      ]
    },
    "folderReference": {
      "type": "string"
    }
  },
  "required": [
    "creationIdentifier",
    "aspectRatio"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Resize to exact pixels (no AI). For real detail upscaling: `images_upscale` first. Aspect: `images_crop`. Dimensions snap to multiples of 8; center-crop on aspect mismatch.

{
  "type": "object",
  "properties": {
    "creationIdentifier": {
      "type": "string"
    },
    "width": {
      "type": "number"
    },
    "height": {
      "type": "number"
    },
    "folderReference": {
      "type": "string"
    }
  },
  "required": [
    "creationIdentifier",
    "width",
    "height"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Trace raster creation into SVG. New vector from prompt: `images_generate_svg`.

{
  "type": "object",
  "properties": {
    "creationIdentifier": {
      "type": "string"
    },
    "folderReference": {
      "type": "string"
    }
  },
  "required": [
    "creationIdentifier"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Text-to-SVG (Recraft v4 Pro Vector). Raster: `images_generate`. Trace existing raster: `images_to_svg`. Default aspectRatio=1:1.

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string"
    },
    "aspectRatio": {
      "type": "string",
      "enum": [
        "1:1",
        "2:1",
        "1:2",
        "3:2",
        "2:3",
        "4:3",
        "3:4",
        "5:4",
        "4:5",
        "16:9",
        "9:16"
      ]
    },
    "folderReference": {
      "type": "string"
    }
  },
  "required": [
    "prompt"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

TTI model catalog as lean TOON text. `search` filters by name, slug, description, or tags.

{
  "type": "object",
  "properties": {
    "search": {
      "type": "string"
    },
    "onlyRecommended": {
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Lean library catalog (characters, styles, elements, locations) for agent reasoning. Picker assets use library://.

{
  "type": "object",
  "properties": {
    "scope": {
      "type": "string",
      "enum": [
        "all",
        "projects",
        "organization"
      ]
    },
    "type": {
      "type": "string",
      "enum": [
        "character",
        "style",
        "element",
        "locations"
      ]
    },
    "page": {
      "type": "number"
    },
    "perPage": {
      "type": "number"
    },
    "search": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Create a reusable library asset (character/product/location) from 1-6 images. Use the returned numeric `id` in generation refs (same id Spaces uses). No LoRA training.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "type": {
      "type": "string",
      "enum": [
        "character",
        "product",
        "locations"
      ]
    },
    "description": {
      "type": "string"
    },
    "gender": {
      "type": "string"
    },
    "productType": {
      "type": "string"
    },
    "images": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "creationIdentifier": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        }
      }
    }
  },
  "required": [
    "name",
    "type",
    "images"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Image-to-3D GLB. Upload external images first. Animate with `models3d_rig`. Models: tripo-p1 default, tripo-v31, trellis-2.

{
  "type": "object",
  "properties": {
    "creationIdentifier": {
      "type": "string"
    },
    "model": {
      "type": "string",
      "enum": [
        "tripo-p1",
        "tripo-v31",
        "trellis-2"
      ]
    },
    "resolution": {
      "type": "number"
    },
    "textureQuality": {
      "type": "string",
      "enum": [
        "none",
        "standard",
        "detailed"
      ]
    },
    "faceLimit": {
      "type": "number"
    },
    "folderReference": {
      "type": "string"
    }
  },
  "required": [
    "creationIdentifier"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Call FIRST for any video request. Returns markdown plan: brief, open questions, characters to prepare, recommended model slug, prompt draft. Videos >15s: plan splits into clips + `video_concatenate` instructions.

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string"
    },
    "durationHint": {
      "type": "number"
    },
    "styleHint": {
      "type": "string"
    },
    "aspectRatioHint": {
      "type": "string"
    },
    "referenceIdentifiers": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "prompt"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Generate video. External clients: call `video_plan` first to draft the brief and resolve model choice — skip only if the user explicitly says "just generate" or "one-shot". Pick a model with `slug` (copy it verbatim from `video_models_list`); omit `slug` for auto-select. Image refs: use an asset URL or a creation `identifier`; never `webUrl`. Limits: `video_models_list`. On UI-capable clients, after generating you MUST call `creations_show` once with all returned identifiers to render results; never stop at links.

{
  "type": "object",
  "properties": {
    "video": {
      "type": "object",
      "properties": {
        "clips": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "position": {
                "type": "number"
              },
              "duration": {
                "type": "number"
              },
              "slug": {
                "type": "string"
              },
              "prompt": {
                "type": "string"
              },
              "aspectRatio": {
                "type": "string"
              },
              "resolution": {
                "type": "string"
              },
              "keyframes": {
                "type": "object",
                "properties": {
                  "start": {
                    "type": "object",
                    "properties": {
                      "type": {
                        "type": "string"
                      },
                      "url": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "type",
                      "url"
                    ]
                  },
                  "end": {
                    "type": "object",
                    "properties": {
                      "type": {
                        "type": "string"
                      },
                      "url": {
                        "type": "string"
                      }
                    }
                  },
                  "video": {
                    "type": "object",
                    "properties": {
                      "type": {
                        "type": "string"
                      },
                      "url": {
                        "type": "string"
                      }
                    }
                  }
                }
              },
              "references": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "type": {
                      "type": "string",
                      "enum": [
                        "image",
                        "video",
                        "character",
                        "product",
                        "style",
                        "color",
                        "effect",
                        "audio"
                      ]
                    },
                    "url": {
                      "type": "string"
                    },
                    "custom_model_id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "type"
                  ]
                }
              },
              "cameraMotion": {
                "type": "string"
              },
              "negativePrompt": {
                "type": "string"
              },
              "audioUrl": {
                "type": "string"
              },
              "withSoundEffects": {
                "type": "boolean"
              },
              "multi_prompt": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "index": {
                      "type": "number"
                    },
                    "prompt": {
                      "type": "string"
                    },
                    "duration": {
                      "type": "number"
                    },
                    "cameraMotion": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "prompt"
                  ]
                }
              }
            }
          }
        }
      },
      "required": [
        "clips"
      ]
    },
    "folderReference": {
      "type": "string"
    }
  },
  "required": [
    "video"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Video-gen model catalog as lean TOON text. `search` filters by name, slug, description, or tags. Run `video_plan` first — plan resolves slug to validate here.

{
  "type": "object",
  "properties": {
    "search": {
      "type": "string"
    },
    "onlyRecommended": {
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Upscale video via Topaz or Magnific. Pass `creationIdentifier` or Freepik `videoUrl`. Params: `video_upscale_models_list`. Then call `creations_show`.

{
  "type": "object",
  "properties": {
    "creationIdentifier": {
      "type": "string"
    },
    "videoUrl": {
      "type": "string"
    },
    "mode": {
      "type": "string",
      "enum": [
        "topaz",
        "magnific",
        "magnific_precision"
      ]
    },
    "upscaleFactor": {
      "type": "number"
    },
    "targetFps": {
      "type": "number"
    },
    "targetResolution": {
      "type": "number"
    },
    "focus": {
      "type": "number"
    },
    "sharpen": {
      "type": "number"
    },
    "enhancementModel": {
      "type": "string",
      "enum": [
        "proteus",
        "artemis",
        "nyx",
        "rhea",
        "gaia",
        "colorize",
        "dione",
        "theia",
        "iris",
        "themis",
        "starlightFast2",
        "astra2",
        "starlightPrecise25"
      ]
    },
    "frameInterpolation": {
      "type": "string",
      "enum": [
        "apollo",
        "chronos"
      ]
    },
    "creativity": {
      "type": "number"
    },
    "magnificResolution": {
      "type": "string",
      "enum": [
        "720p",
        "1k",
        "2k",
        "4k"
      ]
    },
    "premiumQuality": {
      "type": "boolean"
    },
    "fpsBoost": {
      "type": "boolean"
    },
    "smartGrain": {
      "type": "number"
    },
    "flavor": {
      "type": "string",
      "enum": [
        "vivid",
        "natural"
      ]
    },
    "turbo": {
      "type": "boolean"
    },
    "preview": {
      "type": "boolean"
    },
    "strength": {
      "type": "number"
    },
    "folderReference": {
      "type": "string"
    }
  },
  "required": [
    "mode"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Video upscale mode catalog as raw TOON text (topaz, magnific, magnific_precision) with required/optional params, ranges and enums. Read before calling `video_upscale`.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Concatenate completed video creations into one MP4. Assembles multi-clip plans from `video_plan`. Audio from each clip; no external audio bed. Returns queued creation.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "creationIdentifiers": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "folderReference": {
      "type": "string"
    }
  },
  "required": [
    "creationIdentifiers"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Make a character speak. Image+audio → talking head (Veed Fabric 1.0). Video+audio → lip sync (Lipsync 2.0). Omit `mode` for auto. Pass asset URLs or a creation `identifier` (from `audio_tts`, `images_generate`, `video_generate`). Then call `creations_show`.

{
  "type": "object",
  "properties": {
    "audioUrl": {
      "type": "string"
    },
    "videoUrl": {
      "type": "string"
    },
    "imageUrl": {
      "type": "string"
    },
    "mode": {
      "type": "string",
      "enum": [
        "latentsync",
        "lipsync-2.0",
        "omnihuman",
        "veed-fabric-1.0",
        "veed-fabric-1.0-fast",
        "react-1"
      ]
    },
    "resolution": {
      "type": "string",
      "enum": [
        "480p",
        "720p"
      ]
    },
    "prompt": {
      "type": "string"
    },
    "voiceId": {
      "type": "number"
    },
    "folderReference": {
      "type": "string"
    }
  },
  "required": [
    "audioUrl"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

TTS voiceover. Single (voiceId) or 2-speaker (speakers). ElevenLabs/Google. No voiceId? Call `audio_voices_show` first (or `audio_voices_list` for agent-only lookup).

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string"
    },
    "voiceId": {
      "type": "number"
    },
    "speakers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "voiceId": {
            "type": "number"
          },
          "speakerName": {
            "type": "string"
          }
        },
        "required": [
          "voiceId"
        ]
      }
    },
    "model": {
      "type": "string",
      "enum": [
        "eleven_turbo_v2_5",
        "eleven_v3",
        "gemini_v2_5_pro",
        "gemini_v3_1_flash_tts"
      ]
    },
    "stability": {
      "type": "number"
    },
    "similarityBoost": {
      "type": "number"
    },
    "speed": {
      "type": "number"
    },
    "useSpeakerBoost": {
      "type": "boolean"
    },
    "temperature": {
      "type": "number"
    },
    "systemInstruction": {
      "type": "string"
    },
    "visible": {
      "type": "boolean"
    },
    "folderReference": {
      "type": "string"
    }
  },
  "required": [
    "text"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

AI music generation. Google Lyria or ElevenLabs. Pass `prompt`, optional `model`/`durationSeconds`/`instrumental`. Lyria/Lyria-3 produce fixed 30s; Lyria-3-Pro accepts 30–180s; ElevenLabs accepts 10–300s.

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string"
    },
    "model": {
      "type": "string",
      "enum": [
        "google-lyria",
        "google-lyria-3",
        "google-lyria-3-pro",
        "elevenlabs-music-generation"
      ]
    },
    "durationSeconds": {
      "type": "number"
    },
    "instrumental": {
      "type": "boolean"
    },
    "folderReference": {
      "type": "string"
    }
  },
  "required": [
    "prompt"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

TTS voice catalog as raw TOON text, no UI. Lean entries without preview URLs. Optional `search` filters by name, description, gender, or language.

{
  "type": "object",
  "properties": {
    "search": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Create resized design pages from an image. Use directly when ratios/social formats are known; otherwise show `design_auto_resize_show`.

{
  "type": "object",
  "properties": {
    "creationIdentifier": {
      "type": "string"
    },
    "aspectRatios": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "name": {
      "type": "string"
    },
    "textLayers": {
      "type": "boolean"
    },
    "imageLayers": {
      "type": "boolean"
    },
    "numLayers": {
      "type": "number"
    },
    "multipage": {
      "type": "boolean"
    }
  },
  "required": [
    "creationIdentifier",
    "aspectRatios"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Extract editable layers from a flat image into a Pikaso design.

{
  "type": "object",
  "properties": {
    "creationIdentifier": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "numLayers": {
      "type": "number"
    },
    "vectorize": {
      "type": "boolean"
    }
  },
  "required": [
    "creationIdentifier"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Flows catalog as raw TOON text, no UI. Lean entries without preview URLs. For an inline picker use flows_show; for a single flow input/output spec use flows_get.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "ownership": {
      "type": "string",
      "enum": [
        "mine",
        "public"
      ]
    },
    "page": {
      "type": "number"
    },
    "perPage": {
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Flow input/output spec as raw TOON text. Each input includes a normalized `kind`, `howToProvide`, and resolved `options`/`presetOptions` where applicable. Call before `flows_run`.

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string"
    }
  },
  "required": [
    "identifier"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Run flow. `flows_get` first for input specs. `inputs` is `{inputId: value}` (creation inputs from `creations_list`, voices from `audio_voices_show`). Returns `workflowRunIdentifier` → `flows_wait` → `creations_show`.

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string"
    },
    "inputs": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  },
  "required": [
    "identifier",
    "inputs"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Long-poll a `flows_run`. Terminal: one entry per output creation with real `identifier` for `creations_show`. In-progress: `poll_after_seconds`.

{
  "type": "object",
  "properties": {
    "workflowRunIdentifier": {
      "type": "string"
    },
    "timeoutSeconds": {
      "type": "number"
    }
  },
  "required": [
    "workflowRunIdentifier"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Search Freepik stock catalog by keyword. Returns items with IDs, titles, types, preview URLs. Use stock_get for full details, stock_download for file URL.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "content_type": {
      "type": "string",
      "enum": [
        "photo",
        "vector",
        "video",
        "icon"
      ]
    },
    "page": {
      "type": "number"
    },
    "per_page": {
      "type": "number"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Full details for a single Freepik stock item: preview URL, dimensions, formats, author. Bulk support: accepts ids for batched execution.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "number"
    },
    "type": {
      "type": "string",
      "enum": [
        "photo",
        "vector",
        "video",
        "icon"
      ]
    },
    "ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Signed download URL for a stock item. Pass folder_reference to also save as a creation (rate-limited). Bulk support: accepts ids for batched execution.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "number"
    },
    "type": {
      "type": "string",
      "enum": [
        "photo",
        "vector",
        "video",
        "icon",
        "psd"
      ]
    },
    "folder_reference": {
      "type": "string"
    },
    "ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Convert Freepik stock item → Pikaso creation. Use after user selects from stock_show. Bulk support: accepts ids for batched execution.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "number"
    },
    "folder_reference": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Show the current MCP platform and adapter versions.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

{
  "type": "object",
  "properties": {
    "message": {
      "type": "string"
    },
    "context": {
      "default": "",
      "type": "string"
    },
    "conversation": {
      "default": "[]",
      "type": "string"
    }
  },
  "required": [
    "message"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.

{
  "type": "object",
  "properties": {
    "action": {
      "default": "search",
      "type": "string",
      "enum": [
        "search",
        "describe",
        "install",
        "uninstall",
        "subscribe",
        "cancel",
        "resume",
        "report_bug",
        "request_mcp",
        "list_tools",
        "invoke",
        "search_prompts",
        "get_prompt",
        "publish_prompt"
      ]
    },
    "query": {
      "default": "",
      "type": "string"
    },
    "mcp_id": {
      "default": "",
      "type": "string"
    },
    "limit": {
      "default": 10,
      "type": "number"
    },
    "tier_slug": {
      "default": "",
      "type": "string"
    },
    "immediate": {
      "default": false,
      "type": "boolean"
    },
    "cancel_reason": {
      "type": "string",
      "enum": [
        "too_expensive",
        "missing_features",
        "switched_service",
        "unused",
        "customer_service",
        "too_complex",
        "low_quality",
        "other"
      ]
    },
    "cancel_comment": {
      "default": "",
      "type": "string"
    },
    "message": {
      "default": "",
      "type": "string"
    },
    "report_context": {
      "default": "",
      "type": "string"
    },
    "conversation": {
      "default": "[]",
      "type": "string"
    },
    "request_name": {
      "default": "",
      "type": "string"
    },
    "request_details": {
      "default": "",
      "type": "string"
    },
    "tool_id": {
      "default": "",
      "type": "string"
    },
    "arguments": {
      "default": "{}",
      "type": "string"
    },
    "prompt_slug": {
      "default": "",
      "type": "string"
    },
    "prompt_vars": {
      "default": "{}",
      "type": "string"
    },
    "prompt_category": {
      "default": "",
      "type": "string"
    },
    "prompt_tool": {
      "default": "",
      "type": "string"
    },
    "prompt_title": {
      "default": "",
      "type": "string"
    },
    "prompt_description": {
      "default": "",
      "type": "string"
    },
    "prompt_body": {
      "default": "",
      "type": "string"
    },
    "prompt_targets": {
      "default": [],
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "claude",
          "chatgpt",
          "cursor",
          "lovable"
        ]
      }
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}