Error

A valid request URL is required to generate request examples

{
  "tools": [
    {}
  ],
  "cached": true,
  "fetched_at": "2023-11-07T05:31:56Z",
  "server_icon_url": "<string>"
}

{
  "detail": [
    "<string>"
  ]
}

Get tools

Return MCP tools — from cache if fresh, otherwise by fetching from remote.

On cache miss, tries manifest fetch first (fast), then falls back to full MCP handshake. Caches the result before returning.

Pass force_refresh=true to bypass the cache and always fetch from the remote server (the result is still cached via upsert for future requests).

agent_id lets deployment/service-key callers name an agent OAuth subject. ls_user_id overrides are limited to service identities.

GET

api

mcp

tools

Error

A valid request URL is required to generate request examples

{
  "tools": [
    {}
  ],
  "cached": true,
  "fetched_at": "2023-11-07T05:31:56Z",
  "server_icon_url": "<string>"
}

{
  "detail": [
    "<string>"
  ]
}

X-API-Key

string

header

required

url

string

required

oauth_provider_id

string | null

ls_user_id

string | null

agent_id

string | null

force_refresh

boolean

default:false

Successful Response

tools

Tools · object[]

required

cached

boolean

required

fetched_at

string<date-time> | null

required

server_icon_url

string | null