---
title: "The sandbox's MCP servers, their state and fresh URLs."
method: GET
path: "/v1/sandboxes/{id}/mcp"
tags: ["mcp"]
---

# The sandbox's MCP servers, their state and fresh URLs.

`GET /v1/sandboxes/{id}/mcp`

## Request

- Base URL: `https://api.withruntime.com`
- URL: `https://api.withruntime.com/v1/sandboxes/{id}/mcp`
- Auth: HTTP bearer

## Path parameters

- `id` string, required: Resource identifier (UUID).

## Response `200`

Success

- object
  - `running` boolean, required
  - `port` integer, nullable
  - `public` boolean: The URLs are a public preview: no link token, no expiry.
  - `token` string: Send it as Authorization: Bearer <token>.
  - `headers` object: The headers every MCP request needs.
  - `urlExpiresAt` string, nullable: When the URLs' link token expires; read again for new ones. null for public URLs, which do not expire.
  - `servers` object[], required
    - `name` string, required
    - `status` 'installing' | 'ready' | 'failed', required
    - `message` string, nullable
    - `url` string, nullable: The server's Streamable HTTP endpoint.
  - `warnings` string[]

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/withruntime/apis/runtime-cloud-api.md) · [All operations](https://skmtc.dev/withruntime/apis/runtime-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/withruntime/apis/runtime-cloud-api/revisions/6f4012286988?raw)