Magic MCP Session

Magic MCP sessions are created when a user connects to a magic MCP session using a valid magic MCP token.

Magic MCP Session object

Attributes

items

Object
{
  "items": {
    "0": {
      "object": "magic_mcp.session",
      "connection_status": "connected",
      "magic_mcp_server": {
        "status": "active",
        "metadata": {}
      },
      "usage": {}
    },
    "object": "example_object",
    "id": "example_id",
    "session_id": "example_session_id",
    "connection_status": "",
    "magic_mcp_server": {
      "id": "example_id",
      "status": "",
      "name": "example_name",
      "description": "example_description",
      "metadata": "example_metadata",
      "created_at": "2025-10-15T16:41:27.479Z",
      "updated_at": "2025-10-15T16:41:27.479Z"
    },
    "usage": {
      "total_productive_message_count": 0,
      "total_productive_client_message_count": 0,
      "total_productive_server_message_count": 0
    },
    "created_at": "2025-10-15T16:41:27.479Z",
    "updated_at": "2025-10-15T16:41:27.479Z"
  },
  "pagination": {
    "has_more_before": false,
    "has_more_after": false
  }
}

List magic MCP session

List all magic MCP session

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

magic_mcp_server_id

UnionOptional
GEThttp://api.metorial.com/magic-mcp-sessions
curl -X GET "https://api.metorial.com/magic-mcp-sessions" \
  -H "Authorization: Bearer metorial_sk_..."

Get magic MCP session

Get the information of a specific magic MCP session

URL Parameters

magic_mcp_session_id

String

The unique identifier for the magic_mcp_session

GEThttp://api.metorial.com/magic-mcp-sessions/:magic_mcp_session_id
curl -X GET "https://api.metorial.com/magic-mcp-sessions/mag_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."