Magic MCP Endpoints

Magic MCP endpoints combine multiple Magic MCP servers behind one routed connection target.

Magic MCP Endpoints object

Attributes

object

String

id

String

status

Enum

slug

String

url

String

consumer_profile_id

StringNullable

session_template_id

StringNullable

session_id

StringNullable

servers

Array of Objects

name

StringNullable

description

StringNullable

metadata

Object

A key-value map

created_at

Date

updated_at

Date
{
  "object": "magic_mcp.endpoint",
  "status": "active",
  "metadata": {}
}

List magic MCP endpoints

Returns a paginated list of magic MCP endpoints.

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

status

UnionOptional

magic_mcp_server_id

UnionOptional

search

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

Get magic MCP endpoint

Retrieves a specific magic MCP endpoint.

URL Parameters

magic_mcp_endpoint_id

String

The unique identifier for the magic_mcp_endpoint

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

Create magic MCP endpoint

Creates a magic MCP endpoint.

Request Body

name

StringOptional

description

StringOptional

metadata

ObjectOptional

A key-value map

consumer_profile_id

StringOptional

magic_mcp_server_ids

Array of StringsOptional

servers

ObjectOptional
POSThttp://api.metorial.com/magic-mcp-endpoints
curl -X POST "https://api.metorial.com/magic-mcp-endpoints" \
  -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",
  "magic_mcp_server_ids": [
    "example_item"
  ],
  "servers": {
    "magic_mcp_server_id": "example_magic_mcp_server_id",
    "tool_filters": {
      "type": "example_type",
      "keys": [
        "example_item"
      ]
    }
  }
}'

Delete magic MCP endpoint

Archives a magic MCP endpoint.

URL Parameters

magic_mcp_endpoint_id

String

The unique identifier for the magic_mcp_endpoint

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

Update magic MCP endpoint

Updates a magic MCP endpoint.

URL Parameters

magic_mcp_endpoint_id

String

The unique identifier for the magic_mcp_endpoint

Request Body

name

StringOptional

description

StringOptional

metadata

ObjectOptional

A key-value map

PATCHhttp://api.metorial.com/magic-mcp-endpoints/:magic_mcp_endpoint_id
curl -X PATCH "https://api.metorial.com/magic-mcp-endpoints/mag_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "metadata": {}
}'

Add servers to magic MCP endpoint

Adds magic MCP servers to a magic MCP endpoint.

URL Parameters

magic_mcp_endpoint_id

String

The unique identifier for the magic_mcp_endpoint

Request Body

magic_mcp_server_ids

Array of StringsOptional

servers

ObjectOptional
POSThttp://api.metorial.com/magic-mcp-endpoints/:magic_mcp_endpoint_id/add-servers
curl -X POST "https://api.metorial.com/magic-mcp-endpoints/mag_Rm4Mnheq2bfEPhBhP7SY/add-servers" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "magic_mcp_server_ids": [
    "example_item"
  ],
  "servers": {
    "magic_mcp_server_id": "example_magic_mcp_server_id",
    "tool_filters": {
      "type": "example_type",
      "keys": [
        "example_item"
      ]
    }
  }
}'

Remove servers from magic MCP endpoint

Removes magic MCP servers from a magic MCP endpoint.

URL Parameters

magic_mcp_endpoint_id

String

The unique identifier for the magic_mcp_endpoint

Request Body

magic_mcp_server_ids

Array of Strings
POSThttp://api.metorial.com/magic-mcp-endpoints/:magic_mcp_endpoint_id/remove-servers
curl -X POST "https://api.metorial.com/magic-mcp-endpoints/mag_Rm4Mnheq2bfEPhBhP7SY/remove-servers" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "magic_mcp_server_ids": [
    "example_item"
  ]
}'