---
title: "Get tool"
method: GET
path: "/{namespace}/{connectionId}/.tools/{toolPath}"
tags: ["connect"]
---

# Get tool

`GET /{namespace}/{connectionId}/.tools/{toolPath}`

Get one tool or list tools under a slash-separated category.

## Path parameters

- `namespace` string, required
- `connectionId` string, required
- `toolPath` string, required

## Response `200`

Tool metadata or category listing

- union
  - Tool
    - `name` string, required
    - `title` string
    - `icons` object[]
      - `src` string, required
      - `mimeType` string
      - `sizes` string[]
      - `theme` 'light' | 'dark'
    - `description` string
    - `inputSchema` object, required
      - `type` 'object', required
      - `properties` object
      - `required` string[]
    - `outputSchema` object
      - `type` 'object', required
      - `properties` object
      - `required` string[]
    - `annotations` object
      - `title` string
      - `readOnlyHint` boolean
      - `destructiveHint` boolean
      - `idempotentHint` boolean
      - `openWorldHint` boolean
    - `execution` object
      - `taskSupport` 'required' | 'optional' | 'forbidden'
    - `_meta` object
  - ToolList
    - `tools` Tool[], required
      - `name` string, required
      - `title` string
      - `icons` object[]
        - `src` string, required
        - `mimeType` string
        - `sizes` string[]
        - `theme` 'light' | 'dark'
      - `description` string
      - `inputSchema` object, required
        - `type` 'object', required
        - `properties` object
        - `required` string[]
      - `outputSchema` object
        - `type` 'object', required
        - `properties` object
        - `required` string[]
      - `annotations` object
        - `title` string
        - `readOnlyHint` boolean
        - `destructiveHint` boolean
        - `idempotentHint` boolean
        - `openWorldHint` boolean
      - `execution` object
        - `taskSupport` 'required' | 'optional' | 'forbidden'
      - `_meta` object

## Other responses

- `404` — Connection or tool not found

---

[API](https://skmtc.net/smithery-ai/apis/smithery-platform-api.md) · [All operations](https://skmtc.net/smithery-ai/apis/smithery-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smithery-ai/smithery-platform-api/versions/60b8c3d2fecf/schema)