mcp

List Mcp Tools

Changed on

List the tools a stored MCP server exposes to the authenticated workspace.

Call this once per server when preparing a model or workflow run, and reuse the answer for every tool from that server for the length of the run: there is no cross-run cache in this version, so a later run rediscovers and staleness stays bounded without any invalidation state to keep.

The response is the whole authorized catalog or an error. It is never partial, because a caller would read a short catalog as the complete input to its own authorization and risk policy. The single exception is warnings, which names a tool whose descriptor Otari could not carry.

A tool the server removes after discovery may still be proposed from the run's snapshot; execution then returns the remote server's own typed error.

get/api/v1/mcp/servers/{mcp_server_id}/tools

Request

  • The document declares no server URL.
  • Auth: one of:
    • API key in header Otari-Key
    • API key in header x-api-key

Path parameters

mcp_server_idstring uuid required

Response

Successful Response

server_idstring uuid required
server_revisionstring required

An opaque revision of the stored server's URL, credential, enabled state and allowlist. It detects Otari-side and platform-side configuration changes only: a remote server that changes its own catalog or a tool's behavior behind an unchanged URL will not move it.

Changes