Server Implementation

Server implementations allow you to customize predefined MCP servers with specific configurations, launch parameters, and metadata. You can create server deployments based on these implementations to connect to the underlying MCP servers.

Server Implementation object

Attributes

items

Object
{
  "items": {
    "0": {
      "object": "server.server_implementation",
      "status": "active",
      "metadata": {},
      "server_variant": {
        "object": "server.server_variant#preview",
        "source": {
          "type": "docker",
          "docker": {}
        }
      },
      "server": {
        "object": "server#preview",
        "type": "public"
      }
    },
    "object": "example_object",
    "id": "example_id",
    "status": "",
    "name": "example_name",
    "description": "example_description",
    "metadata": "example_metadata",
    "get_launch_params": "example_get_launch_params",
    "server_variant": {
      "object": "example_object",
      "id": "example_id",
      "identifier": "example_identifier",
      "server_id": "example_server_id",
      "source": {
        "type": "example_type",
        "docker": {
          "image": "example_image"
        }
      },
      "created_at": "2025-10-15T16:41:26.756Z"
    },
    "server": {
      "object": "example_object",
      "id": "example_id",
      "name": "example_name",
      "description": "example_description",
      "type": "",
      "created_at": "2025-10-15T16:41:26.756Z",
      "updated_at": "2025-10-15T16:41:26.756Z"
    },
    "created_at": "2025-10-15T16:41:26.756Z",
    "updated_at": "2025-10-15T16:41:26.756Z"
  },
  "pagination": {
    "has_more_before": false,
    "has_more_after": false
  }
}

List server implementations

Retrieve all server implementations in the instance. Supports filtering by status, server, or variant.

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

status

UnionOptional

server_id

UnionOptional

server_variant_id

UnionOptional

search

StringOptional
GEThttp://api.metorial.com/server-implementations
curl -X GET "https://api.metorial.com/server-implementations" \
  -H "Authorization: Bearer metorial_sk_..."

Get server implementation

Fetch detailed information about a specific server implementation.

URL Parameters

server_implementation_id

String

The unique identifier for the server_implementation

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

Create server implementation

Create a new server implementation for a specific server or server variant.

Request Body

name

StringOptional

description

StringOptional

metadata

StringOptional

get_launch_params

StringOptional

server_id

String

server_variant_id

String
POSThttp://api.metorial.com/server-implementations
curl -X POST "https://api.metorial.com/server-implementations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "metadata": "example_metadata",
  "get_launch_params": "example_get_launch_params",
  "server_id": "example_server_id"
}'

Update server implementation

Update metadata, launch parameters, or other fields of a server implementation.

URL Parameters

server_implementation_id

String

The unique identifier for the server_implementation

Request Body

name

StringOptional

description

StringOptional

metadata

StringOptional

get_launch_params

StringOptional
PATCHhttp://api.metorial.com/server-implementations/:server_implementation_id
curl -X PATCH "https://api.metorial.com/server-implementations/ser_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "metadata": "example_metadata",
  "get_launch_params": "example_get_launch_params"
}'

Delete server implementation

Delete a specific server implementation from the instance.

URL Parameters

server_implementation_id

String

The unique identifier for the server_implementation

DELETEhttp://api.metorial.com/server-implementations/:server_implementation_id
curl -X DELETE "https://api.metorial.com/server-implementations/ser_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."