Magic MCP Server Providers

Magic MCP server providers define which providers are included in the setup session template backing a magic MCP server.

Magic MCP Server Providers object

Attributes

object

String

String representing the object's type

id

String

Unique magic MCP server provider identifier

status

Enum

Provider status

tool_filter

Object

Tool filter configuration

provider_id

String

Provider ID

magic_mcp_server_id

String

Parent magic MCP server ID

deployment

Object

config

Object

auth_config

ObjectNullable

created_at

Date

Timestamp when created

updated_at

Date

Timestamp when last updated

{
  "object": "magic_mcp.server.provider",
  "id": "stp_3cDeFgHjKlMnPqRs",
  "status": "active",
  "tool_filter": {
    "type": "allow_all"
  },
  "provider_id": "pro_5gHjKlMnPqRsTuVw",
  "magic_mcp_server_id": "mgs_2bCdEfGhJkLmNpQr",
  "deployment": {
    "object": "provider.deployment#preview",
    "id": "pde_1aBcDeFgHjKlMnPq",
    "name": "Production",
    "description": "Production deployment",
    "metadata": {},
    "provider_id": "pro_5gHjKlMnPqRsTuVw",
    "created_at": "2025-09-15T10:30:00.000Z",
    "updated_at": "2026-01-10T14:45:00.000Z"
  },
  "config": {
    "object": "provider.config#preview",
    "id": "pcf_7dEfGhJkLmNpQrSt",
    "name": "Production Config",
    "description": "Configuration for production environment",
    "metadata": {},
    "provider_id": "pro_5gHjKlMnPqRsTuVw",
    "created_at": "2025-09-15T10:30:00.000Z",
    "updated_at": "2026-01-10T14:45:00.000Z"
  },
  "auth_config": {
    "object": "provider.auth_config#preview"
  },
  "created_at": "2025-09-15T10:30:00.000Z",
  "updated_at": "2026-01-10T14:45:00.000Z"
}

List magic MCP server providers

Returns a paginated list of providers configured for a magic MCP server.

URL Parameters

magic_mcp_server_id

String

The unique identifier for the magic_mcp_server

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

status

UnionOptional

id

UnionOptional

Filter by magic MCP server provider ID(s)

provider_id

UnionOptional

Filter by provider ID(s)

provider_deployment_id

UnionOptional

Filter by provider deployment ID(s)

provider_config_id

UnionOptional

Filter by provider config ID(s)

provider_auth_config_id

UnionOptional

Filter by provider auth config ID(s)

created_at

ObjectOptional

Filter magic MCP server provider creation time by date range

updated_at

ObjectOptional

Filter magic MCP server provider last update time by date range

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

Get magic MCP server provider

Retrieves a specific provider configuration from a magic MCP server.

URL Parameters

magic_mcp_server_id

String

The unique identifier for the magic_mcp_server

magic_mcp_server_provider_id

String

The unique identifier for the magic_mcp_server_provider

GEThttp://api.metorial.com/magic-mcp-servers/:magic_mcp_server_id/provider/:magic_mcp_server_provider_id
curl -X GET "https://api.metorial.com/magic-mcp-servers/mag_Rm4Mnheq2bfEPhBhP7SY/provider/mag_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."

Create magic MCP server provider

Adds a new provider configuration to a magic MCP server.

URL Parameters

magic_mcp_server_id

String

The unique identifier for the magic_mcp_server

Request Body

provider_deployment_id

StringOptional

provider_config_id

StringOptional

provider_config_vault_id

StringOptional

provider_auth_config_id

StringOptional

tool_filters

UnionOptionalNullable
POSThttp://api.metorial.com/magic-mcp-servers/:magic_mcp_server_id/provider
curl -X POST "https://api.metorial.com/magic-mcp-servers/mag_Rm4Mnheq2bfEPhBhP7SY/provider" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "provider_deployment_id": "example_provider_deployment_id",
  "provider_config_id": "example_provider_config_id",
  "provider_config_vault_id": "example_provider_config_vault_id",
  "provider_auth_config_id": "example_provider_auth_config_id",
  "tool_filters": {
    "type": "example_type",
    "keys": [
      "example_item"
    ]
  }
}'

Update magic MCP server provider

Updates a provider configuration in a magic MCP server.

URL Parameters

magic_mcp_server_id

String

The unique identifier for the magic_mcp_server

magic_mcp_server_provider_id

String

The unique identifier for the magic_mcp_server_provider

Request Body

tool_filters

UnionOptionalNullable
PATCHhttp://api.metorial.com/magic-mcp-servers/:magic_mcp_server_id/provider/:magic_mcp_server_provider_id
curl -X PATCH "https://api.metorial.com/magic-mcp-servers/mag_Rm4Mnheq2bfEPhBhP7SY/provider/mag_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "tool_filters": {
    "type": "example_type",
    "keys": [
      "example_item"
    ]
  }
}'

Delete magic MCP server provider

Removes a provider configuration from a magic MCP server.

URL Parameters

magic_mcp_server_id

String

The unique identifier for the magic_mcp_server

magic_mcp_server_provider_id

String

The unique identifier for the magic_mcp_server_provider

DELETEhttp://api.metorial.com/magic-mcp-servers/:magic_mcp_server_id/provider/:magic_mcp_server_provider_id
curl -X DELETE "https://api.metorial.com/magic-mcp-servers/mag_Rm4Mnheq2bfEPhBhP7SY/provider/mag_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."