mcp

Fetch All Mcp Servers

Changed on

Returns the mcp server list with associated teams

get/v1/mcp/server

Request

  • Base URL
    https://api.flock.io (the document declares no server; this is the origin it was published from)
  • URL
    https://api.flock.io/v1/mcp/server
  • Auth
    API key in header x-litellm-api-key

Query parameters

team_idstring nullable

Filter MCP servers by team scope. When provided, returns only servers the team has access to plus globally available (allow_all_keys) servers. Used by the Create Key UI to show team-scoped MCP servers.

connected_app_viewboolean

Annotate each returned server with connected_app_reachable: whether a connected app authorized by the calling user (a gateway OAuth session) is served this server on the aggregate MCP endpoint.

Response

Successful Response

server_idstring required
server_namestring nullable
aliasstring nullable
descriptionstring nullable
urlstring nullable
spec_pathstring nullable
transport'sse' | 'http' | 'stdio' required
auth_type'none' | 'api_key' | 'bearer_token' | 'basic' | 'authorization' | 'oauth2' | 'aws_sigv4' | 'token' | 'oauth2_token_exchange' | 'oauth2_id_jag' | 'true_passthrough' | 'oauth_delegate' nullable
instructionsstring nullable
created_atstring date-time nullable
created_bystring nullable
updated_atstring date-time nullable
updated_bystring nullable
teamsobject[]
mcp_access_groupsstring[]
allowed_toolsstring[]
tool_name_to_display_nameobject nullable
tool_name_to_descriptionobject nullable
extra_headersstring[]
mcp_infoobject nullable
static_headersobject nullable
status'healthy' | 'unhealthy' | 'unknown' nullable

Health status: 'healthy', 'unhealthy', 'unknown'

last_health_checkstring date-time nullable
health_check_errorstring nullable
commandstring nullable
argsstring[]
envobject
issuerstring nullable
authorization_urlstring nullable
token_urlstring nullable
registration_urlstring nullable
oauth2_flow'client_credentials' | 'authorization_code' nullable
token_exchange_endpointstring nullable
audiencestring nullable
subject_token_typestring nullable
token_exchange_profilestring nullable
allow_all_keysboolean
available_on_public_internetboolean
delegate_auth_to_upstreamboolean
oauth_passthroughboolean
dcr_bridgeboolean nullable
per_server_oauth_discoveryboolean
is_byokboolean
byok_descriptionstring[]
byok_api_key_help_urlstring nullable
has_user_credentialboolean nullable
connected_app_reachableboolean nullable
source_urlstring nullable
timeoutnumber nullable
max_concurrent_requestsinteger nullable
approval_statusstring nullable

Approval status: 'pending_review', 'active', 'rejected'

submitted_bystring nullable
submitted_atstring date-time nullable
reviewed_atstring date-time nullable
review_notesstring nullable

Changes