TEteaflask
authed

Remove an MCP server

Removes a server: agents lose its tools and its credential is discarded. While published agents use its tools, removing needs confirm.

delete/api/v1/org-mcp-servers/{server_id}

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/{server_id}
  • Auth
    none declared

Path parameters

server_idstring uuid required

The server's id, as list_org_mcp_servers returns it.

Query parameters

confirmboolean

Set true only after the person you're acting for has agreed to go ahead, having been told which published agents use this server's tools; a call without it names those agents and removes nothing.

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.