List MCP Tools
The tool definitions recorded for one MCP server.
tools/list on the
data plane. That response is the upstream’s advertised tools intersected with the
server’s allowed_tools and the presenting token’s own tools scope — so a
tool listed here can still be invisible, and unreachable, to a particular
credential.
Requires the read capability on ai_gateway. See the control-plane overview for authentication, the {data, meta} envelope, pagination and error types.Authorizations
OAuth 2.1 authentication — recommended for new integrations. Access tokens
(kc_ prefix) are minted at the root-host token endpoint
https://api.knoxcall.com/oauth/token and passed as Authorization: Bearer <access_token>.
Public clients must use PKCE with the authorization_code grant; confidential
clients may use client_credentials. The first-party SDKs and the
knoxcall login CLI handle token minting, caching, refresh, and DPoP for you.
Path Parameters
The MCP server UUID.
Query Parameters
Page number for pagination. Clamped server-side so the derived offset never exceeds 100,000 rows -- the effective maximum is floor(100000 / per_page) + 1, i.e. 1,001 at per_page=100. A larger value returns that last page, and meta.page reports it.
x >= 1Number of items per page (max 100).
1 <= x <= 100