mcp-dir Magnific MCP
An MCP server for Magnific that allows AI agents to upscale images, generate variations, and list user creations using natural language. It connects to a user's Magnific account to utilize plan credits and provides tools for managing folders, uploads, and creation history.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://api.mcp.ai/p_magnificWhat its tools do
67 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (27)
magnific_account_balancemagnific_creations_waitmagnific_creations_getmagnific_creations_searchmagnific_creations_listmagnific_folders_listmagnific_folders_getmagnific_project_reportmagnific_spaces_listmagnific_spaces_statemagnific_spaces_get_nodesmagnific_spaces_run_statusmagnific_spaces_edit_statusmagnific_images_models_listmagnific_library_listmagnific_video_planmagnific_video_models_listmagnific_video_upscale_models_listmagnific_audio_voices_listmagnific_flows_listmagnific_flows_getmagnific_flows_waitmagnific_stock_searchmagnific_stock_getshow_versionconnecttoolkit_info
Can change data (40)
magnific_creations_request_uploadmagnific_creations_finalize_uploadmagnific_creations_upload_imagemagnific_creations_upload_filemagnific_creations_movemagnific_creations_likemagnific_creations_commentmagnific_folders_createmagnific_folders_renamemagnific_folders_deletemagnific_spaces_createmagnific_spaces_runmagnific_spaces_editmagnific_images_generatemagnific_images_remove_backgroundmagnific_images_upscalemagnific_images_skin_enhancermagnific_images_relightmagnific_images_change_cameramagnific_images_variationsmagnific_images_cropmagnific_images_resizemagnific_images_to_svgmagnific_images_generate_svgmagnific_library_createmagnific_models3d_generatemagnific_video_generatemagnific_video_upscalemagnific_video_concatenatemagnific_video_speakmagnific_audio_ttsmagnific_audio_music_generatemagnific_design_auto_resizemagnific_design_auto_layersmagnific_flows_runmagnific_stock_downloadmagnific_stock_to_creationreport_bugmarketplaceauthenticate
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Upscale images using natural language
- Generate variations of images
- List recent user creations
- Check account plan and credits
Source and maintenance
- Maintenance checked
Protocol and capabilities
- Server
- mcp-ai 0.9.410
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 67 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
67 advertised
magnific_account_balance
User plan + credits. Check before paid generations. Returns plan.{tier,productName,isUnlimitedMode}, credits.{available,totalPlan,spent,hasExtraCredits}. No history.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"title": "magnific_account_balance",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"identifiers"
],
"properties": {
"identifiers": {
"type": "array",
"items": {
"type": "string"
}
},
"timeoutSeconds": {
"type": "number"
}
}
}{
"title": "magnific_creations_wait",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}magnific_creations_get
Single creation complete data — metadata + URLs (`url` full-res, `previewUrl` ~1024px, `thumbnailUrl` ~400px).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"creationIdentifier"
],
"properties": {
"creationIdentifier": {
"type": "string"
}
}
}{
"title": "magnific_creations_get",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"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"
}
}
}
}{
"title": "magnific_creations_search",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}magnific_creations_list
Filterable gallery widget (image/video/audio). Use instead of `creations_search` when user wants to browse their library.
{
"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"
}
}
}
}{
"title": "magnific_creations_list",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}magnific_creations_request_upload
Step 1 for local/user files: get presigned PUT URL(s). Upload bytes outside MCP, then call `creations_finalize_upload`.
{
"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"
}
}
}{
"title": "magnific_creations_request_upload",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}magnific_creations_finalize_upload
Step 2 after PUT from `creations_request_upload`: convert temp path(s) to creations. Images <=25MB, videos <=200MB.
{
"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"
}
}
}
}
}
}{
"title": "magnific_creations_finalize_upload",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}magnific_creations_upload_image
Upload public image URL in one step. For local/user files use `creations_request_upload` then `creations_finalize_upload`.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string"
}
}
}{
"title": "magnific_creations_upload_image",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}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`.
{
"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"
}
}
}
}
}{
"title": "magnific_creations_upload_file",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}magnific_creations_move
Move creations into `targetFolderReference`. Identifiers from `images_generate`/`creations_search`. Foreign identifier → abort. Target folder must belong to user.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"targetFolderReference",
"creationIdentifiers"
],
"properties": {
"creationIdentifiers": {
"type": "array",
"items": {
"type": "string"
}
},
"targetFolderReference": {
"type": "string"
}
}
}{
"title": "magnific_creations_move",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}magnific_creations_like
Toggle heart/favorite reaction on a user-owned creation.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"creationIdentifier",
"folderReference"
],
"properties": {
"unlike": {
"type": "boolean"
},
"folderReference": {
"type": "string"
},
"creationIdentifier": {
"type": "string"
}
}
}{
"title": "magnific_creations_like",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}magnific_creations_comment
Add a comment (or reply) to a user-owned creation.
{
"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"
}
}
}{
"title": "magnific_creations_comment",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}magnific_folders_list
List folders/projects as raw TOON text. No params=top level; `onlyProjects`=projects; `parentReference`=children. Refs work with creations/folder tools.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"page": {
"type": "number"
},
"onlyProjects": {
"type": "boolean"
},
"parentReference": {
"type": "string"
}
}
}{
"title": "magnific_folders_list",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}magnific_folders_get
Fetch folder metadata by `reference`. Use before `creations_search` (`from=folder`). Foreign refs error.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"reference"
],
"properties": {
"reference": {
"type": "string"
}
}
}{
"title": "magnific_folders_get",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}magnific_folders_create
Create folder/project. No `parentReference`: workspace root. `type` defaults: project at root, folder when nested.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"type": {
"type": "string"
},
"parentReference": {
"type": "string"
}
}
}{
"title": "magnific_folders_create",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}magnific_folders_rename
Rename a folder by `reference`.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"reference",
"name"
],
"properties": {
"name": {
"type": "string"
},
"reference": {
"type": "string"
}
}
}{
"title": "magnific_folders_rename",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}magnific_folders_delete
Move a folder and its files to trash.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"reference"
],
"properties": {
"reference": {
"type": "string"
}
}
}{
"title": "magnific_folders_delete",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}magnific_project_report
English markdown status report for a project/folder. Last 7 days default, max 30.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"reference"
],
"properties": {
"days": {
"type": "number"
},
"reference": {
"type": "string"
}
}
}{
"title": "magnific_project_report",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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`.
{
"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"
}
}
}{
"title": "magnific_spaces_list",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}magnific_spaces_create
Create empty Space. Share `space.webUrl`; only call `spaces_show` when inline preview is requested.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"description": {
"type": "string"
}
}
}{
"title": "magnific_spaces_create",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}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.
{
"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"
}
}
}
}{
"title": "magnific_spaces_state",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}magnific_spaces_get_nodes
Read-only. Like `spaces_state` but scoped to `nodeIds` + their connections. Cheaper than full board. Needs view perm.
{
"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"
}
}
}{
"title": "magnific_spaces_get_nodes",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}magnific_spaces_run
Run Space workflow from `startNodeId`. Modes: singular, connected default, downstream. Poll with `spaces_run_status`.
{
"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"
}
}
}{
"title": "magnific_spaces_run",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}magnific_spaces_run_status
Poll `spaces_run`. `timeoutSeconds` long-polls up to 25s. In-progress returns `poll_after_seconds`; terminal call `creations_show`.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workflowRunIdentifier"
],
"properties": {
"timeoutSeconds": {
"type": "number"
},
"workflowRunIdentifier": {
"type": "string"
}
}
}{
"title": "magnific_spaces_run_status",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}magnific_spaces_edit
External MCP only. Start headless Space edit. Poll `spaces_edit_status` until allTerminal, then verify with `spaces_state`.
{
"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"
}
}
}
}{
"title": "magnific_spaces_edit",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}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`.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"runId": {
"type": "string"
},
"threadId": {
"type": "string"
},
"operationId": {
"type": "string"
},
"timeoutSeconds": {
"type": "number"
}
}
}{
"title": "magnific_spaces_edit_status",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"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"
}
}
}{
"title": "magnific_images_generate",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}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".
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"creationIdentifier"
],
"properties": {
"folderReference": {
"type": "string"
},
"creationIdentifier": {
"type": "string"
}
}
}{
"title": "magnific_images_remove_background",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}magnific_images_upscale
AI upscale 2x/4x (Magnific, premium). Exact pixels: `images_resize`. Aspect: `images_crop`. Default scale=2.
{
"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"
}
}
}{
"title": "magnific_images_upscale",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}magnific_images_skin_enhancer
AI skin enhancer. faithful preserves identity; creative reinterprets; flexible uses presets. Defaults: faithful, sharpen=0, smartGrain=0.
{
"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"
}
}
}{
"title": "magnific_images_skin_enhancer",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}magnific_images_relight
AI relight. 1-4 lights with azimuth/elevation enums, type neutral|gel, intensity 1-10. Gel uses hex `color`.
{
"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"
}
}
}{
"title": "magnific_images_relight",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}magnific_images_change_camera
Reframe camera around subject. Defaults: rotate=45, vertical=0, closeup=5.
{
"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"
}
}
}{
"title": "magnific_images_change_camera",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}magnific_images_variations
Generate image-variation grid. Modes: angles|demographics|expressions|age|storyboard|custom. Defaults: angles, 3x3, 1:1, 4k.
{
"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"
}
}
}
}{
"title": "magnific_images_variations",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}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.
{
"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"
}
}
}{
"title": "magnific_images_crop",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}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.
{
"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"
}
}
}{
"title": "magnific_images_resize",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}magnific_images_to_svg
Trace raster creation into SVG. New vector from prompt: `images_generate_svg`.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"creationIdentifier"
],
"properties": {
"folderReference": {
"type": "string"
},
"creationIdentifier": {
"type": "string"
}
}
}{
"title": "magnific_images_to_svg",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}magnific_images_generate_svg
Text-to-SVG (Recraft v4 Pro Vector). Raster: `images_generate`. Trace existing raster: `images_to_svg`. Default aspectRatio=1:1.
{
"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"
}
}
}{
"title": "magnific_images_generate_svg",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}magnific_images_models_list
TTI model catalog as lean TOON text. `search` filters by name, slug, description, or tags.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"search": {
"type": "string"
},
"onlyRecommended": {
"type": "boolean"
}
}
}{
"title": "magnific_images_models_list",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}magnific_library_list
Lean library catalog (characters, styles, elements, locations) for agent reasoning. Picker assets use library://.
{
"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"
}
}
}{
"title": "magnific_library_list",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"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"
}
}
}{
"title": "magnific_library_create",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}magnific_models3d_generate
Image-to-3D GLB. Upload external images first. Animate with `models3d_rig`. Models: tripo-p1 default, tripo-v31, trellis-2.
{
"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"
}
}
}{
"title": "magnific_models3d_generate",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}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.
{
"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"
}
}
}
}{
"title": "magnific_video_plan",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"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"
}
}
}{
"title": "magnific_video_generate",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"search": {
"type": "string"
},
"onlyRecommended": {
"type": "boolean"
}
}
}{
"title": "magnific_video_models_list",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}magnific_video_upscale
Upscale video via Topaz or Magnific. Pass `creationIdentifier` or Freepik `videoUrl`. Params: `video_upscale_models_list`. Then call `creations_show`.
{
"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"
}
}
}{
"title": "magnific_video_upscale",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}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`.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"title": "magnific_video_upscale_models_list",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"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"
}
}
}
}{
"title": "magnific_video_concatenate",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}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`.
{
"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"
}
}
}{
"title": "magnific_video_speak",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}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).
{
"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"
}
}
}{
"title": "magnific_audio_tts",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}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.
{
"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"
}
}
}{
"title": "magnific_audio_music_generate",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"search": {
"type": "string"
}
}
}{
"title": "magnific_audio_voices_list",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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`.
{
"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"
}
}
}{
"title": "magnific_design_auto_resize",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}magnific_design_auto_layers
Extract editable layers from a flat image into a Pikaso design.
{
"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"
}
}
}{
"title": "magnific_design_auto_layers",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}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.
{
"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"
}
}
}{
"title": "magnific_flows_list",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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`.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"identifier"
],
"properties": {
"identifier": {
"type": "string"
}
}
}{
"title": "magnific_flows_get",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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`.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"identifier",
"inputs"
],
"properties": {
"inputs": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"identifier": {
"type": "string"
}
}
}{
"title": "magnific_flows_run",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}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`.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workflowRunIdentifier"
],
"properties": {
"timeoutSeconds": {
"type": "number"
},
"workflowRunIdentifier": {
"type": "string"
}
}
}{
"title": "magnific_flows_wait",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"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"
}
}
}{
"title": "magnific_stock_search",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}magnific_stock_get
Full details for a single Freepik stock item: preview URL, dimensions, formats, author. Bulk support: accepts ids for batched execution.
{
"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"
}
}
}{
"title": "magnific_stock_get",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"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"
}
}
}{
"title": "magnific_stock_download",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}magnific_stock_to_creation
Convert Freepik stock item → Pikaso creation. Use after user selects from stock_show. Bulk support: accepts ids for batched execution.
{
"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"
}
}
}{
"title": "magnific_stock_to_creation",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}show_version
Show the current MCP platform and adapter versions.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"title": "Show Version",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}report_bug
Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"message"
],
"properties": {
"context": {
"type": "string",
"default": ""
},
"message": {
"type": "string"
},
"conversation": {
"type": "string",
"default": "[]"
}
}
}{
"title": "Report Bug",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"title": "Connection Status",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"title": "Toolkit Info",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"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": ""
}
}
}{
"title": "Marketplace",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"token": {
"type": "string"
}
}
}{
"title": "Authenticate",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 509 ms
- 95th percentile latency
- 509 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 509 ms · metadata changed · 67 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http magnific-mcp https://api.mcp.ai/p_magnificCodex
codex mcp add magnific-mcp --url https://api.mcp.ai/p_magnificCursor
{
"mcpServers": {
"magnific-mcp": {
"url": "https://api.mcp.ai/p_magnific"
}
}
}Cline
{
"mcpServers": {
"magnific-mcp": {
"type": "streamableHttp",
"url": "https://api.mcp.ai/p_magnific",
"disabled": false
}
}
}VS Code
{
"servers": {
"magnific-mcp": {
"type": "http",
"url": "https://api.mcp.ai/p_magnific"
}
}
}Gemini CLI
gemini mcp add --transport http magnific-mcp https://api.mcp.ai/p_magnificClaude Desktop
https://api.mcp.ai/p_magnificWindsurf
{
"mcpServers": {
"magnific-mcp": {
"serverUrl": "https://api.mcp.ai/p_magnific"
}
}
}Let your agent find its tools
Find servers like mcp-dir Magnific MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.