Sign in
integrations-v3

Get Tools

List the tools an MCP integration's server exposes.

Opens a live connection to the configured MCP server and returns the discovered tool catalog. Each call hits the server — no server-side cache. Dynamic MCP tools are loaded through agent-side tool_search; this endpoint is read-only discovery for setup/debugging UI.

Permissions: users with integration-setup permission on the owning org.

Returns HTTP 404 if the instance does not exist in the caller's org. Returns HTTP 422 if the instance is not an MCP integration. Returns HTTP 502 if the MCP server cannot be reached or list_tools fails.

get/v3/integrations/{id}/tools

Path parameters

idstring required

Response

Successful Response

instructionsstring nullable

Full agent-facing instructions reported by the MCP server during initialization. Null when the server did not provide instructions.

blockedstring[]

Raw MCP tool names hidden from the agent for this integration.

descriptionsobject

Optional saved agent-facing tool descriptions keyed by raw MCP tool name.

configured_mcp_tool_countinteger required

Unblocked dynamic MCP tools with non-empty custom labels across all MCP servers in this organization.

Changes