Magic MCP Group

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

Magic MCP Group object

Attributes

object

String

id

String

The unique identifier of the magic MCP group

status

Enum

The status of the magic MCP server

slug

String

The slug identifier of the magic MCP group

name

String

The name of the magic MCP server

description

StringNullable

A description of the magic MCP server, if available

metadata

Object

Additional metadata related to the magic MCP server

created_at

Date

Timestamp when the magic MCP server was created

updated_at

Date

Timestamp when the magic MCP server was last updated

{
  "object": "magic_mcp.group",
  "status": "active",
  "metadata": {}
}

List magic MCP group

List all magic MCP group

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

status

UnionOptional

search

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

Get magic MCP group

Get the information of a specific magic MCP group

URL Parameters

magic_mcp_group_id

String

The unique identifier for the magic_mcp_group

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

Create magic MCP group

Create a new magic MCP group

Request Body

name

String

The name of the magic MCP group

description

StringOptional

The description of the magic MCP group

metadata

ObjectOptional

The metadata of the magic MCP group

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

Delete magic MCP group

Delete a specific magic MCP group

URL Parameters

magic_mcp_group_id

String

The unique identifier for the magic_mcp_group

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

Update magic MCP group

Update the information of a specific magic MCP group

URL Parameters

magic_mcp_group_id

String

The unique identifier for the magic_mcp_group

Request Body

name

StringOptional

The name of the magic MCP group

description

StringOptional

The description of the magic MCP group

metadata

ObjectOptional

The metadata of the magic MCP group

PATCHhttp://api.metorial.com/magic-mcp-groups/:magic_mcp_group_id
curl -X PATCH "https://api.metorial.com/magic-mcp-groups/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 group

Add magic MCP servers to a specific magic MCP group

URL Parameters

magic_mcp_group_id

String

The unique identifier for the magic_mcp_group

Request Body

magic_mcp_server_ids

Array of Strings

The IDs of the magic MCP servers to add to the group

POSThttp://api.metorial.com/magic-mcp-groups/:magic_mcp_group_id/add-servers
curl -X POST "https://api.metorial.com/magic-mcp-groups/mag_Rm4Mnheq2bfEPhBhP7SY/add-servers" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "magic_mcp_server_ids": [
    "example_item"
  ]
}'

Remove servers from magic MCP group

Remove magic MCP servers from a specific magic MCP group

URL Parameters

magic_mcp_group_id

String

The unique identifier for the magic_mcp_group

Request Body

magic_mcp_server_ids

Array of Strings

The IDs of the magic MCP servers to remove from the group

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