authed

Add an MCP server

Adds a server with an access token or with no sign-in, once it has answered with its tools; a server that doesn't answer adds nothing.

post/api/v1/org-mcp-servers

Request

  • Base URL
    https://api.teaflask.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.teaflask.com/api/v1/org-mcp-servers
  • Auth
    none declared

Request body

display_namestring required

The server's name in the dashboard; without a usable one, the server's own title or its host.

urlstring password required

The server's full address, starting with https://.

tokenstring password nullable

An access token, sent as a bearer Authorization header.

Response

Successful Response

idstring uuid required

The server's id.

handlestring required

The server's short name in agent tool names; it never changes.

display_namestring required

The server's name in the dashboard.

hoststring required

The host name of the server's address.

state'active' | 'needs_reconnect' | 'failed' required
last_errorstring nullable required

Why the server last failed to connect, or null.

sign_in'oauth' | 'token' | 'none' required
header_namesstring[] required

The names of the headers carrying its access token.

tool_countinteger required

How many tools the server lists now.

new_tool_countinteger required

How many of those arrived after the server was added.

first_listed_atstring date-time required

When the server was added.

tools_refreshed_atstring date-time required

When its tool list was last read.

removed_atstring date-time nullable required

When the server was removed, or null while it is live.

created_atstring date-time required

When the server was created.

versioninteger required

Pass back as expected_version when renaming the server.

Changes

No recorded changes to this operation across all 1 revision of this API.