---
title: "List tools exposed by an External MCP Connection"
method: GET
path: "/v1/mcp-connections/{connectionId}/tools"
tags: ["Capability Sources"]
---

# List tools exposed by an External MCP Connection

`GET /v1/mcp-connections/{connectionId}/tools`

Uses the Den-managed credential available to the calling member to read the live MCP tools/list catalog. Granted members can inspect connections available under Your Connections; workspace owners and admins can also inspect connections they manage. Credentials and tool calls are never returned.

## Path parameters

- `connectionId` string, typeid, required

## Response `200`

External MCP tool catalog.

- ExternalMcpConnectionToolListResponse
  - `tools` ExternalMcpConnectionTool[], required
    - `name` string, required
    - `title` string
    - `description` string
    - `inputSchema` object, required
    - `outputSchema` object
    - `annotations` ExternalMcpConnectionToolAnnotations
      - `title` string
      - `readOnlyHint` boolean
      - `destructiveHint` boolean
      - `idempotentHint` boolean
      - `openWorldHint` boolean
  - `policy` ExternalMcpConnectionToolPolicy, required
    - `allDisabled` boolean, required
    - `disabledTools` string[], required
    - `updatedBy` string, nullable, required
    - `updatedAt` string, date-time, nullable, required

## Other responses

- `401` — The caller must be signed in.
- `403` — The caller has not been granted access to this connection.
- `404` — Unknown connection.
- `409` — The connection has no usable credential for this member.
- `502` — The upstream MCP tool catalog could not be read.

---

[API](https://skmtc.net/openworklabs/apis/den-api.md) · [All operations](https://skmtc.net/openworklabs/apis/den-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openworklabs/den-api/versions/55ba7d5c7a7b/schema)