---
title: "Search MCP connector tools"
method: GET
path: "/mcp-connectors/tools/search"
tags: ["MCP Connectors"]
---

# Search MCP connector tools

`GET /mcp-connectors/tools/search`

## Request

- Base URL: `https://api.sazabi.com/v1`
- URL: `https://api.sazabi.com/v1/mcp-connectors/tools/search`
- Auth: none declared

Search executable third-party MCP connector tools by free-text query. Empty query lists connectors; empty query plus namespace enumerates that connector. Hits omit input schemas unless includeInputSchema is true, which requires one exact namespaced tool and always returns at most one hit.

## Query parameters

- `projectId` string, uuid: Project to search connectors in. Auto-filled from SDK context when omitted.
- `query` string: Free-text query over tool names, titles, connector keys, and descriptions. Omit or empty to list connectors, or to enumerate one connector when namespace is set.
- `namespace` string: Restrict results to one connectionKey or providerId.
- `limit` integer: Maximum number of connectors or tool hits to return.
- `offset` integer: Number of connectors or tool hits to skip.
- `includeInputSchema` union: Load one exact tool's inputSchema. Requires a connectionKey namespace and non-empty query; accepts either toolName or the hit's copy-paste name.
  - boolean
  - string

## Response `200`

OK

- object
  - `kind` 'connectors' | 'tools', required: connectors when the query is empty and no namespace is set; tools otherwise.
  - `total` integer, required: Total matches before limit and offset.
  - `connectors` object[], required: Connector index. Empty when kind is tools.
    - `connectionKey` string, required: Stable key used to call this connector.
    - `displayName` string, required: Human-readable connector name.
    - `providerId` string, required: Provider identifier, e.g. "linear".
    - `toolCount` integer, required: Number of executable tools on this connector.
  - `tools` object[], required: Ranked or enumerated tool hits. Empty when kind is connectors.
    - `connectionKey` string, required: Connector that exposes this tool.
    - `toolName` string, required: Tool name as invoked.
    - `providerId` string, required: Provider identifier, e.g. "linear".
    - `displayName` string, required: Human-readable connector name.
    - `isReadOnly` boolean, required: Whether the tool is considered read-only.
    - `description` string, required: Tool description from the stored snapshot.
    - `score` number, required: BM25 rank score. Zero when enumerating a namespace.
    - `inputSchema` object: JSON Schema for the tool's arguments, when requested.

---

[API](https://skmtc.dev/sazabi/apis/sazabi-public-api.md) - [All operations](https://skmtc.dev/sazabi/apis/sazabi-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sazabi/apis/sazabi-public-api/revisions/965b6230cf45?raw)