List tools
Returns all available tools (static, MCP, and custom) grouped by provider. Each tool carries a toolRef — the stable reference object to store in a workflow tool step. Copy it verbatim; do not derive it from the grouping (global MCP tools group under mcp but use { source: "static", key }).
Pass basic=true for a compact catalogue that fits an agent context window: each provider is reduced to id, name, type, base_url and each tool to id, name, description — no JSON schemas, no auth config, no toolRef. Re-request without basic (or use GET /v1/tool-providers/:id) when you need a tool’s schema or its toolRef.
limit/offset paginate over items, where an item is one tool plus one slot for each provider that has no tools. Providers are re-grouped per page, so merging pages means merging the static/mcp/custom maps. Without limit the full catalogue is returned, as before. pagination reports { limit, offset, total, returned, hasMore }.
Authorizations
Organization API key, generated in studio.sidenet.ai. Backend only — never in a browser.
Query Parameters
Return only provider id/name/type/base_url and per-tool id/name/description. Off by default.
Max items to return (max 500). Omit to return the full catalogue.
0 <= x <= 50050
Items to skip before the page. Defaults to 0.
x >= 0