Create MCP server
Register a new MCP server (connector) on the account.
Restrictions
Usage
command/args/envapply tostdio;url/headersapply tosse/streamable-http.- Server name must start with a letter and contain only letters, digits,
-, or_, and is unique within the account (case-insensitive); violations return InvalidParameter. environment_kindaccepts onlybyoc(withenvironment_id) or empty for automatic selection —cloudcannot be bound directly to an MCP server.per_user_secretauth mode requiressecret_schemato be valid JSON with a non-emptyheader_name.- Every call is recorded in the account audit log.
Authorizations
App key issued from the Flashduty console. Required on every public API call. Keep it secret — it grants the same access as the owning account.
Body
Configuration for a new MCP server.
MCP server name, unique within the account.
1 - 255Server description.
1 - 1024Transport protocol: stdio launches a local process via command/args/env, sse / streamable-http connects to a remote service via url/headers.
stdio, sse, streamable-http Executable command (stdio transport).
Command arguments (stdio transport).
Environment variables (stdio transport).
Server URL (sse / streamable-http transport).
HTTP headers (sse / streamable-http).
Connection timeout in seconds. 0 = default (10s).
Tool-call timeout in seconds. 0 = default (60s).
Authentication mode: shared (default), per_user_secret, or per_user_oauth.
JSON secret schema; required when auth_mode=per_user_secret.
JSON OAuth metadata; reserved for per_user_oauth.
Initial status: enabled (default) or disabled (created but kept off).
enabled, disabled Team scope: 0 = account-wide; >0 = team.
Pin the server to a specific BYOC runner (environment_id required). Omit or send empty for automatic selection; cloud is not supported for MCP servers. The only accepted value: byoc (a self-hosted BYOC runner in the account; the MCP server process runs on the customer's own infrastructure).
byoc Runner ID; required when environment_kind is byoc.
Allow this server's OAuth token exchange over plaintext HTTP. Testing use only; defaults to false.
Skip TLS certificate verification when connecting to this server. Testing use only; defaults to false.
Marketplace template name when created from a connector template.
Response
Success
Standard response envelope used by every Flashduty public API. On success data contains the endpoint-specific payload and error is absent. On failure error is present and data is absent. request_id is always present and is also mirrored in the Flashcat-Request-Id response header.
Unique ID for this request. Mirrored in the Flashcat-Request-Id header. Include it when reporting issues.
"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"
Error payload inside the response envelope. Present only on non-2xx responses.
An MCP server (connector) registered on the account.