> For the complete documentation index, see [llms.txt](https://dsg-3.gitbook.io/dsg-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dsg-3.gitbook.io/dsg-docs/cinema-proof-agent/runtime-and-integrations/api-and-mcp-reference.md).

# API and MCP Reference

Current DSG production MCP edge, Cinema runtime boundary, and governed API contract notes. Historical Azure base URLs are not current production.

### Production boundary

Public production edge:

`https://aws.dsg.pics`

Production MCP:

`POST https://aws.dsg.pics/mcp`

Customer product/workspace entry:

`https://dsg.pics/dsg/workroom`

Cinema itself is currently running as `aws-cinema-1` on the AWS production host and returns HTTP 200 from its internal `/health` endpoint with `status=ready` and `backend=ready`.

### Governance rule

MCP, REST, BrowserOS, RDC, CLI, or API transports are execution surfaces. They do not replace Spacetime plan/Route/payload/permission/approval checks.

### Cinema REST contract

The Cinema codebase defines governed REST operations for plans, preflight, executions, evidence, verification, proofs, and remote-browser control. Availability of any specific REST path at the public edge must be proven on the current routing layer before it is documented as a live public endpoint.

Representative contract paths include:

```
POST /api/v1/plans
POST /api/v1/plans/{id}/approve
POST /api/v1/control/preflight
POST /api/v1/executions
POST /api/v1/executions/{id}/evidence
POST /api/v1/executions/{id}/verify
GET  /api/v1/proofs/{id}
```

### Spacetime MCP

Current production MCP protocol health reports `2025-06-18`.

The governed MCP surface includes discovery, compose, execution, approval and evidence-verification operations. Route registration does not prove an external provider is online.

### Current claim boundary

* Cinema runtime health: verified.
* Spacetime runtime health: verified.
* Governed RDC acceptance: PASS, run `36991572295`.
* Authenticated Workroom/Cinema user E2E: OPEN.
* Promoted-source public governed MCP closeout: PARTIAL / OPEN.
* Promoted-source XR state smoke: OPEN.
* Whole-system release: `PENDING_REVERIFY`.

### Historical Azure API base

`https://dsg-cinema-production.nicetree-a005fe99.westus3.azurecontainerapps.io`

This URL is retained only as dated historical deployment evidence. Do not use it as the current production base.
