Skip to main content
POST

Authorizations

​
Authorization
string
header
required

Your SLNG consumer API key.

Body

application/json

Configuration for the MCP server to register.

Configuration for registering a new MCP server, covering transport, endpoint URL, authentication, extra headers, and any Vault secrets to create or reference.

​
name
string
required
Required string length: 1 - 200
​
url_template
string
required

Endpoint URL for the MCP server. Embed Vault secret placeholders with the {{$NAME}} grammar to keep credentials out of the URL.

Required string length: 1 - 2000
​
transport
enum<string>
default:streamable_http

Transport to reach the MCP server: streamable_http (the default) for streamable HTTP, or sse for Server-Sent Events.

Available options:
streamable_http,
sse
​
description
string | null

Optional human-readable description of the MCP server.

Maximum string length: 500
​
auth
No authentication · object

Send requests to the MCP server without an Authorization header.

​
headers
(Literal header · object | Vault-backed header · object)[]

Extra request headers to send to the MCP server. Each header is a literal value or a reference to a Vault secret.

Maximum array length: 64

A request header with a fixed, inline value.

​
credentials
(Use an existing Vault secret · object | Create a new Vault secret · object)[]

Vault secrets to create or reference for use by the URL, auth, or headers. Every credential name you supply must be referenced by the configuration.

Maximum array length: 64

Reference a secret already stored in Vault by secret_name.

Response

The registered MCP server.

Stored MCP server record with its configuration and the latest discovered capability state. Secret values and transient credential input never appear here.

​
id
string<uuid>
required
​
organisation_id
string<uuid>
required
​
name
string
required
​
transport
enum<string>
required

Transport used to reach the MCP server: streamable_http for streamable HTTP, or sse for Server-Sent Events.

Available options:
streamable_http,
sse
​
url_template
string
required

Stored endpoint URL for the MCP server. Any {{$NAME}} Vault secret placeholders are kept verbatim and resolved at connection time.

​
auth
No authentication · object
required

Send requests to the MCP server without an Authorization header.

​
revision
integer
required
​
capability_status
enum<string>
required

Health of the MCP server capabilities: unknown (not probed yet), healthy (reachable and tools discovered), unavailable (probe failed or unreachable), invalid (reachable but returned an unsupported contract), or circuit_open (temporarily disabled after repeated failures and retried after a cooldown).

Available options:
unknown,
healthy,
unavailable,
invalid,
circuit_open
​
capability_revision
integer
required
​
description
string | null
​
headers
(Literal header · object | Vault-backed header · object)[]

Stored request headers for the MCP server; each value is inline or resolved from a Vault secret.

A request header with a fixed, inline value.

​
capability_observed_at
string<date-time> | null
​
capability_attempted_at
string<date-time> | null
​
capabilities_hash
string | null
​
capabilities
McpCapabilities · object | null

Tools discovered from the MCP server, with flags for whether discovery was truncated and how many pages were fetched.

​
capability_error_code
string | null
​
capability_error_message
string | null
​
capability_tool_count
integer | null
​
next_refresh_at
string<date-time> | null