Skip to main content
POST
Install a local MCP server for the organization

Authorizations

Authorization
string
header
required

A Barndoor API key, sent as Authorization: Bearer <key>. Keys are prefixed bdai_ and are opaque — do not attempt to decode one. Interchangeable with an OAuth 2.0 access token.

Scopes

openid

Issue an OIDC ID token identifying the caller.

profile

Read the caller's basic profile claims.

email

Read the caller's email address.

Body

application/json
catalog_id
string<uuid>
required

Id of the local MCP catalog entry to install (its server-directory id).

slug
string
required

Installation slug, unique in the organization; users see it in barndoor list.

Pattern: ^[a-z][a-z0-9-]{0,99}$
name
string
required

Display name.

Required string length: 1 - 255
enabled
boolean
default:true
configuration
Configuration · object

Values for the catalog entry's configuration_schema: a flat object of scalar values, every required key present and no undeclared key. Not for secrets.

availability
enum<string>
default:opt_in

opt_in: only users who connect it get it. required: every Barndoor CLI in the organization gets it.

Available options:
opt_in,
required

Response

Successful Response

id
string<uuid>
required
catalog_id
string<uuid>
required
slug
string
required
name
string
required
enabled
boolean
required
configuration
Configuration · object
required
availability
enum<string>
required
Available options:
opt_in,
required
runtime
EmbeddedRuntime · object
required
configuration_schema
Configuration Schema · object
required