--- title: MCP and the API | Luma Agents description: How each MCP tool maps to the Agents API, for teams moving from a chat assistant to their own product. --- The [Luma MCP server](/mcp/index.md) runs on the same sessions, runs and apps as this API. | MCP tool | API route | | -------------------------------------------------- | ------------------------------------------------------------------- | | `luma_workspace_list` | `GET /v1/scopes` | | `luma_session_open` | `POST /v1/scopes` + `POST /v1/sessions` | | `luma_session_send_brief` | `POST /v1/sessions/{id}/events` with `user.message` | | `luma_session_run_capability` | `POST /v1/sessions/{id}/events`, a `user.message` with `capability` | | `luma_session_await` | `GET /v1/sessions/{id}/events/stream` | | `luma_run_respond` | `POST /v1/sessions/{id}/runs/{run_id}/tool-response` | | `luma_generate_image`, `luma_generate_video` | `POST /v1/sessions/{id}/runs` with `kind: "generate"` | | `luma_capability_list`, `luma_capability_describe` | `GET /v1/apps`, `GET /v1/apps/{slug}` | | `luma_session_cancel` | `DELETE /v1/sessions/{id}` |