Server Deployment Template

Store reusable configuration data for MCP servers in a secure vault.

Server Deployment Template object

Attributes

object

String

id

String

The unique identifier of the server deployment template

name

String

The name of the server deployment template

description

StringNullable

The description of the server deployment template

server

Object

created_at

Date

Timestamp when the server deployment template was created

updated_at

Date

Timestamp when the server deployment template was last updated

{
  "object": "server.server_deployment.template",
  "server": {
    "object": "server",
    "type": "public",
    "status": "active",
    "variants": [
      {
        "object": "server.server_variant",
        "status": "active",
        "server": {
          "object": "server#preview",
          "type": "public"
        },
        "current_version": {
          "object": "server.server_version",
          "oauth": {
            "status": "disabled"
          },
          "source": {
            "type": "docker",
            "docker": {}
          },
          "schema": {},
          "server": {
            "object": "server#preview",
            "type": "public"
          }
        },
        "source": {
          "type": "docker",
          "docker": {}
        }
      },
      {
        "object": "server.server_variant",
        "status": "active",
        "server": {
          "object": "server#preview",
          "type": "public"
        },
        "current_version": {
          "object": "server.server_version",
          "oauth": {
            "status": "disabled"
          },
          "source": {
            "type": "docker",
            "docker": {}
          },
          "schema": {},
          "server": {
            "object": "server#preview",
            "type": "public"
          }
        },
        "source": {
          "type": "docker",
          "docker": {}
        }
      }
    ],
    "metadata": {}
  }
}

List server runs

List all server runs

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

server_id

UnionOptional
GEThttp://api.metorial.com/server-deployment-template
curl -X GET "https://api.metorial.com/server-deployment-template" \
  -H "Authorization: Bearer metorial_sk_..."

Get server run

Get the information of a specific server run

URL Parameters

server_deployment_template_id

String

The unique identifier for the server_deployment_template

GEThttp://api.metorial.com/server-deployment-template/:server_deployment_template_id
curl -X GET "https://api.metorial.com/server-deployment-template/ser_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."

Create server deployment template

Create a new server deployment template

Request Body

name

String

description

StringOptional

server_id

String
Provide exactly one of the following:
These 3 fields are mutually exclusive - include only one in your request

oauth

ObjectOptional

config

ObjectOptional

A key-value map

magic_mcp_server_id

String
POSThttp://api.metorial.com/server-deployment-template
curl -X POST "https://api.metorial.com/server-deployment-template" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "server_id": "example_server_id",
  "oauth": {
    "client_id": "example_client_id",
    "client_secret": "example_client_secret"
  }
}'

Update server deployment template

Update an existing server deployment template

URL Parameters

server_deployment_template_id

String

The unique identifier for the server_deployment_template

Request Body

name

StringOptional

description

StringOptional

oauth

ObjectOptional
PATCHhttp://api.metorial.com/server-deployment-template/:server_deployment_template_id
curl -X PATCH "https://api.metorial.com/server-deployment-template/ser_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "oauth": {
    "client_id": "example_client_id",
    "client_secret": "example_client_secret"
  }
}'