Skip to main content
POST
Create tool provider

Authorizations

Authorization
string
header
required

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

Body

application/json
name
string
required
Minimum string length: 1
Example:

"Acme CRM"

base_url
string<uri>
required
Example:

"https://api.acme.example"

type
enum<string>
default:api
Available options:
api,
mcp,
sidenet
description
string | null
Example:

"Customer records"

auth_type
enum<string> | null
Available options:
basic,
bearer,
api-key,
oauth2,
custom
auth_config
object | null
Example:
default_headers
object | null
Example:
runtime_auth
boolean
Example:

false

timeout_ms
integer
Required range: 1000 <= x <= 30000
Example:

30000

mcp_transport
enum<string> | null
Available options:
streamable_http,
sse
auth_secret
object
Example:
tools
object[]
Example:

Response

The provider, any tools created with it, and the rebuild that followed

provider
object
tools
object[]

The tools created from the tools array, with the names they were actually saved under — repeats are disambiguated, so check these rather than assuming.

rebuild
object
warning
string

Present only when an MCP provider was saved but its tools failed to load. The row IS persisted — it just has zero tools until the config is fixed.