Skip to main content
POST
Register an MCP server to your account

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme.

Body

application/json

Provide endpoint (a remote MCP server URL) or registry_name (an entry id from GET /hub/mcp/registry) — one is required.

endpoint
string

Remote MCP server URL. Works whether or not the server is listed in the public registry.

registry_name
string

A registry entry id, e.g. "io.github.owner/repo" — selects that entry instead of a URL.

Example:

"io.github.owner/repo"

transport
enum<string>
default:streamable-http

stdio is not supported for a registered remote server.

Available options:
streamable-http,
sse
server_id
string

Catalog id for this registration. Derived from name when omitted.

name
string
description
string
headers
object

Non-secret static headers replayed on every call. Do not put credentials here.

auth_token
string

Used only for this registration's handshake — never stored.

oauth_integration_id
string

An existing connection id from a prior OAuth handshake with this server.

auth_required
boolean

Marks the server as needing a credential supplied at call time.

tags
string[]
metadata
object
replace
boolean

Allow overwriting an existing registration with the same server_id.

env
object[]

Declared environment variables the server needs; echoed back so a connection form can collect them.

Response

Server registered successfully.

server_id
string
name
string
tools
object[]

The tools the server reported from its own tools/list handshake.

env
object[]

Declared environment variables, echoed back for a connection form.