---
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.
  - `instructions` string, nullable — Full agent-facing instructions reported by the MCP server during initialization. Null when the server did not provide instructions.
  - `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 — Optional saved agent-facing tool descriptions keyed by raw MCP tool name.
  - `configured_mcp_tool_count` integer, required — Unblocked dynamic MCP tools with non-empty custom labels across all MCP servers in this organization.

## Other responses

- `422` — Validation Error

## Changes

> 23 revisions in range; 6 not diffed.

- **2026-08-26** `6ee9e975dda2` — 1 info
  - added the optional property `instructions` to the response with the `200` status

[Change history](https://skmtc.dev/traversal/apis/fastapi/changes/v3/integrations/:id/tools/get.md)

---

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