Skip to main content
POST
Create MCP server

Authorizations

Authorization
string
header
required

JWT token obtained through Barndoor's OAuth 2.0 authorization-code flow with PKCE.

The token should be included in the Authorization header: Authorization: Bearer <your-jwt-token>

Use the Barndoor SDK's loginInteractive() function to obtain tokens automatically.

Body

application/json
name
string
required

Human-readable name for the server

Example:

"My Salesforce Instance"

mcp_server_directory_id
string<uuid>
required

ID of the server directory template to create from

slug
string

Optional URL-friendly identifier (auto-generated if not provided)

Pattern: ^[a-z0-9-]+$
client_id
string

OAuth client ID (for OAuth-enabled servers)

client_secret
string

OAuth client secret (for OAuth-enabled servers)

meta
object

Additional metadata for the server

Response

Server created successfully

id
string<uuid>

ID of the newly created server

connection_id
string | null

Connection ID if a connection was created

auth_url
string | null

OAuth authorization URL if authentication is required