Bake3D MCP server

Connection

Use Streamable HTTP at https://bake3d.ai/api/v1/mcp with Authorization: Bearer YOUR_API_KEY. Create a key in Account → API keys; API access requires Pro or Studio, and a Free account receives HTTP 403. Store the key in the client’s credential configuration or environment, not in a prompt.

The endpoint negotiates MCP versions 2025-06-18 and 2025-11-25, returns JSON responses and does not require a persistent session. Send one JSON-RPC message per request; batch arrays are not accepted. Calls share the REST API’s rate limit, counted per account across all its keys (60 requests per minute by default); a 429 response carries Retry-After. Read the complete workflow guide.

Set up your client

Set BAKE3D_API_KEY (or the variable shown) to your key first. Every client uses the same endpoint and bearer header.

claude mcp add --transport http bake3d https://bake3d.ai/api/v1/mcp \
  --header "Authorization: Bearer $BAKE3D_API_KEY"

{
  "mcpServers": {
    "bake3d": {
      "url": "https://bake3d.ai/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:BAKE3D_API_KEY}"
      }
    }
  }
}

[mcp_servers.bake3d]
url = "https://bake3d.ai/api/v1/mcp"
bearer_token_env_var = "BAKE3D_API_KEY"

{
  "mcpServers": {
    "bake3d": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://bake3d.ai/api/v1/mcp",
        "--header",
        "Authorization: Bearer ${BAKE3D_KEY}"
      ],
      "env": {
        "BAKE3D_KEY": "bk_live_YOUR_KEY"
      }
    }
  }
}

Find an existing project

Use bake3d_list_projects to search the full account by title or category. It accepts q, filter (all, active, ready, needs-work), sort (updated, created, name), and limit (1–100; default 24, as the REST API). Pass the returned nextCursor as cursor with the same search options to continue. Stop when it is null. Start without a cursor to refresh the library after projects change. bake3d_get_project returns a compact summary by default; request detail: "full" only when you need skeleton labels or motion programs.

{
  "q": "vehicle",
  "filter": "ready",
  "sort": "name",
  "limit": 24
}

From job to playable animation

