Magic MCP Servers

Magic MCP servers are stable MCP entrypoints backed by one Subspace session template.

Magic MCP Servers object

Attributes

object

String

id

String

status

Enum

source

Enum

provider_template_id

StringNullable

endpoints

Object

name

StringNullable

description

StringNullable

metadata

Object

A key-value map

created_at

Date

updated_at

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

List magic MCP servers

Returns a paginated list of magic MCP servers.

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

status

UnionOptional

magic_mcp_group_id

UnionOptional

consumer_id

UnionOptional

consumer_profile_id

UnionOptional

search

StringOptional

preconfigured_only

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

Get magic MCP server

Retrieves a specific magic MCP server.

URL Parameters

magic_mcp_server_id

String

The unique identifier for the magic_mcp_server

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

Create magic MCP server

Creates a magic MCP server with a new session template. A Subspace session is created automatically on first connection and then reused.

Request Body

name

StringOptional

description

StringOptional

metadata

ObjectOptional

A key-value map

consumer_profile_id

StringOptional
POSThttp://api.metorial.com/magic-mcp-servers
curl -X POST "https://api.metorial.com/magic-mcp-servers" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "metadata": {},
  "consumer_profile_id": "example_consumer_profile_id"
}'

Delete magic MCP server

Archives a magic MCP server.

URL Parameters

magic_mcp_server_id

String

The unique identifier for the magic_mcp_server

DELETEhttp://api.metorial.com/magic-mcp-servers/:magic_mcp_server_id
curl -X DELETE "https://api.metorial.com/magic-mcp-servers/mag_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."

Update magic MCP server

Updates a magic MCP server.

URL Parameters

magic_mcp_server_id

String

The unique identifier for the magic_mcp_server

Request Body

name

StringOptional

description

StringOptional

metadata

ObjectOptional

A key-value map

aliases

Array of StringsOptional

session_template_id

StringOptional
PATCHhttp://api.metorial.com/magic-mcp-servers/:magic_mcp_server_id
curl -X PATCH "https://api.metorial.com/magic-mcp-servers/mag_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "metadata": {},
  "aliases": [
    "example_item"
  ],
  "session_template_id": "example_session_template_id"
}'