Open a completed skeletal video project, choose Enhance with AI, then Connect your AI. Copy the project connection link and add it in a compatible assistant’s connector / remote MCP settings. Sign in to blenDojo and approve this project. Copy the starter request into your assistant, then return to Review AI draft to compare Original and AI / my draft before applying a rebake.
The hosted endpoint is https://blendojo.com/mcp/{job_id}. It uses Streamable HTTP with OAuth discovery, authorization code + S256 PKCE, and public client registration. Connections expire after seven days; access tokens last up to one hour and refresh tokens rotate. Default approval allows drafts only. Queued rebakes require a separate explicit checkbox on the approval screen. Disconnect assistant revokes the whole project connection.
Your assistant needs remote MCP with OAuth sign-in support. Third-party clients have different setup screens and plan restrictions; universal client compatibility is not claimed. No LLM inference is included in the connection.
If your client requires a local process, create an advanced token in the editor and download the Python adapter. This legacy 24-hour project token permits draft edits and queued rebakes.
Python 3 is required on the machine running your MCP client. No Python packages are needed. Add the generated configuration to your client, replacing the adapter path with the downloaded file's absolute path. Use python instead of python3 if your installation requires it. Your inference runs through your chosen model provider; blenDojo does not supply an LLM through this connection.
{
"mcpServers": {
"blendojo": {
"command": "python3",
"args": ["/absolute/path/to/blendojo-editor-mcp.py"],
"env": {
"BLENDOJO_URL": "https://blendojo.com",
"BLENDOJO_JOB": "YOUR_32_CHARACTER_PROJECT_ID",
"BLENDOJO_EDITOR_TOKEN": "YOUR_PROJECT_TOKEN"
}
}
}
}The adapter uses MCP stdio transport. It exposes get_rig, get_draft, set_joint, set_pose, paint_weights, replace_draft, source_frame, preview_frame, schedule_rebake and list_rebakes. Source and preview tools return images to vision-capable clients. Preview images are orthographic geometry/skeleton diagnostics, not textured renders.
Base: /api/jobs/{job_id}/editor/. Send Authorization: Bearer YOUR_PROJECT_TOKEN. Use HTTPS. Browser editor requests use your existing session. Tokens cannot access billing, other projects, or create more tokens.
| Method/path | Purpose |
|---|---|
| GET rig | Mesh, bone hierarchy, animation transforms, source-frame mapping and draft |
| GET / PUT draft | Read or replace the versioned draft |
| GET source/{frame} | Corresponding source PNG |
| GET preview/{frame}?view=front | Saved draft PNG; front, side or back |
| POST rebake | Queue the saved version; body {"version": 1} |
| GET rebakes | Status and resulting project links |
All indices are zero-based. Coordinates are Y-up model space; rotations are XYZ Euler degrees (extrinsic). Read the rig's times and source_frames arrays: looping may have retimed the source. Rest edits move a bone's head and tail together; connected parent tails follow. Existing weights are preserved. Pose transforms act around the selected bone's current head and propagate to descendants. Corrections blend linearly to zero outside the selected radius; they do not wrap across the loop seam.
{
"version": 0,
"rest": [{"bone": 11, "position": [0.1, -0.4, 0.0]}],
"poses": [{"bone": 11, "frame": 16, "rotation": [15, 0, 0],
"translation": [0, 0, 0], "radius": 3}],
"weights": [{"vertex": 123, "values": [0, 1, 0]}]
}The example weight vector is illustrative: supply exactly one value per bone in your rig, nonnegative and summing to one. Weight assignments replace complete rows. Each successful save increments version. A stale save returns 409; reload and reconcile changes rather than overwriting another editor's draft.
Interactive deformation previews run in your browser. API previews use a small CPU renderer; no inference or Blender runs on a draft save. Rebakes use the shared queue and export a separate project, preserving the original. Repeated requests for the same saved version return the same job. Limits: one active rebake per project, six rebakes per account per hour, 240 editor requests per account per minute, and an 8 MB edit payload. Joint edits, weight painting and draft previews are free through the editor, API and MCP. Each new rebake costs 30 blenDojo credits, charged when queued. Insufficient credits prevent queuing; failed or cancelled rebakes refund the charge. Repeating a request for the same draft version returns the existing job without another charge. An unsuccessful rebake can be retried by saving a new draft version.
Automatic contact correction is not reapplied after your edits; inspect neighboring frames and loop boundaries. Armor remains rigid only where weights and geometry support rigid motion. Saving a draft does not establish physical correctness.