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
Objectid
Stringstatus
Enumname
Stringdescription
Stringmetadata
Objectget_launch_params
Stringserver_variant
Objectserver
Objectcreated_at
Dateupdated_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.
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
StringThe unique identifier for the serverImplementation
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.
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
StringThe unique identifier for the serverImplementation
Request Body
name
StringOptionaldescription
StringOptionalmetadata
ObjectOptionalget_launch_params
StringOptionalcurl -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
StringThe unique identifier for the serverImplementation
curl -X DELETE "https://api.metorial.com/server-implementations/ser_Rm4Mnheq2bfEPhBhP7SY" \-H "Content-Type: application/json" \-H "Authorization: Bearer metorial_sk_..."