Skip to main content
GET
Get tool provider

Authorizations

Authorization
string
header
required

Organization API key, generated in studio.sidenet.ai. Backend only — never in a browser.

Path Parameters

id
string
required
Example:

"8d3b1a75-6c02-4e59-b84f-27a9d5e10c63"

Response

The provider, with every one of its tools. The provider fields are at the top level — there is no provider wrapper.

Stored credentials are redacted before this is returned — has_vault_secret says whether one exists, never what it is.

id
string

The tool_providers.id UUID for api/mcp/sidenet providers; the static key (e.g. rich-ui-components) or MCP server id for the built-in kinds.

name
string
type
enum<string>
Available options:
api,
mcp,
sidenet,
static,
global_mcp
description
string | null
auth_type
string | null
base_url
string | null

API providers only.

runtime_auth
boolean

The caller supplies credentials per request rather than storing them.

mcp_transport
string | null
has_vault_secret
boolean

A credential is stored for this provider. The secret itself is never returned.

tool_count
integer
agent_ids
string<uuid>[]

Agents whose ACTIVE version uses this provider — i.e. who breaks if you change it.

tools
object

Tools keyed by runtime key, NOT an array. Empty for an MCP provider that could not be reached — see mcp_load_error.

mcp_load_error
string | null

Why the last MCP load failed, when it did. MCP providers only; null when the provider loaded.