{ "/v1/mcp/access_groups": { "get": { "tags": [ "mcp", "mcp" ], "summary": "Get Mcp Access Groups", "description": "Get all available MCP access groups from the database AND config", "operationId": "get_mcp_access_groups_v1_mcp_access_groups_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "APIKeyHeader": [] } ] } }, "/v1/mcp/discover": { "get": { "tags": [ "mcp" ], "summary": "Discover Mcp Servers", "description": "Returns a curated list of well-known MCP servers for discovery UI", "operationId": "discover_mcp_servers_v1_mcp_discover_get", "security": [ { "APIKeyHeader": [] } ], "parameters": [ { "name": "query", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Search filter for server names and descriptions", "title": "Query" }, "description": "Search filter for server names and descriptions" }, { "name": "category", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Filter by category", "title": "Category" }, "description": "Filter by category" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/mcp/make_public": { "post": { "tags": [ "mcp" ], "summary": "Make Mcp Servers Public", "description": "Allows making MCP servers public for AI Hub", "operationId": "make_mcp_servers_public_v1_mcp_make_public_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MakeMCPServersPublicRequest" } } }, "required": true }, "responses": { "202": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "APIKeyHeader": [] } ] } }, "/v1/mcp/network/client-ip": { "get": { "tags": [ "mcp", "mcp" ], "summary": "Get Client Ip", "description": "Returns the caller's IP address as seen by the proxy.", "operationId": "get_client_ip_v1_mcp_network_client_ip_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "APIKeyHeader": [] } ] } }, "/v1/mcp/openapi-registry": { "get": { "tags": [ "mcp" ], "summary": "Get Openapi Registry", "description": "Returns well-known OpenAPI APIs with OAuth 2.0 metadata for the OpenAPI MCP picker", "operationId": "get_openapi_registry_v1_mcp_openapi_registry_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "APIKeyHeader": [] } ] } }, "/v1/mcp/registry.json": { "get": { "tags": [ "mcp", "mcp" ], "summary": "Get Mcp Registry", "description": "MCP registry endpoint. Spec: https://github.com/modelcontextprotocol/registry", "operationId": "get_mcp_registry_v1_mcp_registry_json_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/v1/mcp/server": { "get": { "tags": [ "mcp" ], "summary": "Fetch All Mcp Servers", "description": "Returns the mcp server list with associated teams", "operationId": "fetch_all_mcp_servers_v1_mcp_server_get", "security": [ { "APIKeyHeader": [] } ], "parameters": [ { "name": "team_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "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.", "title": "Team Id" }, "description": "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." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/LiteLLM_MCPServerTable" }, "title": "Response Fetch All Mcp Servers V1 Mcp Server Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "mcp" ], "summary": "Add Mcp Server", "description": "Allows creation of mcp servers", "operationId": "add_mcp_server_v1_mcp_server_post", "security": [ { "APIKeyHeader": [] } ], "parameters": [ { "name": "litellm-changed-by", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "The litellm-changed-by header enables tracking of actions performed by authorized users on behalf of other users, providing an audit trail for accountability", "title": "Litellm-Changed-By" }, "description": "The litellm-changed-by header enables tracking of actions performed by authorized users on behalf of other users, providing an audit trail for accountability" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewMCPServerRequest" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiteLLM_MCPServerTable" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "put": { "tags": [ "mcp" ], "summary": "Edit Mcp Server", "description": "Allows deleting mcp serves in the db", "operationId": "edit_mcp_server_v1_mcp_server_put", "security": [ { "APIKeyHeader": [] } ], "parameters": [ { "name": "litellm-changed-by", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "The litellm-changed-by header enables tracking of actions performed by authorized users on behalf of other users, providing an audit trail for accountability", "title": "Litellm-Changed-By" }, "description": "The litellm-changed-by header enables tracking of actions performed by authorized users on behalf of other users, providing an audit trail for accountability" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateMCPServerRequest" } } } }, "responses": { "202": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiteLLM_MCPServerTable" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/mcp/server/health": { "get": { "tags": [ "mcp" ], "summary": "Health Check Servers", "description": "Health check for MCP servers", "operationId": "health_check_servers_v1_mcp_server_health_get", "security": [ { "APIKeyHeader": [] } ], "parameters": [ { "name": "server_ids", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ], "description": "Server IDs to check. If not provided, checks all accessible servers.", "title": "Server Ids" }, "description": "Server IDs to check. If not provided, checks all accessible servers." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/mcp/server/oauth/session": { "post": { "tags": [ "mcp" ], "summary": "Add Session Mcp Server", "description": "Temporarily cache an MCP server in memory without writing to the database", "operationId": "add_session_mcp_server_v1_mcp_server_oauth_session_post", "security": [ { "APIKeyHeader": [] } ], "parameters": [ { "name": "litellm-changed-by", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "The litellm-changed-by header enables tracking of actions performed by authorized users on behalf of other users, providing an audit trail for accountability", "title": "Litellm-Changed-By" }, "description": "The litellm-changed-by header enables tracking of actions performed by authorized users on behalf of other users, providing an audit trail for accountability" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewMCPServerRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/mcp/server/register": { "post": { "tags": [ "mcp" ], "summary": "Register Mcp Server", "description": "Submit a new MCP server for admin review (non-admin users). Mirrors POST /guardrails/register.", "operationId": "register_mcp_server_v1_mcp_server_register_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewMCPServerRequest" } } }, "required": true }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiteLLM_MCPServerTable" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } }, "security": [ { "APIKeyHeader": [] } ] } }, "/v1/mcp/server/submissions": { "get": { "tags": [ "mcp" ], "summary": "Get Mcp Server Submissions", "description": "Returns all MCP servers submitted by non-admin users (admin review queue). Mirrors GET /guardrails/submissions.", "operationId": "get_mcp_server_submissions_v1_mcp_server_submissions_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MCPSubmissionsSummary" } } } } }, "security": [ { "APIKeyHeader": [] } ] } }, "/v1/mcp/server/{server_id}": { "get": { "tags": [ "mcp" ], "summary": "Fetch Mcp Server", "description": "Returns the mcp server info", "operationId": "fetch_mcp_server_v1_mcp_server__server_id__get", "security": [ { "APIKeyHeader": [] } ], "parameters": [ { "name": "server_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Server Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiteLLM_MCPServerTable" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "mcp" ], "summary": "Remove Mcp Server", "description": "Allows deleting mcp serves in the db", "operationId": "remove_mcp_server_v1_mcp_server__server_id__delete", "security": [ { "APIKeyHeader": [] } ], "parameters": [ { "name": "server_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Server Id" } }, { "name": "litellm-changed-by", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "The litellm-changed-by header enables tracking of actions performed by authorized users on behalf of other users, providing an audit trail for accountability", "title": "Litellm-Changed-By" }, "description": "The litellm-changed-by header enables tracking of actions performed by authorized users on behalf of other users, providing an audit trail for accountability" } ], "responses": { "202": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/mcp/server/{server_id}/approve": { "put": { "tags": [ "mcp" ], "summary": "Approve Mcp Server Submission", "description": "Approve a pending MCP server submission (admin only). Mirrors PUT /guardrails/{id}/approve.", "operationId": "approve_mcp_server_submission_v1_mcp_server__server_id__approve_put", "security": [ { "APIKeyHeader": [] } ], "parameters": [ { "name": "server_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Server Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiteLLM_MCPServerTable" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/mcp/server/{server_id}/oauth-user-credential": { "post": { "tags": [ "mcp" ], "summary": "Store Mcp Oauth User Credential", "description": "Store the calling user's OAuth2 token for an OpenAPI MCP server", "operationId": "store_mcp_oauth_user_credential_v1_mcp_server__server_id__oauth_user_credential_post", "security": [ { "APIKeyHeader": [] } ], "parameters": [ { "name": "server_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Server Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MCPOAuthUserCredentialRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MCPOAuthUserCredentialStatus" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "mcp" ], "summary": "Delete Mcp Oauth User Credential", "description": "Revoke the calling user's stored OAuth2 token for an MCP server", "operationId": "delete_mcp_oauth_user_credential_v1_mcp_server__server_id__oauth_user_credential_delete", "security": [ { "APIKeyHeader": [] } ], "parameters": [ { "name": "server_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Server Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MCPOAuthUserCredentialStatus" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/mcp/server/{server_id}/oauth-user-credential/status": { "get": { "tags": [ "mcp" ], "summary": "Get Mcp Oauth User Credential Status", "description": "Check whether the calling user has a stored OAuth2 credential for this MCP server", "operationId": "get_mcp_oauth_user_credential_status_v1_mcp_server__server_id__oauth_user_credential_status_get", "security": [ { "APIKeyHeader": [] } ], "parameters": [ { "name": "server_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Server Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MCPOAuthUserCredentialStatus" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/mcp/server/{server_id}/reject": { "put": { "tags": [ "mcp" ], "summary": "Reject Mcp Server Submission", "description": "Reject a pending MCP server submission (admin only). Mirrors PUT /guardrails/{id}/reject.", "operationId": "reject_mcp_server_submission_v1_mcp_server__server_id__reject_put", "security": [ { "APIKeyHeader": [] } ], "parameters": [ { "name": "server_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Server Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RejectMCPServerRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiteLLM_MCPServerTable" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/mcp/server/{server_id}/user-credential": { "post": { "tags": [ "mcp" ], "summary": "Store Mcp User Credential", "description": "Store or update the calling user's API key for a BYOK MCP server", "operationId": "store_mcp_user_credential_v1_mcp_server__server_id__user_credential_post", "security": [ { "APIKeyHeader": [] } ], "parameters": [ { "name": "server_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Server Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MCPUserCredentialRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MCPUserCredentialResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "mcp" ], "summary": "Delete Mcp User Credential", "description": "Delete the calling user's stored API key for a BYOK MCP server", "operationId": "delete_mcp_user_credential_v1_mcp_server__server_id__user_credential_delete", "security": [ { "APIKeyHeader": [] } ], "parameters": [ { "name": "server_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Server Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MCPUserCredentialResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/mcp/tools": { "get": { "tags": [ "mcp", "mcp" ], "summary": "Get Mcp Tools", "description": "Get all MCP tools available for the current key, including those from access groups", "operationId": "get_mcp_tools_v1_mcp_tools_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } }, "security": [ { "APIKeyHeader": [] } ] } }, "/v1/mcp/toolset": { "post": { "tags": [ "mcp" ], "summary": "Add Mcp Toolset", "description": "Create a new MCP toolset (admin only)", "operationId": "add_mcp_toolset_v1_mcp_toolset_post", "security": [ { "APIKeyHeader": [] } ], "parameters": [ { "name": "litellm-changed-by", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Litellm-Changed-By" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewMCPToolsetRequest" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "mcp" ], "summary": "Fetch Mcp Toolsets", "description": "List MCP toolsets accessible to the calling key", "operationId": "fetch_mcp_toolsets_v1_mcp_toolset_get", "security": [ { "APIKeyHeader": [] } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } }, "put": { "tags": [ "mcp" ], "summary": "Edit Mcp Toolset", "description": "Update an existing MCP toolset (admin only)", "operationId": "edit_mcp_toolset_v1_mcp_toolset_put", "security": [ { "APIKeyHeader": [] } ], "parameters": [ { "name": "litellm-changed-by", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Litellm-Changed-By" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateMCPToolsetRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/mcp/toolset/{toolset_id}": { "get": { "tags": [ "mcp" ], "summary": "Fetch Mcp Toolset", "description": "Get a specific MCP toolset by ID", "operationId": "fetch_mcp_toolset_v1_mcp_toolset__toolset_id__get", "security": [ { "APIKeyHeader": [] } ], "parameters": [ { "name": "toolset_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Toolset Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "mcp" ], "summary": "Remove Mcp Toolset", "description": "Delete an MCP toolset (admin only)", "operationId": "remove_mcp_toolset_v1_mcp_toolset__toolset_id__delete", "security": [ { "APIKeyHeader": [] } ], "parameters": [ { "name": "toolset_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Toolset Id" } }, { "name": "litellm-changed-by", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Litellm-Changed-By" } } ], "responses": { "202": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/mcp/user-credentials": { "get": { "tags": [ "mcp" ], "summary": "List Mcp User Credentials", "description": "List all OAuth2 MCP credentials stored for the calling user", "operationId": "list_mcp_user_credentials_v1_mcp_user_credentials_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/MCPUserCredentialListItem" }, "type": "array", "title": "Response List Mcp User Credentials V1 Mcp User Credentials Get" } } } } }, "security": [ { "APIKeyHeader": [] } ] } } }