Skip to main content
GET
List Tools

Authorizations

Authorization
string
header
required

Mixpeek API key, sent as Authorization: Bearer mxp_sk_.... Create one in Studio under Settings → API Keys, or with an admin key via POST /v1/organizations/users/{user_email}/api-keys. A missing, malformed, unknown, revoked, inactive or expired key returns 401; a key without the permission, scope or plan an operation needs returns 403.

X-Namespace
string
header
required

Namespace id (ns_...), not the namespace name. This scopes the request rather than authenticating it, and it is required on every operation marked x-mixpeek-namespace-scoped.

Query Parameters

category
string | null

Filter by tool category

Response

Successful Response

Response for listing available agent tools.

Use this endpoint to discover available tools before creating a session. Pass tool names to available_tools in AgentConfig when creating a session.

Attributes: results: List of available tools with descriptions total: Total number of tools available categories: Unique tool categories

Example: python response = ListToolsResponse( results=[ ToolInfo(name="smart_search", description="...", category="search"), ToolInfo(name="list_collections", description="...", category="read"), ], total=25, categories=["search", "read", "create"] )

results
ToolInfo · object[]
required

Available tools

total
integer
required

Total number of tools

categories
string[]
required

Unique tool categories