Magic MCP Groups

Magic MCP groups categorize servers and can be bound to token access.

Magic MCP Groups object

Attributes

object

String

id

String

status

Enum

slug

String

name

StringNullable

description

StringNullable

metadata

Object

A key-value map

created_at

Date

updated_at

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

List magic MCP groups

Returns a paginated list of magic MCP groups.

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

Retrieves 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

Creates a magic MCP group.

Request Body

name

String

description

StringOptional

metadata

ObjectOptional

A key-value map

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

Deletes a 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

Updates a magic MCP group.

URL Parameters

magic_mcp_group_id

String

The unique identifier for the magic_mcp_group

Request Body

name

StringOptional

description

StringOptional

metadata

ObjectOptional

A key-value map

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

Adds magic MCP servers to a 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
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

Removes magic MCP servers from a 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
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"
  ]
}'