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

object

Object

id

String

status

Enum

name

String

description

String

metadata

Object

get_launch_params

String

server_variant

Object

server

Object

created_at

Date

updated_at

Date
{
  "object": "server.server_implementation",
  "id": "example_id",
  "status": "active",
  "name": "example_name",
  "description": "example_description",
  "metadata": {},
  "get_launch_params": "example_get_launch_params",
  "server_variant": {
    "object": "server.server_variant#preview",
    "id": "example_id",
    "identifier": "example_identifier",
    "server_id": "example_server_id",
    "source": {
      "type": "docker",
      "docker": {}
    },
    "created_at": "2025-08-12T09:45:15.827Z"
  },
  "server": {
    "object": "server#preview",
    "id": "example_id",
    "name": "example_name",
    "description": "example_description",
    "type": "public",
    "created_at": "2025-08-12T09:45:15.827Z",
    "updated_at": "2025-08-12T09:45:15.827Z"
  },
  "created_at": "2025-08-12T09:45:15.827Z",
  "updated_at": "2025-08-12T09:45:15.827Z"
}

List server implementations

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

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

Get server implementation

Fetch detailed information about a specific server implementation.

URL Parameters

serverImplementationId

String

The unique identifier for the serverImplementation

GEThttp://api.metorial.com/server-implementations/:serverImplementationId
curl -X GET "https://api.metorial.com/server-implementations/ser_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..."

Create server implementation

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

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_..."

Update server implementation

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

URL Parameters

serverImplementationId

String

The unique identifier for the serverImplementation

Request Body

name

StringOptional

description

StringOptional

metadata

ObjectOptional

get_launch_params

StringOptional
PATCHhttp://api.metorial.com/server-implementations/:serverImplementationId
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": {},
  "get_launch_params": "example_get_launch_params"
}'

Delete server implementation

Delete a specific server implementation from the instance.

URL Parameters

serverImplementationId

String

The unique identifier for the serverImplementation

DELETEhttp://api.metorial.com/server-implementations/:serverImplementationId
curl -X DELETE "https://api.metorial.com/server-implementations/ser_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..."