Sign in
latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-216381,9552.9 MB

f2cf3228f366

MCP Servers

Search With Tool Count

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

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

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.