Servers

A server represents a deployable MCP server in Metorial's catalog. You can use server deployments to create MCP server instances that you can connect to.

Servers object

Attributes

object

String

id

String

The unique identifier for the server

type

Enum

The visibility type of the server; currently only "public" is supported

status

Enum

The current status of the server

name

String

The display name of the server

description

StringNullable

An optional description providing more details about the server

imported_server_id

StringNullable

ID of the server this one was imported from, if applicable

variants

Object

A list of available variants for this server

metadata

String

Arbitrary key-value metadata associated with the server

created_at

Date

Timestamp when the server was created

updated_at

Date

Timestamp when the server was last updated

{
  "object": "server",
  "id": "example_id",
  "type": "public",
  "status": "active",
  "name": "example_name",
  "description": "example_description",
  "imported_server_id": "example_imported_server_id",
  "variants": {
    "0": {
      "object": "server.server_variant",
      "status": "active",
      "server": {
        "object": "server#preview",
        "type": "public"
      },
      "current_version": {
        "object": "server.server_version",
        "source": {
          "type": "docker",
          "docker": {}
        },
        "schema": {},
        "server": {
          "object": "server#preview",
          "type": "public"
        }
      },
      "source": {
        "type": "docker",
        "docker": {}
      }
    },
    "1": {
      "object": "server.server_variant",
      "status": "active",
      "server": {
        "object": "server#preview",
        "type": "public"
      },
      "current_version": {
        "object": "server.server_version",
        "source": {
          "type": "docker",
          "docker": {}
        },
        "schema": {},
        "server": {
          "object": "server#preview",
          "type": "public"
        }
      },
      "source": {
        "type": "docker",
        "docker": {}
      }
    },
    "object": "example_object",
    "id": "example_id",
    "status": "",
    "identifier": "example_identifier",
    "server": {
      "object": "example_object",
      "id": "example_id",
      "name": "example_name",
      "description": "example_description",
      "type": "",
      "created_at": "2025-10-15T16:41:26.606Z",
      "updated_at": "2025-10-15T16:41:26.606Z"
    },
    "current_version": {
      "object": "example_object",
      "id": "example_id",
      "identifier": "example_identifier",
      "server_id": "example_server_id",
      "server_variant_id": "example_server_variant_id",
      "get_launch_params": "example_get_launch_params",
      "source": {
        "type": "example_type",
        "docker": {
          "image": "example_image",
          "tag": "example_tag"
        }
      },
      "schema": "example_schema",
      "server": {
        "object": "example_object",
        "id": "example_id",
        "name": "example_name",
        "description": "example_description",
        "type": "",
        "created_at": "2025-10-15T16:41:26.606Z",
        "updated_at": "2025-10-15T16:41:26.606Z"
      },
      "created_at": "2025-10-15T16:41:26.606Z"
    },
    "source": {
      "type": "example_type",
      "docker": {
        "image": "example_image"
      }
    },
    "created_at": "2025-10-15T16:41:26.606Z"
  },
  "metadata": {},
  "created_at": "2025-10-15T16:41:26.606Z",
  "updated_at": "2025-10-15T16:41:26.606Z"
}

Get server by ID

Retrieves detailed information for a server identified by its ID.

URL Parameters

server_id

String

The unique identifier for the server

GEThttp://api.metorial.com/servers/:server_id
curl -X GET "https://api.metorial.com/servers/ser_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."