Skip to content
Going further

MCP and the API

How each MCP tool maps to the Agents API, for teams moving from a chat assistant to their own product.

The Luma MCP server runs on the same sessions, runs and apps as this API.

MCP toolAPI route
luma_workspace_listGET /v1/scopes
luma_session_openPOST /v1/scopes + POST /v1/sessions
luma_session_send_briefPOST /v1/sessions/{id}/events with user.message
luma_session_run_capabilityPOST /v1/sessions/{id}/events, a user.message with capability
luma_session_awaitGET /v1/sessions/{id}/events/stream
luma_run_respondPOST /v1/sessions/{id}/runs/{run_id}/tool-response
luma_generate_image, luma_generate_videoPOST /v1/sessions/{id}/runs with kind: "generate"
luma_capability_list, luma_capability_describeGET /v1/apps, GET /v1/apps/{slug}
luma_session_cancelDELETE /v1/sessions/{id}