---
title: "Search tools"
method: GET
path: "/connect/tools/{namespace}"
tags: ["connect.tools"]
---

# Search tools

`GET /connect/tools/{namespace}`

Search or list indexed tools across all connections in a namespace. If 'q' query parameter is omitted, returns all tools. Filter by connectionId or server URL. Metadata constraints from service tokens are applied automatically.

## Path parameters

- `namespace` string, required

## Query parameters

- `q` string
- `limit` integer
- `connectionId` string
- `server` string
- `excludeConnectionId` string
- `excludeServer` string
- `cursor` string

## Response `200`

Search results

- ToolsSearchResponse
  - `tools` ToolResult[], required
    - `connectionId` string, required
    - `serverUrl` string, required
    - `tool` object, required
      - `name` string, required
      - `description` string
    - `score` number
  - `nextCursor` string, nullable, required

## Other responses

- `400` — Bad request

## Changes

- **2026-01-28** `2b98c38deb26` — 2 info
  - added the new optional `query` request parameter `excludeConnectionId`
  - added the new optional `query` request parameter `excludeServer`
- **2026-01-25** `ea538dc2369a` — 1 warning
  - removed the optional property `tools/items/tool/inputSchema` from the response with the `200` status
- **2026-01-23** `9913f6c7ac34` — 1 info
  - the `query` request parameter `q` became optional

[Change history](https://skmtc.dev/smithery-ai/apis/smithery-platform-api/changes/connect/tools/:namespace/get.md)

---

[API](https://skmtc.dev/smithery-ai/apis/smithery-platform-api.md) · [All operations](https://skmtc.dev/smithery-ai/apis/smithery-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/smithery-ai/apis/smithery-platform-api/revisions/2b98c38deb26?raw)