Server Run Error

Sometimes, an MCP server may fail to run correctly, resulting in an error. Metorial captures these errors to help you diagnose issues with your server runs. You may also want to check the Metorial dashboard for more details on the error.

Server Run Error object

Attributes

items

Object
{
  "items": {
    "0": {
      "object": "server.server_run.error",
      "metadata": {},
      "server_run": {
        "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",
    "code": "example_code",
    "message": "example_message",
    "metadata": "example_metadata",
    "server_run": {
      "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.067Z",
        "updated_at": "2025-10-15T16:41:27.067Z"
      },
      "server_deployment": {
        "object": "example_object",
        "id": "example_id",
        "name": "example_name",
        "description": "example_description",
        "metadata": "example_metadata",
        "created_at": "2025-10-15T16:41:27.067Z",
        "updated_at": "2025-10-15T16:41:27.067Z",
        "server": {
          "object": "example_object",
          "id": "example_id",
          "name": "example_name",
          "description": "example_description",
          "type": "",
          "created_at": "2025-10-15T16:41:27.067Z",
          "updated_at": "2025-10-15T16:41:27.067Z"
        }
      },
      "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.067Z"
      },
      "created_at": "2025-10-15T16:41:27.067Z",
      "updated_at": "2025-10-15T16:41:27.067Z",
      "started_at": "2025-10-15T16:41:27.067Z",
      "stopped_at": "2025-10-15T16:41:27.067Z"
    },
    "created_at": "2025-10-15T16:41:27.067Z"
  },
  "pagination": {
    "has_more_before": false,
    "has_more_after": false
  }
}

List server run errors

List all server run errors

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

server_session_id

UnionOptional

server_implementation_id

UnionOptional

server_deployment_id

UnionOptional

server_run_id

UnionOptional

server_run_error_group_id

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

Get server run error

Get the information of a specific server run error

URL Parameters

server_run_error_id

String

The unique identifier for the server_run_error

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