curl --request POST \
--url https://api.agents.slng.ai/v1/agents/mcp-servers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "crawler",
"url_template": "https://mcp.example.com",
"transport": "streamable_http"
}
'{
"id": "4f9a2b1c-8d3e-4a2b-9c1d-2e3f4a5b6c7d",
"organisation_id": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d",
"name": "crawler",
"description": "Web crawler tools",
"transport": "streamable_http",
"url_template": "https://mcp.example.com",
"auth": {
"type": "none"
},
"headers": [],
"revision": 1,
"capability_status": "unknown",
"capability_revision": 0
}{
"detail": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"retryable": true,
"fields": [
{}
]
}
}{
"detail": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"retryable": true,
"fields": [
{}
]
}
}{
"detail": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"retryable": true,
"fields": [
{}
]
}
}{
"detail": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"retryable": true,
"fields": [
{}
]
}
}{
"detail": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"retryable": true,
"fields": [
{}
]
}
}{
"detail": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"retryable": true,
"fields": [
{}
]
}
}Create MCP Server
Register an MCP server for the organisation and schedule an immediate capability probe. The url_template, auth, and headers are validated and every referenced Vault secret must already exist. A duplicate live name returns 409.
curl --request POST \
--url https://api.agents.slng.ai/v1/agents/mcp-servers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "crawler",
"url_template": "https://mcp.example.com",
"transport": "streamable_http"
}
'{
"id": "4f9a2b1c-8d3e-4a2b-9c1d-2e3f4a5b6c7d",
"organisation_id": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d",
"name": "crawler",
"description": "Web crawler tools",
"transport": "streamable_http",
"url_template": "https://mcp.example.com",
"auth": {
"type": "none"
},
"headers": [],
"revision": 1,
"capability_status": "unknown",
"capability_revision": 0
}{
"detail": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"retryable": true,
"fields": [
{}
]
}
}{
"detail": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"retryable": true,
"fields": [
{}
]
}
}{
"detail": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"retryable": true,
"fields": [
{}
]
}
}{
"detail": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"retryable": true,
"fields": [
{}
]
}
}{
"detail": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"retryable": true,
"fields": [
{}
]
}
}{
"detail": "<string>",
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"retryable": true,
"fields": [
{}
]
}
}Authorizations
Your SLNG consumer API key.
Body
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.
1 - 200Endpoint URL for the MCP server. Embed Vault secret placeholders with the {{$NAME}} grammar to keep credentials out of the URL.
1 - 2000Transport to reach the MCP server: streamable_http (the default) for streamable HTTP, or sse for Server-Sent Events.
streamable_http, sse Optional human-readable description of the MCP server.
500Send requests to the MCP server without an Authorization header.
- No authentication
- Bearer token
- Custom auth header
Show child attributes
Show child attributes
Extra request headers to send to the MCP server. Each header is a literal value or a reference to a Vault secret.
64A request header with a fixed, inline value.
- Literal header
- Vault-backed header
Show child attributes
Show child attributes
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.
64Reference a secret already stored in Vault by secret_name.
- Use an existing Vault secret
- Create a new Vault secret
Show child attributes
Show child attributes
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.
Transport used to reach the MCP server: streamable_http for streamable HTTP, or sse for Server-Sent Events.
streamable_http, sse Stored endpoint URL for the MCP server. Any {{$NAME}} Vault secret placeholders are kept verbatim and resolved at connection time.
Send requests to the MCP server without an Authorization header.
- No authentication
- Bearer token
- Custom auth header
Show child attributes
Show child attributes
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).
unknown, healthy, unavailable, invalid, circuit_open 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.
- Literal header
- Vault-backed header
Show child attributes
Show child attributes
Tools discovered from the MCP server, with flags for whether discovery was truncated and how many pages were fetched.
Show child attributes
Show child attributes