Skip to main content
POST
Probe an MCP server

Authorizations

Authorization
string
header
required

An API key from Settings → API keys, sent as Authorization: Bearer kb_live_…. A workspace key starts kb_; a personal key starts kbp_ and acts as its owner.

Headers

Kallabot-Version
enum<string>

The API version to answer as, a date (YYYY-MM-DD). Leave it out for the current version (2026-11-07). An unknown version is refused with 400 unsupported_api_version.

Available options:
2026-11-07
Example:

"2026-11-07"

Body

application/json
url
string
required
Required string length: 8 - 2000
transport
enum<string>
default:streamable_http
Available options:
sse,
streamable_http
auth
ToolAuth · object | null

How the tool authenticates to its own endpoint.

token/value are write-only: a client sends plaintext here when creating or editing a tool, and the server moves it into a sealed tool_credential (kallabot.services.tools); the tool keeps only {type: 'credential', credential_id}. Nothing that reads a tool back carries the secret; the credential shows a hint (last four characters).

Response

Successful Response

ok
boolean
required

True when the server answered and listed its tools.

status
string | null

connected, needs_auth, or an error status.

error
string | null

An error code when it failed.

server_info
Server Info · object | null

What the server says about itself.

hash
string | null

A fingerprint of the tool list.

tools
Tools · object[]

{name, description, parameters, required, input_schema, annotations} for each tool.