Beam logoBeam

Agent Integration

MCP exposes the same Beam core to agents.

Agents call Beam tools for design context, node images, assets, variables, and visual comparison without duplicating Figma or cache behavior.

beam init --print emits MCP configuration that starts beam mcp. Supported clients can then launch Beam as a local MCP server.

The intended workflow is simple: the user gives an agent a Figma URL, the agent requests design context, downloads assets when needed, builds the UI, and asks Beam for comparison signals.

Beam does not assume a framework. It returns structured evidence, warnings, paths, and contracts so Codex, Claude Code, Cursor, Copilot, and other MCP clients can decide how to build.

json
1{2  "mcpServers": {3    "beam": {4      "command": "beam",5      "args": ["mcp"]6    }7  }8}

Run Sequence

  1. Run beam login so MCP tools can access Figma when live fetches are needed.
  2. Run beam init --print and review the MCP configuration.
  3. Add the config to the coding agent or run a supported beam init --client <name> adapter.
  4. Restart the agent so it loads the Beam server.
  5. Ask the agent to build from a Figma frame URL using Beam.

Expected Output

The agent should discover Beam tools, call get_design_context, optionally request node images and assets, build the UI, and call compare when a local URL is available.

Files And Artifacts

  1. Agent MCP settings file
  2. .beam/cache/briefs/<snapshot-id>.json
  3. .beam/cache/images/<snapshot-id>.png
  4. .beam/cache/assets/<snapshot-id>.manifest.json

Next Step

Use the MCP tool grid to understand what the agent can request from Beam during implementation.

Recovery Paths

  1. If the agent does not list Beam tools, verify its MCP config and restart the agent.
  2. If Beam works in terminal but not inside the agent, check PATH differences between shell and agent process.
  3. If an MCP response says data is missing, follow the clarification request instead of asking the agent to guess.
get_design_contextget_node_imagelist_assetsdownload_assetsget_file_variablescompare_render