Magic MCP Sessions

Magic MCP sessions map a Magic MCP server to one Subspace session and are created on demand by the MCP connection API.

Magic MCP Sessions object

Attributes

object

String

id

String

subspace_session_id

String

subspace_session_template_id

String

magic_mcp_server

Object

created_at

Date

updated_at

Date
{
  "object": "magic_mcp.session",
  "magic_mcp_server": {
    "object": "magic_mcp.server",
    "status": "active",
    "source": "manual",
    "endpoints": [
      {},
      {}
    ],
    "metadata": {}
  }
}

List magic MCP sessions

Returns a paginated list of magic MCP sessions.

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

Retrieves 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_..."