---
title: "Get Tools"
method: GET
path: "/v3/integrations/{id}/tools"
tags: ["integrations-v3"]
---

# Get Tools

`GET /v3/integrations/{id}/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.

## Path parameters

- `id` string, required

## Response `200`

Successful Response

- IntegrationToolsResponse — Discovered tools for an MCP integration. Returned by ``GET /v3/integrations/{id}/tools``. The endpoint opens a live connection to the MCP server every call (no server-side cache) so the list reflects the server's current catalog.
  - `discovered` McpToolDescriptor[], required — All tools the MCP server reported, sorted by name.
    - `name` string, required
    - `description` string, nullable
  - `blocked` string[] — Raw MCP tool names hidden from the agent for this integration.
  - `descriptions` object — Saved agent-facing tool descriptions keyed by raw MCP tool name. A dynamic MCP tool must have a non-empty entry here before the agent can search for it.
  - `configured_mcp_tool_count` integer, required — Enabled dynamic MCP tools across all MCP servers in this organization.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/traversal/apis/fastapi.md) · [All operations](https://skmtc.net/traversal/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/traversal/fastapi/revisions/2134ebffd1ef/schema)