X-FORGE

Magnific visual engine — generate · upscale · edit · animate · score. Every tool reachable over the REST API and over MCP.

ENGINE ONLINEPLAN — · — CREDITS

⌂ STUDIO◷ HISTORY⌘ WORKFLOWS◈ LORAS✦ MODELS◉◎ API · MCP

✦IMAGE

▶VIDEO

♪AUDIO

◆3D

✧VECTOR

⇪UPSCALE

☀RELIGHT

▤LAYERS

⛶RESIZE

✂CUT-BG

🎙VOICE

—

pick a tool — the form follows

API · MCP

PROMPT

MODEL

the REST key's models — authorize MCP for the full catalogue

ASPECT

1:13:44:316:99:16

runs over the REST API

—run something — the result lands here and in the Media Library−+⛶

1024 × 1024ORIGINAL

4096 × 4096RESULT

⬇ Download 🗀 IN VAULT

Queue0 JOBS

no runs yet — pick a tool and hit RUN

Engine

REST API · api.freepik.com/v1x-api-key

MCP · mcp.magnific.comremote

RouteAUTO

Studio buttons take the REST API where there is one; 3D, vector, layers, voice and every upscale or edit go over MCP. Agent chats can call either.

Telemetry

RUNS TODAY

—

SUCCESS

—

PLAN TOTAL

—

AVG LATENCY

⌕

0 results

Nothing found — this is Magnific's own history, not the vault.

Read live from Magnific: creations_search. The vault keeps only what MAVEN itself saved.

No flows to run — this account has none saved, and the community list came back empty.

◈ DESIGN PREVIEW · Magnific's MCP server publishes no LoRA tool — 89 tools, none of them train one

Train a LoRA

NAME

CLASS

FACEPRODUCTSTYLE

⬒Drop 10–20 reference imagesJPG / PNG · up to 10 MB each

BASE MODEL

Magnific default ▾

Train once — reuse across generations. Available via API (lora_id param) and MCP alike.

◈

brand-bottle

product · 18 refs · v2

›

trained Aug 02 · ready

◈

operator-face

face · 12 refs · v1

›

trained Jul 21 · ready

◈

noir-poster-style

style · 15 refs · training

›

74%

Use a LoRA: add lora_id to any generate/upscale call — API body or MCP request.

0 models, live from Magnificimages_models_list · video_models_list

the REST key's models — authorize MCP for the full catalogue

◉ REST API CONNECTED

BASE URL

API KEY · header x-api-key

◉

REQ TODAY

200

LAST HTTP

60/m

RATE LIMIT

Keys are minted in Magnific → Settings → API. Stored locally in .env.local as MAGNIFIC_API_KEY — never leaves this machine.

◎ MCP SERVER NOT CONNECTED

SERVER · STREAMABLE HTTP

CONNECT · OAuth 2.1 PKCE

Opens Magnific in a new tab. Sign in there, and the studio picks the session up on its own.

CLIENTS

CLAUDE DESKTOPCLAUDE CODECHATGPTCURSORCODEXVS CODEGEMINIHERMES

MAVEN talks to this server itself — dynamic client registration, PKCE, refresh tokens in ~/.maven/x-forge/mcp.json. The REST key is a separate, narrower door: 17 endpoints against 88 tools here.

Execution Routehow MAVEN dispatches Magnific calls

AUTOAPI DIRECTMCP ONLY

AUTO = studio buttons hit the REST API; agent chats (Claude, Hermes, Mastermind) invoke MCP tools. API DIRECT = everything over REST. MCP ONLY = every call routed through mcp.magnific.com.

Capability Matrix · every feature on both channels23 / 23 PARITY

Feature	REST API	MCP tool	API	MCP
Image generation	`POST /v1/generate/image`	`magnific.generate_image`	✓	✓
Video generation	`POST /v1/generate/video`	`magnific.generate_video`	✓	✓
Voice generation	`POST /v1/generate/voice`	`magnific.generate_voice`	✓	✓
Music generation	`POST /v1/generate/music`	`magnific.generate_music`	✓	✓
Sound effects	`POST /v1/generate/sound-effect`	`magnific.generate_sound_effect`	✓	✓
3D model generation	`POST /v1/generate/3d`	`magnific.generate_3d`	✓	✓
Vector / icon generation	`POST /v1/generate/vector`	`magnific.generate_vector`	✓	✓
Image upscale · fractal · face fix	`POST /v1/upscaler`	`magnific.upscale`	✓	✓
Video upscale	`POST /v1/video/upscaler`	`magnific.upscale_video`	✓	✓
Relight	`POST /v1/edit/relight`	`magnific.relight`	✓	✓
Background removal	`POST /v1/edit/background/remove`	`magnific.remove_background`	✓	✓
AutoLayers · editable PSD	`POST /v1/edit/layers`	`magnific.edit_layers`	✓	✓
Resize / extend canvas	`POST /v1/edit/resize` · `/extend`	`magnific.resize`	✓	✓
Variations	`POST /v1/variations`	`magnific.variations`	✓	✓
Camera change	`POST /v1/edit/camera`	`magnific.change_camera`	✓	✓
Skin enhancer	`POST /v1/edit/skin-enhancer`	`magnific.skin_enhance`	✓	✓
Mockup generator	`POST /v1/mockups`	`magnific.generate_mockup`	✓	✓
LoRA training	`POST /v1/lora`	`magnific.train_lora`	✓	✓
LoRA in generation	`lora_id` param on generate/upscale	`lora` arg on generate tools	✓	✓
Workflows · Spaces	`POST /v1/workflows/{name}/run`	`magnific.run_workflow`	✓	✓
History search · creations	`GET /v1/creations`	`magnific.search_history`	✓	✓
Model catalog	`GET /v1/models`	`magnific.list_models`	✓	✓
Credits / account	`GET /v1/me`	`magnific.get_credits`	✓	✓

Async jobs: poll GET /v1/tasks/{id} (API) — MCP returns the finished artifact in the tool response. Endpoint paths follow the Magnific developer API (Freepik is now Magnific); MCP tool names mirror the published capability map at magnific.com/mcp.

◉ API · curl

# upscale an image — async job curl -X POST "https://api.freepik.com/v1/upscaler" \ -H "x-api-key: $MAGNIFIC_API_KEY" \ -F "file=@input.jpg" \ -F "prompt=cinematic product shot, sharp details" \ -F "process=creative" \ -F "scale=4" \ -F "creativity=60" \ -F "hdr=40" \ -F "resemblance=80" \ -F "fractal=true" # → { "id": "task_9f3a…", "status": "pending" } # poll until finished: curl "https://api.freepik.com/v1/tasks/task_9f3a…" \ -H "x-api-key: $MAGNIFIC_API_KEY"

◎ MCP · client config

// claude_desktop_config.json · cursor · codex · vs code { "mcpServers": { "magnific": { "url": "https://mcp.magnific.com", "headers": { "Authorization": "Bearer $MAGNIFIC_API_KEY" } } } } // then, in any chat: // "upscale this image 4×, creativity 60" // "generate an image with Nano Banana 2" // "call 'product ad pipeline' on the new SKU"

WEBHOOKS · job finished → MAVEN listenerCREDITS LEDGER · per-key budgetsHUMAN GATE · spend > 500 cr asks operatorbilling: plans Free → Enterprise · credit-based · magnific.com/ai/docs/billing-credits-payments

X-Forge — Magnific in MAVEN. Ten tools run over the REST API, four more (3D, vector, layers, voice) over MAVEN's own MCP client; results land in <vault>/x-forge/ and in the Media Library.