1. Call bake3d_generate with exactly one source. For a local file, call bake3d_upload_image first and pass its imageAssetId (several uploaded views of the same subject go in imageAssetIds). Pass imageUrls (one to four angles of the same subject, the first being the primary reference) when the user has several views; the job’s output.views says how many the geometry engine used, and a fallback engine keeps only the primary image. Rigged image bakes check the pose first: when limbs touch, cross or are cut off, the mesh is built from a prepared rig-ready picture of the same subject (included; output.posePrep says what happened). A reference sheet, collage, scene or text overlay is reduced to its main subject alone first. A subject caught mid-action or in a non-default posture (running, sitting, lying) is modelled in its default resting pose, and that action becomes the included animation (output.posePrep.state; a travelling action such as a run, gallop, crawl, slither or flight plays with the rig's own fitted gait when one fits); a text prompt that asks for an action works the same way. Extra views that show a different subject than the primary image are left out. Pass posePrep: false to keep the upload as it is, or generateViews: true with one image for generated side and back views. topology: "quads" ("Game-ready mesh") keeps the full-detail model and adds a rigged game-ready copy (about 7–10K faces, mostly quads, under 20K triangles) at the same price; export it with mesh: "game". On quality: "high", faithfulFace: true ("Faithful face") keeps eyes and face shape closer to the picture on people and human-like characters (an organic face with no muzzle, snout or beak) for 14 more credits, refunded when the subject has no such face or the standard High engine builds the mesh; it cannot be combined with quads. A text prompt must describe one 3D model (a character, creature, vehicle, machine, building, prop or prop set such as a chess set); a prompt for a whole game, an app, an open world or several unrelated characters returns error 422 before any charge, with a suggested single-subject prompt when the text has one. A picture or prompt that shows nudity or sexual content also returns 422 before any charge ("Bake3D doesn't accept nudity or sexual content…"); swimwear, armour, revealing costumes, creatures and stylised characters are fine. Rigged text bakes paint a rig-ready concept and check it the same way as an upload. Save the returned project ID and job ID.
2. Poll bake3d_get_job every 3–5 seconds until succeeded, failed or canceled. Inspect an error before retrying. If a job ID gets lost, bake3d_list_jobs lists your newest jobs, or one project’s.
3. Read the project and its initialAnimationId, or call bake3d_list_animations for the saved clips with their IDs, durations and kinds (initial, described, preset, edited). The generation workflow attempts an included introductory motion; bake3d_initial_animation can recover it. Use bake3d_animate when you want a different described action. It answers within about 45 seconds: with the saved animation (status: "succeeded"), or, while the motion is still being made, with status: "running" and a jobId. Then poll bake3d_get_job until it succeeds; its output.animationId names the animation. Do not call bake3d_animate again for the same motion: it was charged once, and a retry with the same idempotencyKey would only report the same job. bake3d_initial_animation is free and returns its own recovery job; while the bake or another job still runs on the project it answers with an error naming that job.
4. Call bake3d_export for the included motion, or pass a specific saved animation ID. Download the signed URL before its expiresAt (two hours), or request a fresh export link.

{
  "projectId": "YOUR_PROJECT_ID",
  "prompt": "Turn the head slowly and wag the tail gently",
  "durationSeconds": 4,
  "loop": true,
  "idempotencyKey": "5c1f0f8e-2d7b-4f7e-9d7a-1b2c3d4e5f60"
}

{
  "projectId": "YOUR_PROJECT_ID",
  "animationId": "YOUR_ANIMATION_ID",
  "fps": 30,
  "rootMotion": false,
  "heightMeters": 1.8
}

rootMotion: true (the default, except for USDZ) bakes planar travel and heading onto the ground-level motion_root joint, so an engine’s root-motion extraction moves the character while the hips keep bob and jump; rootMotion: false exports in place: motion_root stays still and horizontal travel is removed, while vertical motion such as a jump arc, and wheel roll, are kept. Export accepts 24, 30 or 60 fps. heightMeters scales the file so the character stands that tall. Every export stands on the ground plane, centred over the origin and facing +Z; its skeleton starts with an unweighted ground-level motion_root joint at the origin; and each clip records its fps, loop, rootMotion and duration in extras.bake3d. Choose a saved animationId or a presetId; omit both to use the included initial animation when available. Set restPose: true for an unanimated copy. Set format: "fbx" for a binary FBX 7.4 file (skeleton, skin weights with up to four influences per vertex, embedded base-colour, normal, roughness and metallic maps; verified in Blender 5.2 and Godot 4.7); pass animationIds instead of animationId to put several saved animations in one FBX, one take each. Set format: "usdz" for AR Quick Look and USD tools: one clip, in place unless rootMotion: true. Presets are fitted to the actual rig: bake3d_list_presets with projectId reports each preset as available with its amplitude and stride factors, unavailable with the reason, or pending while the fit is measured. Hand-authored gaits that a rig-fitted preset replaces are hidden unless you pass includeSuperseded: true. Included-motion recovery allows three jobs per rig per UTC day and six starts per account in 24 hours; it does not spend credits.

Editor import and limits

Bake3D returns the asset. An editor bridge, the Bake3D add-on or a manual import places it in your scene. See the Blender, Unity, Unreal and Godot instructions for setup and validation status. Signed download links need no API key and may be fetched from a browser or game engine on any origin.

Server animation export currently supports one skeleton, up to 256 joints, clips up to 30 seconds and source rigs up to 60 MiB (above 24 MiB, textures must be embedded in the GLB binary chunk). Motion composition accepts durations from 0.5 to 20 seconds. Review the rig and deformation before production use.