Skip to main content
POST
Approve an MCP server's tools

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

Idempotency-Key
string
required

A unique key (a UUID works) for this request. Retrying with the same key returns the first answer instead of running twice.

Maximum string length: 255
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"

Path Parameters

tool_id
string
required

Body

application/json
hash
string
required
Required string length: 16 - 128

Response

Successful Response

id
string
required

The tool's id. Attach it to an agent as tools[].tool_id.

kind
enum<string>
required

api (an HTTP endpoint), mcp_server or google_sheets.

Available options:
api,
mcp_server,
google_sheets
name
string
required

The function name the agent calls.

description
string
required

When the agent should use it, in plain words.

category
string
required

A grouping label.

tool_schema
Tool Schema · object
required

The tool's definition (the schema it was saved with). Secrets are redacted.

tags
string[]
required

Free-form labels.

is_active
boolean
required

False when switched off; agents skip it.

version
integer
required

Bumped on every change. Send it back as If-Match on a write.

last_tested
string | null
required

When it was last tested (ISO 8601).

test_status
string | null
required

The last test's result: ok, or an error code.

created_at
string
required

When it was created (ISO 8601).

updated_at
string
required

When it last changed (ISO 8601).

credential_id
string | null

The saved secret it signs in with, if any.

connection_status
string
default:unknown

For an MCP server: connected, needs_auth, error or unknown.

last_error
string | null

The last connection error code, if any.

discovery
Discovery · object | null

For an MCP server: {tools, discovered_at, hash, …} from the last discovery.