Tool gateway

Read a tool server’s tools

Connects to the server and records what it lists. New and changed tools wait for approval. At most 10 refreshes a minute per organisation. Owner or admin, or a key with mcp:write.

post/client/mcp/upstreams/{id}/refresh

Request

  • Base URL: https://api.roar-ai.com
  • URL: https://api.roar-ai.com/client/mcp/upstreams/{id}/refresh
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Response

What the refresh found

toolsinteger required

Tools the server lists now

addedinteger required

New since the last refresh — they wait for approval

changedinteger required

Changed since the last refresh — hidden from agents until approved again

removedinteger required

No longer listed

Changes

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