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

Object

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

Date

Timestamp when the server run was started

stopped_at

Date

Timestamp when the server run was stopped

{
  "object": "server.server_run",
  "id": "example_id",
  "type": "hosted",
  "status": "active",
  "server_version_id": "example_server_version_id",
  "server": {
    "object": "server#preview",
    "id": "example_id",
    "name": "example_name",
    "description": "example_description",
    "type": "public",
    "created_at": "2025-08-12T09:45:15.992Z",
    "updated_at": "2025-08-12T09:45:15.992Z"
  },
  "server_deployment": {
    "object": "server.server_deployment#preview",
    "id": "example_id",
    "name": "example_name",
    "description": "example_description",
    "metadata": {},
    "created_at": "2025-08-12T09:45:15.992Z",
    "updated_at": "2025-08-12T09:45:15.992Z",
    "server": {
      "object": "server#preview",
      "id": "example_id",
      "name": "example_name",
      "description": "example_description",
      "type": "public",
      "created_at": "2025-08-12T09:45:15.992Z",
      "updated_at": "2025-08-12T09:45:15.992Z"
    }
  },
  "server_session": {
    "object": "session.server_session#preview",
    "id": "example_id",
    "status": "active",
    "mcp": {
      "object": "mcp",
      "version": "example_version",
      "connection_type": "sse",
      "client": {
        "object": "session.server_session.client",
        "name": "example_name",
        "version": "example_version",
        "capabilities": {}
      },
      "server": {
        "object": "session.server_session.server",
        "name": "example_name",
        "version": "example_version",
        "capabilities": {}
      }
    },
    "usage": {
      "total_productive_message_count": 0,
      "total_productive_client_message_count": 0,
      "total_productive_server_message_count": 0
    },
    "session_id": "example_session_id",
    "created_at": "2025-08-12T09:45:15.992Z"
  },
  "created_at": "2025-08-12T09:45:15.992Z",
  "updated_at": "2025-08-12T09:45:15.992Z",
  "started_at": "2025-08-12T09:45:15.992Z",
  "stopped_at": "2025-08-12T09:45:15.992Z"
}

List server runs

List all server runs

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

Get server run

Get the information of a specific server run

URL Parameters

serverRunId

String

The unique identifier for the serverRun

GEThttp://api.metorial.com/server-runs/:serverRunId
curl -X GET "https://api.metorial.com/server-runs/ser_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..."