Magnific in natural language: upscale images, generate and list your creations. Connect your Magnifi
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
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.
| Argument | Type | Description |
|---|---|---|
| token | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"token": {
"type": "string"
}
}
}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.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}User plan + credits. Check before paid generations. Returns plan.{tier,productName,isUnlimitedMode}, credits.{available,totalPlan,spent,hasExtraCredits}. No history.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}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.
| Argument | Type | Description |
|---|---|---|
| model | string | |
| prompt* | string | |
| instrumental | boolean | |
| durationSeconds | number | |
| folderReference | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"prompt"
],
"properties": {
"model": {
"enum": [
"google-lyria",
"google-lyria-3",
"google-lyria-3-pro",
"elevenlabs-music-generation"
],
"type": "string"
},
"prompt": {
"type": "string"
},
"instrumental": {
"type": "boolean"
},
"durationSeconds": {
"type": "number"
},
"folderReference": {
"type": "string"
}
}
}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).
| Argument | Type | Description |
|---|---|---|
| text* | string | |
| model | string | |
| speed | number | |
| visible | boolean | |
| voiceId | number | |
| speakers | array | |
| stability | number | |
| temperature | number | |
| folderReference | string | |
| similarityBoost | number | |
| useSpeakerBoost | boolean | |
| systemInstruction |
TTS voice catalog as raw TOON text, no UI. Lean entries without preview URLs. Optional `search` filters by name, description, gender, or language.
| Argument | Type | Description |
|---|---|---|
| search | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"search": {
"type": "string"
}
}
}Add a comment (or reply) to a user-owned creation.
| Argument | Type | Description |
|---|---|---|
| text* | string | |
| folderReference* | string | |
| replyToCommentId | string | |
| creationIdentifier* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"creationIdentifier",
"folderReference",
"text"
],
"properties": {
"text": {
"type": "string"
},
"folderReference": {
"type": "string"
},
"replyToCommentId": {
"type": "string"
},
"creationIdentifier": {
"type": "string"
}
}
}Step 2 after PUT from `creations_request_upload`: convert temp path(s) to creations. Images <=25MB, videos <=200MB.
| Argument | Type | Description |
|---|---|---|
| path | string | |
| uploads | array |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"path": {
"type": "string"
},
"uploads": {
"type": "array",
"items": {
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "string"
}
}
}
}
}
}Single creation complete data — metadata + URLs (`url` full-res, `previewUrl` ~1024px, `thumbnailUrl` ~400px).
| Argument | Type | Description |
|---|---|---|
| creationIdentifier* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"creationIdentifier"
],
"properties": {
"creationIdentifier": {
"type": "string"
}
}
}Toggle heart/favorite reaction on a user-owned creation.
| Argument | Type | Description |
|---|---|---|
| unlike | boolean | |
| folderReference* | string | |
| creationIdentifier* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"creationIdentifier",
"folderReference"
],
"properties": {
"unlike": {
"type": "boolean"
},
"folderReference": {
"type": "string"
},
"creationIdentifier": {
"type": "string"
}
}
}Filterable gallery widget (image/video/audio). Use instead of `creations_search` when user wants to browse their library.
| Argument | Type | Description |
|---|---|---|
| from | string | |
| query | string | |
| fileType | string | |
| reference | string | |
| toolNames | array |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"from": {
"enum": [
"history",
"folder",
"project-root",
"all-assets",
"favorites",
"downloads",
"trash",
"upload",
"v3-upload",
"v3-favorites",
"v3-trash"
],
"type": "string"
},
"query": {
"type": "string"
},
"fileType": {
"enum": [
"image",
"video",
"audio"
],
"type": "string"
},
"reference": {
"type": "string"
},
"toolNames": {
"type": "array",
"items": {
"type": "string"
}
}
}
}Move creations into `targetFolderReference`. Identifiers from `images_generate`/`creations_search`. Foreign identifier → abort. Target folder must belong to user.
| Argument | Type | Description |
|---|---|---|
| creationIdentifiers* | array | |
| targetFolderReference* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"targetFolderReference",
"creationIdentifiers"
],
"properties": {
"creationIdentifiers": {
"type": "array",
"items": {
"type": "string"
}
},
"targetFolderReference": {
"type": "string"
}
}
}Step 1 for local/user files: get presigned PUT URL(s). Upload bytes outside MCP, then call `creations_finalize_upload`.
| Argument | Type | Description |
|---|---|---|
| count | number | |
| mimeType* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"mimeType"
],
"properties": {
"count": {
"type": "number"
},
"mimeType": {
"enum": [
"image/jpeg",
"image/png",
"image/webp",
"video/mp4",
"video/quicktime",
"video/webm",
"video/x-m4v"
],
"type": "string"
}
}
}Search user creations as raw TOON text. Use `creations_get` for one id. `reference` required with from=folder/project-root. Defaults: history, page 1.
| Argument | Type | Description |
|---|---|---|
| from | string | |
| page | number | |
| query | string | |
| fileType | string | |
| reference | string | |
| toolNames | array | |
| folderReference | string | |
| excludeToolNames | array |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"from": {
"enum": [
"history",
"folder",
"project-root",
"all-assets",
"favorites",
"downloads",
"trash",
"upload",
"v3-upload",
"v3-favorites",
"v3-trash"
],
"type": "string"
},
"page": {
"type": "number"
},
"query": {
"type": "string"
},
"fileType": {
"enum": [
"image",
"video",
"audio"
],
"type": "string"
},
"reference": {
"type": "string"
},
"toolNames": {
"type": "array",
"items": {
"type": "string"
}
},
"folderReference": {
"type": "string"
},
"excludeToolNames": {
"type": "array",
"items": {
"type": "string"
}
}
}
}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`.
| Argument | Type | Description |
|---|---|---|
| file* | object |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"file"
],
"properties": {
"file": {
"type": "object",
"required": [
"download_url",
"file_id"
],
"properties": {
"file_id": {
"type": "string"
},
"file_name": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"download_url": {
"type": "string"
}
}
}
}
}Upload public image URL in one step. For local/user files use `creations_request_upload` then `creations_finalize_upload`.
| Argument | Type | Description |
|---|---|---|
| url* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string"
}
}
}Long-poll 1..8 creations until terminal or `timeoutSeconds` (default 25, max 25). In-progress entries get `poll_after_seconds` for the next call.
| Argument | Type | Description |
|---|---|---|
| identifiers* | array | |
| timeoutSeconds | number |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"identifiers"
],
"properties": {
"identifiers": {
"type": "array",
"items": {
"type": "string"
}
},
"timeoutSeconds": {
"type": "number"
}
}
}Extract editable layers from a flat image into a Pikaso design.
| Argument | Type | Description |
|---|---|---|
| name | string | |
| numLayers | number | |
| vectorize | boolean | |
| creationIdentifier* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"creationIdentifier"
],
"properties": {
"name": {
"type": "string"
},
"numLayers": {
"type": "number"
},
"vectorize": {
"type": "boolean"
},
"creationIdentifier": {
"type": "string"
}
}
}Create resized design pages from an image. Use directly when ratios/social formats are known; otherwise show `design_auto_resize_show`.
| Argument | Type | Description |
|---|---|---|
| name | string | |
| multipage | boolean | |
| numLayers | number | |
| textLayers | boolean | |
| imageLayers | boolean | |
| aspectRatios* | array | |
| creationIdentifier* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"creationIdentifier",
"aspectRatios"
],
"properties": {
"name": {
"type": "string"
},
"multipage": {
"type": "boolean"
},
"numLayers": {
"type": "number"
},
"textLayers": {
"type": "boolean"
},
"imageLayers": {
"type": "boolean"
},
"aspectRatios": {
"type": "array",
"items": {
"type": "string"
}
},
"creationIdentifier": {
"type": "string"
}
}
}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`.
| Argument | Type | Description |
|---|---|---|
| identifier* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"identifier"
],
"properties": {
"identifier": {
"type": "string"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| page | number | |
| query | string | |
| perPage | number | |
| ownership | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"page": {
"type": "number"
},
"query": {
"type": "string"
},
"perPage": {
"type": "number"
},
"ownership": {
"enum": [
"mine",
"public"
],
"type": "string"
}
}
}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`.
| Argument | Type | Description |
|---|---|---|
| inputs* | object | |
| identifier* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"identifier",
"inputs"
],
"properties": {
"inputs": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"identifier": {
"type": "string"
}
}
}Long-poll a `flows_run`. Terminal: one entry per output creation with real `identifier` for `creations_show`. In-progress: `poll_after_seconds`.
| Argument | Type | Description |
|---|---|---|
| timeoutSeconds | number | |
| workflowRunIdentifier* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workflowRunIdentifier"
],
"properties": {
"timeoutSeconds": {
"type": "number"
},
"workflowRunIdentifier": {
"type": "string"
}
}
}Create folder/project. No `parentReference`: workspace root. `type` defaults: project at root, folder when nested.
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| type | string | |
| parentReference | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"type": {
"type": "string"
},
"parentReference": {
"type": "string"
}
}
}Move a folder and its files to trash.
| Argument | Type | Description |
|---|---|---|
| reference* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"reference"
],
"properties": {
"reference": {
"type": "string"
}
}
}Fetch folder metadata by `reference`. Use before `creations_search` (`from=folder`). Foreign refs error.
| Argument | Type | Description |
|---|---|---|
| reference* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"reference"
],
"properties": {
"reference": {
"type": "string"
}
}
}List folders/projects as raw TOON text. No params=top level; `onlyProjects`=projects; `parentReference`=children. Refs work with creations/folder tools.
| Argument | Type | Description |
|---|---|---|
| page | number | |
| onlyProjects | boolean | |
| parentReference | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"page": {
"type": "number"
},
"onlyProjects": {
"type": "boolean"
},
"parentReference": {
"type": "string"
}
}
}Rename a folder by `reference`.
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| reference* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"reference",
"name"
],
"properties": {
"name": {
"type": "string"
},
"reference": {
"type": "string"
}
}
}Reframe camera around subject. Defaults: rotate=45, vertical=0, closeup=5.
| Argument | Type | Description |
|---|---|---|
| rotate | number | |
| closeup | number | |
| vertical | number | |
| folderReference | string | |
| creationIdentifier* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"creationIdentifier"
],
"properties": {
"rotate": {
"type": "number"
},
"closeup": {
"type": "number"
},
"vertical": {
"type": "number"
},
"folderReference": {
"type": "string"
},
"creationIdentifier": {
"type": "string"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| aspectRatio* | string | |
| folderReference | string | |
| creationIdentifier* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"creationIdentifier",
"aspectRatio"
],
"properties": {
"aspectRatio": {
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"3:2",
"2:3",
"21:9"
],
"type": "string"
},
"folderReference": {
"type": "string"
},
"creationIdentifier": {
"type": "string"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| mode | string | |
| count | number | |
| prompt* | string | |
| quality | string | |
| references | array | |
| resolution | string | |
| aspectRatio | string | |
| folderReference | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"prompt"
],
"properties": {
"mode": {
"type": "string"
},
"count": {
"type": "number"
},
"prompt": {
"type": "string"
},
"quality": {
"type": "string"
},
"references": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"identifier"
],
"properties": {
"type": {
"enum": [
"image",
"style",
"character",
"product",
"locations"
],
"type": "string"
},
"identifier": {
"type": "string"
}
}
}
},
"resolution": {
"type": "string"
},
"aspectRatio": {
"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"
],
"type": "string"
},
"folderReference": {
"type": "string"
}
}
}Text-to-SVG (Recraft v4 Pro Vector). Raster: `images_generate`. Trace existing raster: `images_to_svg`. Default aspectRatio=1:1.
| Argument | Type | Description |
|---|---|---|
| prompt* | string | |
| aspectRatio | string | |
| folderReference | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"prompt"
],
"properties": {
"prompt": {
"type": "string"
},
"aspectRatio": {
"enum": [
"1:1",
"2:1",
"1:2",
"3:2",
"2:3",
"4:3",
"3:4",
"5:4",
"4:5",
"16:9",
"9:16"
],
"type": "string"
},
"folderReference": {
"type": "string"
}
}
}TTI model catalog as lean TOON text. `search` filters by name, slug, description, or tags.
| Argument | Type | Description |
|---|---|---|
| search | string | |
| onlyRecommended | boolean |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"search": {
"type": "string"
},
"onlyRecommended": {
"type": "boolean"
}
}
}AI relight. 1-4 lights with azimuth/elevation enums, type neutral|gel, intensity 1-10. Gel uses hex `color`.
| Argument | Type | Description |
|---|---|---|
| lights* | array | |
| numImages | number | |
| resolution | string | |
| folderReference | string | |
| creationIdentifier* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"creationIdentifier",
"lights"
],
"properties": {
"lights": {
"type": "array",
"items": {
"type": "object",
"required": [
"azimuth",
"elevation"
],
"properties": {
"type": {
"enum": [
"neutral",
"gel"
],
"type": "string"
},
"color": {
"type": "string"
},
"azimuth": {
"type": "number"
},
"elevation": {
"type": "number"
},
"intensity": {
"type": "number"
}
}
}
},
"numImages": {
"type": "number"
},
"resolution": {
"enum": [
"1k",
"2k"
],
"type": "string"
},
"folderReference": {
"type": "string"
},
"creationIdentifier": {
"type": "string"
}
}
}Cut-out subject on transparent PNG. Color BG: `images_color_background`. AI scene: `images_generate` with reference + prompt "replace the background with X".
| Argument | Type | Description |
|---|---|---|
| folderReference | string | |
| creationIdentifier* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"creationIdentifier"
],
"properties": {
"folderReference": {
"type": "string"
},
"creationIdentifier": {
"type": "string"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| width* | number | |
| height* | number | |
| folderReference | string | |
| creationIdentifier* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"creationIdentifier",
"width",
"height"
],
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"folderReference": {
"type": "string"
},
"creationIdentifier": {
"type": "string"
}
}
}AI skin enhancer. faithful preserves identity; creative reinterprets; flexible uses presets. Defaults: faithful, sharpen=0, smartGrain=0.
| Argument | Type | Description |
|---|---|---|
| sharpen | number | |
| version | string | |
| skinDetail | number | |
| smartGrain | number | |
| optimizedFor | string | |
| folderReference | string | |
| creationIdentifier* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"creationIdentifier"
],
"properties": {
"sharpen": {
"type": "number"
},
"version": {
"enum": [
"faithful",
"creative",
"flexible"
],
"type": "string"
},
"skinDetail": {
"type": "number"
},
"smartGrain": {
"type": "number"
},
"optimizedFor": {
"enum": [
"enhance_skin",
"enhance_everything",
"improve_lighting",
"transform_to_real",
"no_make_up"
],
"type": "string"
},
"folderReference": {
"type": "string"
},
"creationIdentifier": {
"type": "string"
}
}
}Trace raster creation into SVG. New vector from prompt: `images_generate_svg`.
| Argument | Type | Description |
|---|---|---|
| folderReference | string | |
| creationIdentifier* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"creationIdentifier"
],
"properties": {
"folderReference": {
"type": "string"
},
"creationIdentifier": {
"type": "string"
}
}
}AI upscale 2x/4x (Magnific, premium). Exact pixels: `images_resize`. Aspect: `images_crop`. Default scale=2.
| Argument | Type | Description |
|---|---|---|
| scale | string | |
| folderReference | string | |
| creationIdentifier* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"creationIdentifier"
],
"properties": {
"scale": {
"enum": [
"2x",
"4x"
],
"type": "string"
},
"folderReference": {
"type": "string"
},
"creationIdentifier": {
"type": "string"
}
}
}Generate image-variation grid. Modes: angles|demographics|expressions|age|storyboard|custom. Defaults: angles, 3x3, 1:1, 4k.
| Argument | Type | Description |
|---|---|---|
| prompt | string | |
| gridCols | number | |
| gridRows | number | |
| resolution | string | |
| aspectRatio | string | |
| variationMode | string | |
| selectedAngles | array | |
| folderReference | string | |
| selectedGenders | array | |
| creationIdentifier* | string | |
| selectedEthnicities | array |
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.
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| type* | string | |
| gender | string | |
| images* | array | |
| description | string | |
| productType | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name",
"type",
"images"
],
"properties": {
"name": {
"type": "string"
},
"type": {
"enum": [
"character",
"product",
"locations"
],
"type": "string"
},
"gender": {
"type": "string"
},
"images": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"creationIdentifier": {
"type": "string"
}
}
}
},
"description": {
"type": "string"
},
"productType": {
"type": "string"
}
}
}Lean library catalog (characters, styles, elements, locations) for agent reasoning. Picker assets use library://.
| Argument | Type | Description |
|---|---|---|
| page | number | |
| type | string | |
| scope | string | |
| search | string | |
| perPage | number |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"page": {
"type": "number"
},
"type": {
"enum": [
"character",
"style",
"element",
"locations"
],
"type": "string"
},
"scope": {
"enum": [
"all",
"projects",
"organization"
],
"type": "string"
},
"search": {
"type": "string"
},
"perPage": {
"type": "number"
}
}
}Image-to-3D GLB. Upload external images first. Animate with `models3d_rig`. Models: tripo-p1 default, tripo-v31, trellis-2.
| Argument | Type | Description |
|---|---|---|
| model | string | |
| faceLimit | number | |
| resolution | number | |
| textureQuality | string | |
| folderReference | string | |
| creationIdentifier* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"creationIdentifier"
],
"properties": {
"model": {
"enum": [
"tripo-p1",
"tripo-v31",
"trellis-2"
],
"type": "string"
},
"faceLimit": {
"type": "number"
},
"resolution": {
"type": "number"
},
"textureQuality": {
"enum": [
"none",
"standard",
"detailed"
],
"type": "string"
},
"folderReference": {
"type": "string"
},
"creationIdentifier": {
"type": "string"
}
}
}English markdown status report for a project/folder. Last 7 days default, max 30.
| Argument | Type | Description |
|---|---|---|
| days | number | |
| reference* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"reference"
],
"properties": {
"days": {
"type": "number"
},
"reference": {
"type": "string"
}
}
}Create empty Space. Share `space.webUrl`; only call `spaces_show` when inline preview is requested.
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| description | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"description": {
"type": "string"
}
}
}External MCP only. Start headless Space edit. Poll `spaces_edit_status` until allTerminal, then verify with `spaces_state`.
| Argument | Type | Description |
|---|---|---|
| query* | string | |
| spaceId* | string | |
| threadId | string | |
| anchorDirection | string | |
| anchorElementId | string | |
| selectedElementIds | array | |
| selectedConnectionIds | array |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query",
"spaceId"
],
"properties": {
"query": {
"type": "string"
},
"spaceId": {
"type": "string"
},
"threadId": {
"type": "string"
},
"anchorDirection": {
"enum": [
"left",
"right",
"up",
"down"
],
"type": "string"
},
"anchorElementId": {
"type": "string"
},
"selectedElementIds": {
"type": "array",
"items": {
"type": "string"
}
},
"selectedConnectionIds": {
"type": "array",
"items": {
"type": "string"
}
}
}
}Wait for `spaces_edit` like `creations_wait`: long-polls up to `timeoutSeconds` (default 25, max 25). Snapshot-only when 0. Terminal → `spaces_state`.
| Argument | Type | Description |
|---|---|---|
| runId | string | |
| threadId | string | |
| operationId | string | |
| timeoutSeconds | number |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"runId": {
"type": "string"
},
"threadId": {
"type": "string"
},
"operationId": {
"type": "string"
},
"timeoutSeconds": {
"type": "number"
}
}
}Read-only. Like `spaces_state` but scoped to `nodeIds` + their connections. Cheaper than full board. Needs view perm.
| Argument | Type | Description |
|---|---|---|
| nodeIds* | array | |
| spaceId* | string | |
| currentPageId | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"spaceId",
"nodeIds"
],
"properties": {
"nodeIds": {
"type": "array",
"items": {
"type": "string"
}
},
"spaceId": {
"type": "string"
},
"currentPageId": {
"type": "string"
}
}
}Lean spaces catalog as raw TOON text. Share each `webUrl`; call `spaces_show` only for inline canvas preview. Do not use `creations_search`.
| Argument | Type | Description |
|---|---|---|
| page | number | |
| query | string | |
| perPage | number | |
| ownership | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"page": {
"type": "number"
},
"query": {
"type": "string"
},
"perPage": {
"type": "number"
},
"ownership": {
"enum": [
"all",
"mine",
"shared"
],
"type": "string"
}
}
}Run Space workflow from `startNodeId`. Modes: singular, connected default, downstream. Poll with `spaces_run_status`.
| Argument | Type | Description |
|---|---|---|
| mode | string | |
| spaceId* | string | |
| startNodeId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"spaceId",
"startNodeId"
],
"properties": {
"mode": {
"enum": [
"singular",
"connected",
"downstream"
],
"type": "string"
},
"spaceId": {
"type": "string"
},
"startNodeId": {
"type": "string"
}
}
}Poll `spaces_run`. `timeoutSeconds` long-polls up to 25s. In-progress returns `poll_after_seconds`; terminal call `creations_show`.
| Argument | Type | Description |
|---|---|---|
| timeoutSeconds | number | |
| workflowRunIdentifier* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workflowRunIdentifier"
],
"properties": {
"timeoutSeconds": {
"type": "number"
},
"workflowRunIdentifier": {
"type": "string"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| scope | string | |
| pageId | string | |
| spaceId* | string | |
| currentPageId | string | |
| selectedElementIds | array | |
| selectedConnectionIds | array |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"spaceId"
],
"properties": {
"scope": {
"type": "string"
},
"pageId": {
"type": "string"
},
"spaceId": {
"type": "string"
},
"currentPageId": {
"type": "string"
},
"selectedElementIds": {
"type": "array",
"items": {
"type": "string"
}
},
"selectedConnectionIds": {
"type": "array",
"items": {
"type": "string"
}
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| id* | number | |
| ids | array | |
| type | string | |
| folder_reference | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "number"
},
"ids": {
"type": "array",
"items": {
"type": "number"
}
},
"type": {
"enum": [
"photo",
"vector",
"video",
"icon",
"psd"
],
"type": "string"
},
"folder_reference": {
"type": "string"
}
}
}Full details for a single Freepik stock item: preview URL, dimensions, formats, author. Bulk support: accepts ids for batched execution.
| Argument | Type | Description |
|---|---|---|
| id* | number | |
| ids | array | |
| type | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "number"
},
"ids": {
"type": "array",
"items": {
"type": "number"
}
},
"type": {
"enum": [
"photo",
"vector",
"video",
"icon"
],
"type": "string"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| page | number | |
| query* | string | |
| per_page | number | |
| content_type | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"page": {
"type": "number"
},
"query": {
"type": "string"
},
"per_page": {
"type": "number"
},
"content_type": {
"enum": [
"photo",
"vector",
"video",
"icon"
],
"type": "string"
}
}
}Convert Freepik stock item → Pikaso creation. Use after user selects from stock_show. Bulk support: accepts ids for batched execution.
| Argument | Type | Description |
|---|---|---|
| id* | number | |
| ids | array | |
| title | string | |
| folder_reference | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "number"
},
"ids": {
"type": "array",
"items": {
"type": "number"
}
},
"title": {
"type": "string"
},
"folder_reference": {
"type": "string"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| name | string | |
| folderReference | string | |
| creationIdentifiers* | array |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"creationIdentifiers"
],
"properties": {
"name": {
"type": "string"
},
"folderReference": {
"type": "string"
},
"creationIdentifiers": {
"type": "array",
"items": {
"type": "string"
}
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| video* | object | |
| folderReference | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"video"
],
"properties": {
"video": {
"type": "object",
"required": [
"clips"
],
"properties": {
"clips": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"prompt": {
"type": "string"
},
"audioUrl": {
"type": "string"
},
"duration": {
"type": "number"
},
"position": {
"type": "number"
},
"keyframes": {
"type": "object",
"properties": {
"end": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string"
}
}
},
"start": {
"type": "object",
"required": [
"type",
"url"
],
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string"
}
}
},
"video": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"type": {
"type": "string"
}
}
}
}
},
"references": {
"type": "array",
"items": {
"type": "object",
"required": [
"type"
],
"properties": {
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"type": {
"enum": [
"image",
"video",
"character",
"product",
"style",
"color",
"effect",
"audio"
],
"type": "string"
},
"custom_model_id": {
"type": "string"
}
}
}
},
"resolution": {
"type": "string"
},
"aspectRatio": {
"type": "string"
},
"cameraMotion": {
"type": "string"
},
"multi_prompt": {
"type": "array",
"items": {
"type": "object",
"required": [
"prompt"
],
"properties": {
"index": {
"type": "number"
},
"prompt": {
"type": "string"
},
"duration": {
"type": "number"
},
"cameraMotion": {
"type": "string"
}
}
}
},
"negativePrompt": {
"type": "string"
},
"withSoundEffects": {
"type": "boolean"
}
}
}
}
}
},
"folderReference": {
"type": "string"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| search | string | |
| onlyRecommended | boolean |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"search": {
"type": "string"
},
"onlyRecommended": {
"type": "boolean"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| prompt* | string | |
| styleHint | string | |
| durationHint | number | |
| aspectRatioHint | string | |
| referenceIdentifiers | array |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"prompt"
],
"properties": {
"prompt": {
"type": "string"
},
"styleHint": {
"type": "string"
},
"durationHint": {
"type": "number"
},
"aspectRatioHint": {
"type": "string"
},
"referenceIdentifiers": {
"type": "array",
"items": {
"type": "string"
}
}
}
}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`.
| Argument | Type | Description |
|---|---|---|
| mode | string | |
| prompt | string | |
| voiceId | number | |
| audioUrl* | string | |
| imageUrl | string | |
| videoUrl | string | |
| resolution | string | |
| folderReference | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"audioUrl"
],
"properties": {
"mode": {
"enum": [
"latentsync",
"lipsync-2.0",
"omnihuman",
"veed-fabric-1.0",
"veed-fabric-1.0-fast",
"react-1"
],
"type": "string"
},
"prompt": {
"type": "string"
},
"voiceId": {
"type": "number"
},
"audioUrl": {
"type": "string"
},
"imageUrl": {
"type": "string"
},
"videoUrl": {
"type": "string"
},
"resolution": {
"enum": [
"480p",
"720p"
],
"type": "string"
},
"folderReference": {
"type": "string"
}
}
}Upscale video via Topaz or Magnific. Pass `creationIdentifier` or Freepik `videoUrl`. Params: `video_upscale_models_list`. Then call `creations_show`.
| Argument | Type | Description |
|---|---|---|
| mode* | string | |
| focus | number | |
| turbo | boolean | |
| flavor | string | |
| preview | boolean | |
| sharpen | number | |
| fpsBoost | boolean | |
| strength | number | |
| videoUrl | string | |
| targetFps | number | |
| creativity | number | |
| smartGrain | number |
Video upscale mode catalog as raw TOON text (topaz, magnific, magnific_precision) with required/optional params, ranges and enums. Read before calling `video_upscale`.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}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.
| Argument | Type | Description |
|---|---|---|
| limit | number | |
| query | string | |
| action | string | |
| mcp_id | string | |
| message |
Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
| Argument | Type | Description |
|---|---|---|
| context | string | |
| message* | string | |
| conversation | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"message"
],
"properties": {
"context": {
"type": "string",
"default": ""
},
"message": {
"type": "string"
},
"conversation": {
"type": "string",
"default": "[]"
}
}
}Show the current MCP platform and adapter versions.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}| string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"model": {
"enum": [
"eleven_turbo_v2_5",
"eleven_v3",
"gemini_v2_5_pro",
"gemini_v3_1_flash_tts"
],
"type": "string"
},
"speed": {
"type": "number"
},
"visible": {
"type": "boolean"
},
"voiceId": {
"type": "number"
},
"speakers": {
"type": "array",
"items": {
"type": "object",
"required": [
"voiceId"
],
"properties": {
"voiceId": {
"type": "number"
},
"speakerName": {
"type": "string"
}
}
}
},
"stability": {
"type": "number"
},
"temperature": {
"type": "number"
},
"folderReference": {
"type": "string"
},
"similarityBoost": {
"type": "number"
},
"useSpeakerBoost": {
"type": "boolean"
},
"systemInstruction": {
"type": "string"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"creationIdentifier"
],
"properties": {
"prompt": {
"type": "string"
},
"gridCols": {
"type": "number"
},
"gridRows": {
"type": "number"
},
"resolution": {
"enum": [
"2k",
"4k"
],
"type": "string"
},
"aspectRatio": {
"enum": [
"1:1",
"21:9",
"16:9",
"9:16",
"4:3",
"4:5",
"5:4",
"3:4",
"3:2",
"2:3"
],
"type": "string"
},
"variationMode": {
"enum": [
"angles",
"demographics",
"expressions",
"age",
"storyboard",
"custom"
],
"type": "string"
},
"selectedAngles": {
"type": "array",
"items": {
"type": "string"
}
},
"folderReference": {
"type": "string"
},
"selectedGenders": {
"type": "array",
"items": {
"enum": [
"male",
"female"
],
"type": "string"
}
},
"creationIdentifier": {
"type": "string"
},
"selectedEthnicities": {
"type": "array",
"items": {
"type": "string"
}
}
}
}| upscaleFactor | number |
| premiumQuality | boolean |
| folderReference | string |
| enhancementModel | string |
| targetResolution | number |
| creationIdentifier | string |
| frameInterpolation | string |
| magnificResolution | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"mode"
],
"properties": {
"mode": {
"enum": [
"topaz",
"magnific",
"magnific_precision"
],
"type": "string"
},
"focus": {
"type": "number"
},
"turbo": {
"type": "boolean"
},
"flavor": {
"enum": [
"vivid",
"natural"
],
"type": "string"
},
"preview": {
"type": "boolean"
},
"sharpen": {
"type": "number"
},
"fpsBoost": {
"type": "boolean"
},
"strength": {
"type": "number"
},
"videoUrl": {
"type": "string"
},
"targetFps": {
"type": "number"
},
"creativity": {
"type": "number"
},
"smartGrain": {
"type": "number"
},
"upscaleFactor": {
"type": "number"
},
"premiumQuality": {
"type": "boolean"
},
"folderReference": {
"type": "string"
},
"enhancementModel": {
"enum": [
"proteus",
"artemis",
"nyx",
"rhea",
"gaia",
"colorize",
"dione",
"theia",
"iris",
"themis",
"starlightFast2",
"astra2",
"starlightPrecise25"
],
"type": "string"
},
"targetResolution": {
"type": "number"
},
"creationIdentifier": {
"type": "string"
},
"frameInterpolation": {
"enum": [
"apollo",
"chronos"
],
"type": "string"
},
"magnificResolution": {
"enum": [
"720p",
"1k",
"2k",
"4k"
],
"type": "string"
}
}
}| string |
| tool_id | string |
| arguments | string |
| immediate | boolean |
| tier_slug | string |
| prompt_body | string |
| prompt_slug | string |
| prompt_tool | string |
| prompt_vars | string |
| conversation | string |
| prompt_title | string |
| request_name | string |
| cancel_reason | string |
| cancel_comment | string |
| prompt_targets | array |
| report_context | string |
| prompt_category | string |
| request_details | string |
| prompt_description | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "number",
"default": 10
},
"query": {
"type": "string",
"default": ""
},
"action": {
"enum": [
"search",
"describe",
"install",
"uninstall",
"subscribe",
"cancel",
"resume",
"report_bug",
"request_mcp",
"list_tools",
"invoke",
"search_prompts",
"get_prompt",
"publish_prompt"
],
"type": "string",
"default": "search"
},
"mcp_id": {
"type": "string",
"default": ""
},
"message": {
"type": "string",
"default": ""
},
"tool_id": {
"type": "string",
"default": ""
},
"arguments": {
"type": "string",
"default": "{}"
},
"immediate": {
"type": "boolean",
"default": false
},
"tier_slug": {
"type": "string",
"default": ""
},
"prompt_body": {
"type": "string",
"default": ""
},
"prompt_slug": {
"type": "string",
"default": ""
},
"prompt_tool": {
"type": "string",
"default": ""
},
"prompt_vars": {
"type": "string",
"default": "{}"
},
"conversation": {
"type": "string",
"default": "[]"
},
"prompt_title": {
"type": "string",
"default": ""
},
"request_name": {
"type": "string",
"default": ""
},
"cancel_reason": {
"enum": [
"too_expensive",
"missing_features",
"switched_service",
"unused",
"customer_service",
"too_complex",
"low_quality",
"other"
],
"type": "string"
},
"cancel_comment": {
"type": "string",
"default": ""
},
"prompt_targets": {
"type": "array",
"items": {
"enum": [
"claude",
"chatgpt",
"cursor",
"lovable"
],
"type": "string"
},
"default": []
},
"report_context": {
"type": "string",
"default": ""
},
"prompt_category": {
"type": "string",
"default": ""
},
"request_details": {
"type": "string",
"default": ""
},
"prompt_description": {
"type": "string",
"default": ""
}
}
}