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

items

Object
{
  "items": {
    "0": {
      "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": {}
      }
    },
    "object": "example_object",
    "id": "example_id",
    "type": "",
    "status": "",
    "server_version_id": "example_server_version_id",
    "server": {
      "object": "example_object",
      "id": "example_id",
      "name": "example_name",
      "description": "example_description",
      "type": "",
      "created_at": "2025-10-15T16:41:27.019Z",
      "updated_at": "2025-10-15T16:41:27.019Z"
    },
    "server_deployment": {
      "object": "example_object",
      "id": "example_id",
      "name": "example_name",
      "description": "example_description",
      "metadata": "example_metadata",
      "created_at": "2025-10-15T16:41:27.019Z",
      "updated_at": "2025-10-15T16:41:27.019Z",
      "server": {
        "object": "example_object",
        "id": "example_id",
        "name": "example_name",
        "description": "example_description",
        "type": "",
        "created_at": "2025-10-15T16:41:27.019Z",
        "updated_at": "2025-10-15T16:41:27.019Z"
      }
    },
    "server_session": {
      "object": "example_object",
      "id": "example_id",
      "status": "",
      "mcp": {
        "object": "example_object",
        "version": "example_version",
        "connection_type": "",
        "client": {
          "object": "example_object",
          "name": "example_name",
          "version": "example_version",
          "capabilities": "example_capabilities"
        },
        "server": {
          "object": "example_object",
          "name": "example_name",
          "version": "example_version",
          "capabilities": "example_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-10-15T16:41:27.019Z"
    },
    "created_at": "2025-10-15T16:41:27.019Z",
    "updated_at": "2025-10-15T16:41:27.019Z",
    "started_at": "2025-10-15T16:41:27.019Z",
    "stopped_at": "2025-10-15T16:41:27.019Z"
  },
  "pagination": {
    "has_more_before": false,
    "has_more_after": false
  }
}

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_..."