Magic MCP Server

Before you can connect to an MCP server, you need to create a magic MCP server.

Magic MCP Server object

Attributes

items

Object
{
  "items": {
    "0": {
      "object": "magic_mcp.server",
      "status": "active",
      "endpoints": [
        {
          "urls": {}
        },
        {
          "urls": {}
        }
      ],
      "server_deployments": [
        {
          "object": "server.server_deployment#preview",
          "metadata": {},
          "server": {
            "object": "server#preview",
            "type": "public"
          }
        },
        {
          "object": "server.server_deployment#preview",
          "metadata": {},
          "server": {
            "object": "server#preview",
            "type": "public"
          }
        }
      ],
      "metadata": {}
    },
    "object": "example_object",
    "id": "example_id",
    "status": "",
    "endpoints": {
      "id": "example_id",
      "alias": "example_alias",
      "urls": {
        "sse": "example_sse",
        "streamable_http": "example_streamable_http"
      }
    },
    "server_deployments": {
      "object": "example_object",
      "id": "example_id",
      "name": "example_name",
      "description": "example_description",
      "metadata": "example_metadata",
      "created_at": "2025-10-15T16:41:27.417Z",
      "updated_at": "2025-10-15T16:41:27.417Z",
      "server": {
        "object": "example_object",
        "id": "example_id",
        "name": "example_name",
        "description": "example_description",
        "type": "",
        "created_at": "2025-10-15T16:41:27.417Z",
        "updated_at": "2025-10-15T16:41:27.417Z"
      }
    },
    "name": "example_name",
    "description": "example_description",
    "metadata": "example_metadata",
    "created_at": "2025-10-15T16:41:27.417Z",
    "updated_at": "2025-10-15T16:41:27.417Z"
  },
  "pagination": {
    "has_more_before": false,
    "has_more_after": false
  }
}

List magic MCP server

List all magic MCP server

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

status

UnionOptional

server_id

UnionOptional

server_variant_id

UnionOptional

server_implementation_id

UnionOptional

session_id

UnionOptional

search

StringOptional
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

Get the information of 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

Create a new magic MCP server

Request Body

name

StringOptional

description

StringOptional

metadata

StringOptional

config

String

oauth_config

ObjectOptional

server_implementation

Object

server_implementation_id

String

server_variant_id

String

server_id

String
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": "example_metadata",
  "config": "example_config",
  "oauth_config": {
    "client_id": "example_client_id",
    "client_secret": "example_client_secret"
  },
  "server_implementation": {
    "name": "example_name",
    "description": "example_description",
    "metadata": "example_metadata",
    "get_launch_params": "example_get_launch_params"
  }
}'

Delete magic MCP server

Delete a specific 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

Update the information of a specific magic MCP server

URL Parameters

magic_mcp_server_id

String

The unique identifier for the magic_mcp_server

Request Body

name

StringOptional

The name of the magic MCP server

description

StringOptional

The description of the magic MCP server

metadata

StringOptional

The metadata of the magic MCP server

aliases

Array of StringsOptional
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": "example_metadata",
  "aliases": [
    "example_item"
  ]
}'