MCP Quickstart

Get a first scenario rendered through the connector. This assumes you have already followed Setup MCP Connection and verified it is live.

Your first scenario

A good first task, which exercises most of the connector, is to work from one of the published example scenarios:

Find a Bifrost sample dataset with ships in it, read how it is built, then make me a notebook like it with a container ship in heavy fog. Render 20 frames and show me one.

Under the hood the assistant will typically:

  1. Call list_sample_datasets and get_sample_dataset to read a worked example.

  2. Call get_authoring_guide for the house rules on writing notebook source.

  3. Call search_assets and list_env_presets to pick the ship and the weather.

  4. Call create_notebook in one of your worlds, then render_notebook.

  5. Poll get_collection until the render completes, then view_frame_image to show you a frame.

Good to know

  • Renders cost credits. render_notebook starts a real offline render, which spends your organization’s credits. Depending on how your organization is billed, a render may be refused once they run out. The assistant can tell you where you stand before you commit to a long render: ask what credits are left, or what a notebook has cost so far, and it will call get_credit_summary or list_credit_usage.

  • A render is a snapshot. The notebook source is frozen when the render is dispatched, so editing the notebook afterwards does not affect a render in flight.

  • Editing replaces the source. update_notebook overwrites a notebook’s contents outright, and notebooks are shared across your organization. Ask the assistant to create a new notebook rather than edit an existing one unless you mean to change that one. If the notebook is open in the editor, the edit is refused rather than applied.

  • Images are for looking, not downloading. view_frame_image and the thumbnail tools return a downsized preview for the assistant to see. Use the platform’s dataset download for full-resolution originals.

  • Request size. A single call may not exceed 10 MiB, which in practice bounds how large a notebook the assistant can write in one go.

Troubleshooting

Symptom

What it means

The client asks you to sign in again

Your access token expired or was revoked. Re-authenticate; on the web this is the Connect button on the connector, in Claude Code it is /mcp.

Every call is refused as unauthorized, right after signing in

The Bifrost account you signed in with has no platform access yet. Ask your organization’s admin to add you.

A world is refused

The assistant used a world your organization cannot access. Ask it to call list_worlds and pick from that list.

A render is refused for insufficient credits

Your organization has no render credits left. Nothing was rendered. Ask for a credit summary to see what remains before retrying.

An edit is refused because the notebook is in use

Someone has that notebook open in the editor, and the edit was rejected rather than allowed to overwrite theirs. Close it, or work on a copy.

A frame has no image

Only completed frames have one, and depth captures have no viewable rendering. Wait for the render, or ask for a different capture.