TEteaflask
authed

Refresh an MCP server's tools

Re-reads a server's tool list; a server that doesn't answer is marked failed or needing a reconnect, and the server comes back either way.

post/api/v1/org-mcp-servers/{server_id}/refresh

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

Path parameters

server_idstring uuid required

The server's id, as list_org_mcp_servers returns it.

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.