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
Objectid
StringThe unique identifier of the server run
type
EnumThe type of the server run
status
EnumThe current status of the server run
server_version_id
StringThe unique identifier of the server version associated with this run
server
Objectserver_deployment
Objectserver_session
Objectcreated_at
DateTimestamp when the server run was created
updated_at
DateTimestamp when the server run was last updated
started_at
DateTimestamp when the server run was started
stopped_at
DateTimestamp 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
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
StringThe unique identifier for the serverRun
curl -X GET "https://api.metorial.com/server-runs/ser_Rm4Mnheq2bfEPhBhP7SY" \-H "Content-Type: application/json" \-H "Authorization: Bearer metorial_sk_..."