Server Run

Each time an MCP server is executed by the Metorial platform, a server run is created. This allows you to track the execution of MCP servers, including their status and associated sessions. Metorial may create multiple server runs for a single session or session connection.

Server Run object

Attributes

object

String

id

String

The unique identifier of the server run

type

Enum

The type of the server run

status

Enum

The current status of the server run

server_version_id

String

The unique identifier of the server version associated with this run

server

Object

server_deployment

Object

server_session

Object

created_at

Date

Timestamp when the server run was created

updated_at

Date

Timestamp when the server run was last updated

started_at

DateNullable

Timestamp when the server run was started

stopped_at

DateNullable

Timestamp when the server run was stopped

{
  "object": "server.server_run",
  "type": "hosted",
  "status": "active",
  "server": {
    "object": "server#preview",
    "type": "public"
  },
  "server_deployment": {
    "object": "server.server_deployment#preview",
    "metadata": {},
    "server": {
      "object": "server#preview",
      "type": "public"
    }
  },
  "server_session": {
    "object": "session.server_session#preview",
    "status": "active",
    "mcp": {
      "object": "mcp",
      "connection_type": "sse",
      "client": {
        "object": "session.server_session.client",
        "capabilities": {}
      },
      "server": {
        "object": "session.server_session.server",
        "capabilities": {}
      }
    },
    "usage": {}
  }
}

List server runs

List all server runs

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

status

UnionOptional

server_session_id

UnionOptional

server_implementation_id

UnionOptional

server_deployment_id

UnionOptional

session_id

UnionOptional
GEThttp://api.metorial.com/server-runs
curl -X GET "https://api.metorial.com/server-runs" \
  -H "Authorization: Bearer metorial_sk_..."

Get server run

Get the information of a specific server run

URL Parameters

server_run_id

String

The unique identifier for the server_run

GEThttp://api.metorial.com/server-runs/:server_run_id
curl -X GET "https://api.metorial.com/server-runs/ser_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."