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

object

Object

id

String

The unique identifier of the server run error

code

String

A machine-readable error code

message

String

A human-readable description of the error

metadata

Object

Additional metadata related to the error

server_run

Object

created_at

Date

Timestamp when the error was created

{
  "object": "server.server_run.error",
  "id": "example_id",
  "code": "example_code",
  "message": "example_message",
  "metadata": {},
  "server_run": {
    "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-01T08:26:26.188Z",
      "updated_at": "2025-08-01T08:26:26.188Z"
    },
    "server_deployment": {
      "object": "server.server_deployment#preview",
      "id": "example_id",
      "name": "example_name",
      "description": "example_description",
      "metadata": {},
      "created_at": "2025-08-01T08:26:26.188Z",
      "updated_at": "2025-08-01T08:26:26.188Z",
      "server": {
        "object": "server#preview",
        "id": "example_id",
        "name": "example_name",
        "description": "example_description",
        "type": "public",
        "created_at": "2025-08-01T08:26:26.188Z",
        "updated_at": "2025-08-01T08:26:26.188Z"
      }
    },
    "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-01T08:26:26.188Z"
    },
    "created_at": "2025-08-01T08:26:26.188Z",
    "updated_at": "2025-08-01T08:26:26.188Z",
    "started_at": "2025-08-01T08:26:26.188Z",
    "stopped_at": "2025-08-01T08:26:26.188Z"
  },
  "created_at": "2025-08-01T08:26:26.188Z"
}

List server run errors

List all server run errors

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

Get server run error

Get the information of a specific server run error

URL Parameters

serverRunErrorId

String

The unique identifier for the serverRunError

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