COconductorone
MCP Servers

Search With Tool Count

Changed on

SearchWithToolCount searches MCP servers with filtering and returns per-server tool state counts.

post/api/v1/apps/{app_id}/mcp_servers/search

Request

  • Base URL
    https://example.conductor.one
  • URL
    https://example.conductor.one/api/v1/apps/{app_id}/mcp_servers/search
  • Auth
    HTTP bearer and OAuth 2
    Client credentials
    Token URL: /auth/v1/token

Path parameters

app_idstring required

App identifier (required).

Request body

includeLastCalledAtboolean

When true, the server populates MCPServerView.last_called_at on each returned row by querying TSDB for the most recent mcp_tool_calls raw emit time per (app_id, connector_id). Costs one Dynamo Limit(1) read per row; callers that don't render the "Last used" value should leave false.

pageSizeinteger

Page size (max 100).

pageTokenstring

Page token for pagination.

querystring

Optional text query matched against display_name.

toolState'MCP_TOOL_STATE_UNSPECIFIED' | 'MCP_TOOL_STATE_PENDING_REVIEW' | 'MCP_TOOL_STATE_APPROVED' | 'MCP_TOOL_STATE_DISABLED' | 'MCP_TOOL_STATE_REMOVED'

Which tool state to return count for on each server.

Response

MCPServerServiceSearchWithToolCountResponse returns matching MCP servers with tool counts.

nextPageTokenstring

Token for next page.

Changes