mcp
Register Mcp Server
Submit a new MCP server for admin review (non-admin users). Mirrors POST /guardrails/register.
post/v1/mcp/server/register
Request
- Base URL: https://apiclaw.biz (the document declares no server; this is the origin it was published from)
- URL: https://apiclaw.biz/v1/mcp/server/register
- Auth: API key in header x-litellm-api-key
Request body
server_idstring nullable
server_namestring nullable
aliasstring nullable
descriptionstring nullable
transport'sse' | 'http' | 'stdio'
auth_type'none' | 'api_key' | 'bearer_token' | 'basic' | 'authorization' | 'oauth2' | 'aws_sigv4' | 'token' | 'oauth2_token_exchange' | 'oauth2_id_jag' | 'true_passthrough' | 'oauth_delegate' nullable
urlstring nullable
spec_pathstring nullable
mcp_infoobject nullable
mcp_access_groupsstring[]
allowed_toolsstring[] nullable
tool_name_to_display_nameobject nullable
tool_name_to_descriptionobject nullable
extra_headersstring[] nullable
static_headersobject nullable
instructionsstring 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
source_urlstring nullable
timeoutnumber nullable
max_concurrent_requestsinteger nullable
approval_statusstring nullable
Server-managed: set by the endpoint; caller values are overridden.
submitted_bystring nullable
Server-managed: set by the endpoint; caller values are overridden.
submitted_atstring date-time nullable
Server-managed: set by the endpoint; caller values are overridden.
Response
Successful Response
server_idstring required
is_configboolean
Whether this server is defined in config and is read-only.
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
pinned_toolsobject nullable
extra_headersstring[]
mcp_infoobject nullable
static_headersobject nullable
status'healthy' | 'reachable' | 'unhealthy' | 'unknown' nullable
Health status: 'healthy', 'unhealthy', 'unknown', or 'reachable' (requires include_reachability=true; authentication and tools unchecked)
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
No recorded changes to this operation across all 1 revision of this API.