Session
Before you can connect to an MCP server, you need to create a session. Each session can be linked to one or more server deployments, allowing you to connect to multiple servers simultaneously. Once you have created a session, you can use the provided MCP URL to connect to the server deployments via MCP.
Session object
Attributes
object
Objectid
StringThe unique identifier of the session
status
EnumThe current status of the session
connection_status
EnumThe connection state of the session
client_secret
ObjectClient secret object associated with this session
server_deployments
Array of ObjectsList of server deployments related to this session
usage
ObjectUsage statistics for the session
metadata
ObjectAdditional metadata associated with the session
created_at
DateTimestamp when the session was created
updated_at
DateTimestamp when the session was last updated
{"object": "session","id": "example_id","status": "active","connection_status": "connected","client_secret": {"object": "client_secret","type": "session","id": "example_id","secret": "example_secret","expires_at": "2025-08-12T09:45:15.873Z"},"server_deployments": [{"object": "session.server_deployment#preview","id": "example_id","name": "example_name","description": "example_description","metadata": {},"created_at": "2025-08-12T09:45:15.873Z","updated_at": "2025-08-12T09:45:15.873Z","server": {"object": "server#preview","id": "example_id","name": "example_name","description": "example_description","type": "public","created_at": "2025-08-12T09:45:15.873Z","updated_at": "2025-08-12T09:45:15.873Z"},"connection_urls": {"sse": "example_sse","streamable_http": "example_streamable_http","websocket": "example_websocket"}},{"object": "session.server_deployment#preview","metadata": {},"server": {"object": "server#preview","type": "public"},"connection_urls": {}}],"usage": {"total_productive_message_count": 0,"total_productive_client_message_count": 0,"total_productive_server_message_count": 0},"metadata": {},"created_at": "2025-08-12T09:45:15.873Z","updated_at": "2025-08-12T09:45:15.873Z"}
List sessions
List all sessions
curl -X GET "https://api.metorial.com/sessions" \-H "Content-Type: application/json" \-H "Authorization: Bearer metorial_sk_..."
Get session
Get the information of a specific session
URL Parameters
sessionId
StringThe unique identifier for the session
curl -X GET "https://api.metorial.com/sessions/ses_Rm4Mnheq2bfEPhBhP7SY" \-H "Content-Type: application/json" \-H "Authorization: Bearer metorial_sk_..."
Create session
Create a new session
curl -X POST "https://api.metorial.com/sessions" \-H "Content-Type: application/json" \-H "Authorization: Bearer metorial_sk_..."
Delete session
Delete a session
URL Parameters
sessionId
StringThe unique identifier for the session
curl -X DELETE "https://api.metorial.com/sessions/ses_Rm4Mnheq2bfEPhBhP7SY" \-H "Content-Type: application/json" \-H "Authorization: Bearer metorial_sk_..."