Skip to main content
POST
Typescript (SDK)

Authorizations

Authorization
string
header
required

Send Authorization: Bearer , using an MKA1 API key for automation or an OAuth API access token for a signed-in application. Use a dynamic security callback to refresh OAuth access tokens. Browser session-only operations still require their declared cookie.

Headers

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Body

application/json
name
string
required
Required string length: 1 - 255
server_label
string
required
Required string length: 1 - 255
Pattern: ^[A-Za-z0-9._-]+$
server_url
string<uri>
required
Maximum string length: 2048
server_description
string | null
Maximum string length: 10000
allowed_tools
require_approval
enum<string>
default:always
Available options:
always,
never
metadata
object
shared_with_end_users
boolean
default:false

Let the end users this server's owner calls on behalf of use it, each with their own credentials. Off by default. Never put secrets in server_url of a shared server.

oauth
object | null

Response

201 - application/json

OK

id
string
required
object
any
required
name
string
required
server_label
string
required
server_url
string
required
server_description
string | null
required
allowed_tools
required
require_approval
enum<string>
required
Available options:
always,
never
metadata
object
required
shared_with_end_users
boolean
required

Whether the owner's end users can use this server, with their own credentials. Never lets them read or change it.

oauth
object | null
required
created_at
string<date-time>
required
updated_at
string<date-time>
required