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.

Path Parameters

server_id
string
required

Body

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

Turning sharing off revokes every end user's credential on the server.

oauth
object | null

Response

200 - 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