Fetch an MCP endpoint

GET

/v1/mcp/endpoints/{endpointId}

curl --request GET \
  --url https://example.com/v1/mcp/endpoints/example \
  --header 'Authorization: Bearer <token>'

• Same-origin — path relative to the deployment root.

Returns the wire-safe MCPEndpoint (secrets never cross the wire — secretRef names a secret the runtime resolves inside the deployment).

Authorizations

• bearerAuth

Parameters

Path Parameters

endpointId

required

string

>= 1 characters

MCPEndpointId — deployment-stable string identifier chosen by the caller.

Responses

200

MCP endpoint.

Media typeapplication/json

object

endpointId

required

string

>= 1 characters

name

required

Human-readable display name.

string

>= 1 characters

transport

required

MCP transport variant. stdio — local subprocess (spawn a command). http-sse — the older MCP HTTP+SSE transport (separate POST + SSE endpoints). streamable-http — the Streamable HTTP transport (single endpoint, session id via header).

string

Allowed values: stdio http-sse streamable-http

config

required

One of:

object

object

transport

required

Allowed value: stdio

command

required

string

>= 1 characters

args

Array<string>

env

object

key

additional properties

string

object

object

transport

required

Allowed value: http-sse

url

required

string format: uri

sseUrl

Optional distinct SSE endpoint if the server splits them.

string format: uri

headers

object

key

additional properties

string

object

object

transport

required

Allowed value: streamable-http

url

required

string format: uri

headers

object

key

additional properties

string

secretRef

The secret an MCP endpoint authenticates with: a name in the deployment’s secrets store, resolved at the endpoint’s tenant scope when the runtime connects (the shape webhooks and providers use). It is sent as the endpoint’s bearer. The endpoint keeps only this reference.

object

envName

required

string

/^[a-z][a-z0-9-]{0,62}$/

name

required

string

>= 1 characters <= 256 characters

instructions

Optional pass-through to the MCP client serverInfo.instructions.

string

metadata

Optional caller-defined metadata bag.

object

key

additional properties

any

Example

{
  "transport": "stdio",
  "config": {
    "transport": "stdio"
  }
}

401

Missing / malformed / expired / revoked bearer token.

Media typeapplication/json

object

error

required

object

code

required

Stable machine-readable discriminant. Values match domain error codes (see docs/API-ROUTE-CONVENTIONS.md §4.3).

string

message

required

string

details

Optional, kind-specific.

object

key

additional properties

any

requestId

required

Server-assigned request id; also echoed via X-Request-Id header.

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "details": {},
    "requestId": "example"
  }
}

404

No MCP endpoint with that id under this tenant.

Media typeapplication/json

object

error

required

object

code

required

Stable machine-readable discriminant. Values match domain error codes (see docs/API-ROUTE-CONVENTIONS.md §4.3).

string

message

required

string

details

Optional, kind-specific.

object

key

additional properties

any

requestId

required

Server-assigned request id; also echoed via X-Request-Id header.

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "details": {},
    "requestId": "example"
  }
}