Magic MCP Tokens

Magic MCP tokens authorize access to Magic MCP servers via the /magic connection API.

Magic MCP Tokens object

Attributes

object

String

id

String

status

Enum

secret

String

name

StringNullable

description

StringNullable

server

ObjectNullable

groups

Object

metadata

Object

A key-value map

created_at

Date

updated_at

Date
{
  "object": "magic_mcp.token",
  "status": "active",
  "server": {
    "object": "magic_mcp.server#preview",
    "status": "active"
  },
  "groups": [
    {
      "object": "magic_mcp.group",
      "status": "active",
      "metadata": {}
    },
    {
      "object": "magic_mcp.group",
      "status": "active",
      "metadata": {}
    }
  ],
  "metadata": {}
}

List magic MCP tokens

Returns a paginated list of magic MCP tokens.

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

status

UnionOptional

magic_mcp_group_id

UnionOptional

magic_mcp_server_id

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

Get magic MCP token

Retrieves a specific magic MCP token.

URL Parameters

magic_mcp_token_id

String

The unique identifier for the magic_mcp_token

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

Create magic MCP token

Creates a new magic MCP token.

Request Body

name

String

description

StringOptional

metadata

ObjectOptional

A key-value map

magic_mcp_group_ids

Array of StringsOptional

magic_mcp_server_id

StringOptional
POSThttp://api.metorial.com/magic-mcp-tokens
curl -X POST "https://api.metorial.com/magic-mcp-tokens" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "metadata": {},
  "magic_mcp_group_ids": [
    "example_item"
  ],
  "magic_mcp_server_id": "example_magic_mcp_server_id"
}'

Delete magic MCP token

Deletes a magic MCP token.

URL Parameters

magic_mcp_token_id

String

The unique identifier for the magic_mcp_token

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

Update magic MCP token

Updates a magic MCP token.

URL Parameters

magic_mcp_token_id

String

The unique identifier for the magic_mcp_token

Request Body

name

StringOptional

description

StringOptional

metadata

ObjectOptional

A key-value map

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

Add magic MCP groups to token

Adds groups to a magic MCP token.

URL Parameters

magic_mcp_token_id

String

The unique identifier for the magic_mcp_token

Request Body

magic_mcp_group_ids

Array of Strings
POSThttp://api.metorial.com/magic-mcp-tokens/:magic_mcp_token_id/add-groups
curl -X POST "https://api.metorial.com/magic-mcp-tokens/mag_Rm4Mnheq2bfEPhBhP7SY/add-groups" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "magic_mcp_group_ids": [
    "example_item"
  ]
}'

Remove magic MCP groups from token

Removes groups from a magic MCP token.

URL Parameters

magic_mcp_token_id

String

The unique identifier for the magic_mcp_token

Request Body

magic_mcp_group_ids

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