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).

The ls_user_id query parameter allows service-key callers (which don’t carry ls_user_id in auth) to specify the user for per-user OAuth cache lookups.

GET /api/v1/mcp/tools

Error

A valid request URL is required to generate request examples

422

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

API KeyTenant IDBearer Auth

X-API-Key · string · header · required

Query Parameters

url · string · required

oauth_provider_id · string | null

ls_user_id · string | null

force_refresh · boolean · default: false

Response

200

application/json

Successful Response