Servers

Create an MCP server

Register a new MCP server. Requires the admin role.

post/api/v1/servers

Request

  • Base URL: https://dashboard.sealgate.ai
  • URL: https://dashboard.sealgate.ai/api/v1/servers
  • Auth: HTTP bearer

Request body

namestring required

Server MCP prefix name (alphanumeric only)

display_namestring nullable

Human-readable display name (defaults to name)

commandstring

Server command (required for local servers)

argsstring[]

Command-line arguments

envobject

Environment variables

urlstring nullable

Remote server URL (direct mode, no mcp-remote)

headersobject nullable

Custom HTTP headers for remote servers

enabledboolean

Whether to enable the server

versionstring nullable

Server version

transport_typestring

Transport: 'http' or 'stdio_tunnel'

device_ref_idinteger nullable

Target device id, required when transport_type is 'stdio_tunnel'

working_dirstring nullable

Optional working directory for stdio_tunnel subprocesses

icon_urlstring nullable

Manual override icon URL

Response

The created server

idinteger required

Server ID

namestring required

Server MCP prefix name (alphanumeric)

display_namestring required

Human-readable display name

commandstring required

Server command

enabledboolean required

Whether the server is enabled at the admin/global level

tool_countinteger required

Number of registered tools/elements

needs_configboolean required

Whether the server has unconfigured required template fields

domainstring required

Domain this server belongs to

is_builtinboolean

Whether this is the auto-provisioned builtin server

user_enabledboolean nullable

User-level enablement override; null means no override

parent_enabledboolean required

Effective enabled state from the role/global hierarchy, ignoring any user override

user_lockedboolean

Whether the caller's enablement override is admin-locked

config_warningsstring[]

Human-readable warnings about missing configuration

icon_urlstring nullable

Remote icon URL

authenticated_user_emailsstring[]

Emails of users who have invoked tools on this server

transport_typestring

Transport: 'http' (remote URL) or 'stdio_tunnel' (proxied via daemon)

device_idstring nullable

Human-readable device label for a bound stdio_tunnel device

device_owner_emailstring nullable

Email of the device owner for a stdio_tunnel server

argsstring[]

Command-line arguments

envobject

Environment variables

urlstring nullable

Remote server URL (direct mode)

headersobject

Custom HTTP headers

versionstring nullable

Server version

from_marketplace_idstring nullable

Marketplace ID this server was installed from

Changes

No recorded changes to this operation across all 1 revision of this API.