Skip to main content
POST
Add an MCP server to the organization's catalog

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
display_name
string
required
Required string length: 1 - 100
key
string
required
Pattern: ^[a-z][a-z0-9_-]{0,31}$
kind
enum<string>
required
Available options:
http
required
boolean
required

True: a task is not created until the connection its project's credential policy names can be used, and a turn that cannot reach the server fails, naming it. False, the Integrations tab's default: a task whose connection cannot be used starts without the server, and its agent is not given it.

url
string
required
Required string length: 1 - 2048
Pattern: ^https://
api_key
boolean

True: authenticate with an API key sent as a bearer token (auth static_secret) instead of the OAuth the server advertises; refused for a server that asks for no credential. False or omitted: the auth the probe finds. The URL is probed again when it changed or when an API-key server stops being one; a server's connections go when its URL or auth changes.

headers
object

Non-secret headers sent upstream on every request, as a local .mcp.json entry's headers: GitHub's X-MCP-Toolsets, for one. Never Authorization, Accept, Content-Type, Last-Event-ID or an Mcp-* header. Omitted: none. One of Aether's own servers keeps the headers Aether defines for it (X-MCP-Readonly on github_readonly).

Response

Created

mcp_server
object
required