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

Deprecated; runtime credentials are accepted for every provider.

require_runtime_auth
boolean

When true, a call with no per-user credential for this provider fails instead of using the stored one.

platform
object

Present when the provider is owned by the platform organization and seen from another org: read-only here (edits answer 403 naming the owner). Its stored credential serves this org’s calls only when granted is true; otherwise every user needs a tools_auth entry for it.

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.

grants
object[]

Platform organization only, on its own providers: the organizations it granted this provider to (POST /v1/tool-providers/{id}/grants), oldest first. Each may use the stored credential.

mcp_load_error
string | null

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