Skip to main content
GET
List the tools an attached MCP server exposes

Authorizations

Authorization
string
header
required

User-bound credential carrying an identity: either a session JWT or a user access token (at:*) generated from the user settings UI. Send as Authorization: Bearer <token>. Org API keys (iak_*) are not accepted here - they carry no user identity. Use the x-prismeai-api-key header instead (see OrgApiKeyAuth).

Path Parameters

agentId
string
required
Maximum string length: 64
toolId
string
required
Maximum string length: 128

Response

Server tools, or the reason they could not be listed.

Tools an MCP server attached to an agent exposes, as returned by GET /v1/agents/{agentId}/tools/{toolId}/capabilities.

status
enum<string>
required

ok: items is the server's list. auth_required: OAuth-gated server the caller is not connected to; items is empty. unavailable: the handshake or tools/list failed; items is empty and error carries the message.

Available options:
ok,
auth_required,
unavailable
items
object[]
required
error
string

Transport or JSON-RPC error message when status is unavailable.