MCP Server

Magnific

io.github.mcp-dir/magnific-mcp
Design & Creative Media & Content Public & reachable MCP 2025-11-25

What this MCP does

Provides image enhancement and design tools, AI image and audio generation, text-to-speech, creation management, and reusable creative workflows.

authenticate
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.
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'token': {'type': 'string'}}}
connect
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.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
magnific_account_balance
User plan + credits. Check before paid generations. Returns plan.{tier,productName,isUnlimitedMode}, credits.{available,totalPlan,spent,hasExtraCredits}. No history.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
magnific_audio_music_generate
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.
Input schema
{'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'}}}
magnific_audio_tts
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).
Input schema
{'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'}}}
magnific_audio_voices_list
TTS voice catalog as raw TOON text, no UI. Lean entries without preview URLs. Optional `search` filters by name, description, gender, or language.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'search': {'type': 'string'}}}
magnific_creations_comment
Add a comment (or reply) to a user-owned creation.
Input schema
{'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'}}}
magnific_creations_finalize_upload
Step 2 after PUT from `creations_request_upload`: convert temp path(s) to creations. Images <=25MB, videos <=200MB.
Input schema
{'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'}}}}}}
magnific_creations_get
Single creation complete data — metadata + URLs (`url` full-res, `previewUrl` ~1024px, `thumbnailUrl` ~400px).
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['creationIdentifier'], 'properties': {'creationIdentifier': {'type': 'string'}}}
magnific_creations_like
Toggle heart/favorite reaction on a user-owned creation.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['creationIdentifier', 'folderReference'], 'properties': {'unlike': {'type': 'boolean'}, 'folderReference': {'type': 'string'}, 'creationIdentifier': {'type': 'string'}}}
magnific_creations_list
Filterable gallery widget (image/video/audio). Use instead of `creations_search` when user wants to browse their library.
Read only Idempotent
Input schema
{'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'}}}}
magnific_creations_move
Move creations into `targetFolderReference`. Identifiers from `images_generate`/`creations_search`. Foreign identifier → abort. Target folder must belong to user.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['targetFolderReference', 'creationIdentifiers'], 'properties': {'creationIdentifiers': {'type': 'array', 'items': {'type': 'string'}}, 'targetFolderReference': {'type': 'string'}}}
magnific_creations_request_upload
Step 1 for local/user files: get presigned PUT URL(s). Upload bytes outside MCP, then call `creations_finalize_upload`.
Input schema
{'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'}}}
magnific_creations_search
Search user creations as raw TOON text. Use `creations_get` for one id. `reference` required with from=folder/project-root. Defaults: history, page 1.
Read only Idempotent
Input schema
{'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'}}}}
magnific_creations_upload_file
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`.
Input schema
{'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'}}}}}
magnific_creations_upload_image
Upload public image URL in one step. For local/user files use `creations_request_upload` then `creations_finalize_upload`.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['url'], 'properties': {'url': {'type': 'string'}}}
magnific_creations_wait
Long-poll 1..8 creations until terminal or `timeoutSeconds` (default 25, max 25). In-progress entries get `poll_after_seconds` for the next call.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['identifiers'], 'properties': {'identifiers': {'type': 'array', 'items': {'type': 'string'}}, 'timeoutSeconds': {'type': 'number'}}}
magnific_design_auto_layers
Extract editable layers from a flat image into a Pikaso design.
Input schema
{'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'}}}
magnific_design_auto_resize
Create resized design pages from an image. Use directly when ratios/social formats are known; otherwise show `design_auto_resize_show`.
Input schema
{'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'}}}
magnific_flows_get
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`.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['identifier'], 'properties': {'identifier': {'type': 'string'}}}
magnific_flows_list
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.
Read only Idempotent
Input schema
{'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'}}}
magnific_flows_run
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`.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['identifier', 'inputs'], 'properties': {'inputs': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'identifier': {'type': 'string'}}}
magnific_flows_wait
Long-poll a `flows_run`. Terminal: one entry per output creation with real `identifier` for `creations_show`. In-progress: `poll_after_seconds`.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['workflowRunIdentifier'], 'properties': {'timeoutSeconds': {'type': 'number'}, 'workflowRunIdentifier': {'type': 'string'}}}
magnific_folders_create
Create folder/project. No `parentReference`: workspace root. `type` defaults: project at root, folder when nested.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name'], 'properties': {'name': {'type': 'string'}, 'type': {'type': 'string'}, 'parentReference': {'type': 'string'}}}
magnific_folders_delete
Move a folder and its files to trash.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['reference'], 'properties': {'reference': {'type': 'string'}}}
magnific_folders_get
Fetch folder metadata by `reference`. Use before `creations_search` (`from=folder`). Foreign refs error.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['reference'], 'properties': {'reference': {'type': 'string'}}}
magnific_folders_list
List folders/projects as raw TOON text. No params=top level; `onlyProjects`=projects; `parentReference`=children. Refs work with creations/folder tools.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'page': {'type': 'number'}, 'onlyProjects': {'type': 'boolean'}, 'parentReference': {'type': 'string'}}}
magnific_folders_rename
Rename a folder by `reference`.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['reference', 'name'], 'properties': {'name': {'type': 'string'}, 'reference': {'type': 'string'}}}
magnific_images_change_camera
Reframe camera around subject. Defaults: rotate=45, vertical=0, closeup=5.
Input schema
{'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'}}}
magnific_images_crop
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.
Input schema
{'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'}}}
magnific_images_generate
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.
Input schema
{'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'}}}
magnific_images_generate_svg
Text-to-SVG (Recraft v4 Pro Vector). Raster: `images_generate`. Trace existing raster: `images_to_svg`. Default aspectRatio=1:1.
Input schema
{'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'}}}
magnific_images_models_list
TTI model catalog as lean TOON text. `search` filters by name, slug, description, or tags.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'search': {'type': 'string'}, 'onlyRecommended': {'type': 'boolean'}}}
magnific_images_relight
AI relight. 1-4 lights with azimuth/elevation enums, type neutral|gel, intensity 1-10. Gel uses hex `color`.
Input schema
{'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'}}}
magnific_images_remove_background
Cut-out subject on transparent PNG. Color BG: `images_color_background`. AI scene: `images_generate` with reference + prompt "replace the background with X".
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['creationIdentifier'], 'properties': {'folderReference': {'type': 'string'}, 'creationIdentifier': {'type': 'string'}}}
magnific_images_resize
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.
Input schema
{'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'}}}
magnific_images_skin_enhancer
AI skin enhancer. faithful preserves identity; creative reinterprets; flexible uses presets. Defaults: faithful, sharpen=0, smartGrain=0.
Input schema
{'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'}}}
magnific_images_to_svg
Trace raster creation into SVG. New vector from prompt: `images_generate_svg`.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['creationIdentifier'], 'properties': {'folderReference': {'type': 'string'}, 'creationIdentifier': {'type': 'string'}}}
magnific_images_upscale
AI upscale 2x/4x (Magnific, premium). Exact pixels: `images_resize`. Aspect: `images_crop`. Default scale=2.
Input schema
{'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'}}}
magnific_images_variations
Generate image-variation grid. Modes: angles|demographics|expressions|age|storyboard|custom. Defaults: angles, 3x3, 1:1, 4k.
Input schema
{'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'}}}}
magnific_library_create
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.
Input schema
{'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'}}}
magnific_library_list
Lean library catalog (characters, styles, elements, locations) for agent reasoning. Picker assets use library://.
Read only Idempotent
Input schema
{'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'}}}
magnific_models3d_generate
Image-to-3D GLB. Upload external images first. Animate with `models3d_rig`. Models: tripo-p1 default, tripo-v31, trellis-2.
Input schema
{'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'}}}
magnific_project_report
English markdown status report for a project/folder. Last 7 days default, max 30.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['reference'], 'properties': {'days': {'type': 'number'}, 'reference': {'type': 'string'}}}
magnific_spaces_create
Create empty Space. Share `space.webUrl`; only call `spaces_show` when inline preview is requested.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name'], 'properties': {'name': {'type': 'string'}, 'description': {'type': 'string'}}}
magnific_spaces_edit
External MCP only. Start headless Space edit. Poll `spaces_edit_status` until allTerminal, then verify with `spaces_state`.
Input schema
{'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'}}}}
magnific_spaces_edit_status
Wait for `spaces_edit` like `creations_wait`: long-polls up to `timeoutSeconds` (default 25, max 25). Snapshot-only when 0. Terminal → `spaces_state`.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'runId': {'type': 'string'}, 'threadId': {'type': 'string'}, 'operationId': {'type': 'string'}, 'timeoutSeconds': {'type': 'number'}}}
magnific_spaces_get_nodes
Read-only. Like `spaces_state` but scoped to `nodeIds` + their connections. Cheaper than full board. Needs view perm.
Read only Idempotent
Input schema
{'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'}}}
magnific_spaces_list
Lean spaces catalog as raw TOON text. Share each `webUrl`; call `spaces_show` only for inline canvas preview. Do not use `creations_search`.
Read only Idempotent
Input schema
{'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'}}}
magnific_spaces_run
Run Space workflow from `startNodeId`. Modes: singular, connected default, downstream. Poll with `spaces_run_status`.
Input schema
{'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'}}}
magnific_spaces_run_status
Poll `spaces_run`. `timeoutSeconds` long-polls up to 25s. In-progress returns `poll_after_seconds`; terminal call `creations_show`.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['workflowRunIdentifier'], 'properties': {'timeoutSeconds': {'type': 'number'}, 'workflowRunIdentifier': {'type': 'string'}}}
magnific_spaces_state
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.
Read only Idempotent
Input schema
{'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'}}}}
magnific_stock_download
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.
Input schema
{'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'}}}
magnific_stock_get
Full details for a single Freepik stock item: preview URL, dimensions, formats, author. Bulk support: accepts ids for batched execution.
Read only Idempotent
Input schema
{'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'}}}
magnific_stock_search
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.
Read only Idempotent
Input schema
{'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'}}}
magnific_stock_to_creation
Convert Freepik stock item → Pikaso creation. Use after user selects from stock_show. Bulk support: accepts ids for batched execution.
Input schema
{'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'}}}
magnific_video_concatenate
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.
Input schema
{'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'}}}}
magnific_video_generate
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.
Input schema
{'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'}}}
magnific_video_models_list
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.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'search': {'type': 'string'}, 'onlyRecommended': {'type': 'boolean'}}}
magnific_video_plan
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.
Read only Idempotent
Input schema
{'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'}}}}
magnific_video_speak
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`.
Input schema
{'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'}}}
magnific_video_upscale
Upscale video via Topaz or Magnific. Pass `creationIdentifier` or Freepik `videoUrl`. Params: `video_upscale_models_list`. Then call `creations_show`.
Input schema
{'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'}}}
magnific_video_upscale_models_list
Video upscale mode catalog as raw TOON text (topaz, magnific, magnific_precision) with required/optional params, ranges and enums. Read before calling `video_upscale`.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
marketplace
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.
Open world
Input schema
{'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': ''}}}
report_bug
Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
Idempotent
Input schema
{'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_version
Show the current MCP platform and adapter versions.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
toolkit_info
Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Added
authenticate
Sept. 17, 2026, 12:44 p.m.
Added
marketplace
Sept. 17, 2026, 12:44 p.m.
Added
toolkit_info
Sept. 17, 2026, 12:44 p.m.
Added
connect
Sept. 17, 2026, 12:44 p.m.
Added
report_bug
Sept. 17, 2026, 12:44 p.m.
Added
show_version
Sept. 17, 2026, 12:44 p.m.
Added
magnific_stock_to_creation
Sept. 17, 2026, 12:44 p.m.
Added
magnific_stock_download
Sept. 17, 2026, 12:44 p.m.
Added
magnific_stock_get
Sept. 17, 2026, 12:44 p.m.
Added
magnific_stock_search
Sept. 17, 2026, 12:44 p.m.
Added
magnific_flows_wait
Sept. 17, 2026, 12:44 p.m.
Added
magnific_flows_run
Sept. 17, 2026, 12:44 p.m.
Added
magnific_flows_get
Sept. 17, 2026, 12:44 p.m.
Added
magnific_flows_list
Sept. 17, 2026, 12:44 p.m.
Added
magnific_design_auto_layers
Sept. 17, 2026, 12:44 p.m.
Added
magnific_design_auto_resize
Sept. 17, 2026, 12:44 p.m.
Added
magnific_audio_voices_list
Sept. 17, 2026, 12:44 p.m.
Added
magnific_audio_music_generate
Sept. 17, 2026, 12:44 p.m.
Added
magnific_audio_tts
Sept. 17, 2026, 12:44 p.m.
Added
magnific_video_speak
Sept. 17, 2026, 12:44 p.m.
Added
magnific_video_concatenate
Sept. 17, 2026, 12:44 p.m.
Added
magnific_video_upscale_models_list
Sept. 17, 2026, 12:44 p.m.
Added
magnific_video_upscale
Sept. 17, 2026, 12:44 p.m.
Added
magnific_video_models_list
Sept. 17, 2026, 12:44 p.m.
Added
magnific_video_generate
Sept. 17, 2026, 12:44 p.m.
Added
magnific_video_plan
Sept. 17, 2026, 12:44 p.m.
Added
magnific_models3d_generate
Sept. 17, 2026, 12:44 p.m.
Added
magnific_library_create
Sept. 17, 2026, 12:44 p.m.
Added
magnific_library_list
Sept. 17, 2026, 12:44 p.m.
Added
magnific_images_models_list
Sept. 17, 2026, 12:44 p.m.