---
title: "Get Mcp Server Submissions"
method: GET
path: "/v1/mcp/server/submissions"
tags: ["mcp_management"]
---

# Get Mcp Server Submissions

`GET /v1/mcp/server/submissions`

Returns all MCP servers submitted by non-admin users (admin review queue). Mirrors GET /guardrails/submissions.

## Response `200`

Successful Response

- MCPSubmissionsSummary
  - `active` integer, required
  - `items` LiteLLMMCPServerTable[], required
    - `alias` string, nullable
    - `allow_all_keys` boolean
    - `allowed_tools` string[]
    - `approval_status` string, nullable — Approval status: 'pending_review', 'active', 'rejected'
    - `args` string[]
    - `audience` string, nullable
    - `auth_type` 'none' | 'api_key' | 'bearer_token' | 'basic' | 'authorization' | 'oauth2' | 'aws_sigv4' | 'token' | 'oauth2_token_exchange' | 'oauth2_id_jag' | 'true_passthrough' | 'oauth_delegate', nullable
    - `authorization_url` string, nullable
    - `available_on_public_internet` boolean
    - `byok_api_key_help_url` string, nullable
    - `byok_description` string[]
    - `command` string, nullable
    - `connected_app_reachable` boolean, nullable
    - `created_at` string, date-time, nullable
    - `created_by` string, nullable
    - `credentials` MCPCredentials
      - `audience` string, nullable
      - `auth_value` string, nullable
      - `aws_access_key_id` string, nullable
      - `aws_region_name` string, nullable
      - `aws_role_name` string, nullable
      - `aws_secret_access_key` string, nullable
      - `aws_service_name` string, nullable
      - `aws_session_name` string, nullable
      - `aws_session_token` string, nullable
      - `client_assertion_signing_alg` string, nullable
      - `client_id` string, nullable
      - `client_private_key` string, nullable
      - `client_private_key_id` string, nullable
      - `client_secret` string, nullable
      - `id_jag_resource` string, nullable
      - `id_jag_resource_token_endpoint` string, nullable
      - `redirect_uris` string[], nullable
      - `scopes` string[], nullable
      - `subject_token_type` string, nullable
      - `token_endpoint_auth_method` 'client_secret_basic' | 'client_secret_post', nullable
      - `token_exchange_endpoint` string, nullable
      - `token_exchange_profile` string, nullable
      - `upstream_resource` string, nullable
      - `upstream_token_header` string, nullable
    - `dcr_bridge` boolean, nullable
    - `delegate_auth_to_upstream` boolean
    - `description` string, nullable
    - `env` object
    - `env_vars` MCPEnvVar[], nullable
      - `description` string, nullable
      - `name` string, required
      - `scope` 'global' | 'user' — Scope for an MCP server environment variable. - ``global``: value is provided by the admin and used for all users. - ``user``: each user must provide their own value via the per-user env-var endpoint. The admin-supplied ``value`` is treated as a placeholder/hint and is not used at request time.
      - `value` string
    - `extra_headers` string[]
    - `has_user_credential` boolean, nullable
    - `health_check_error` string, nullable
    - `instructions` string, nullable
    - `is_byok` boolean
    - `issuer` string, nullable
    - `last_health_check` string, date-time, nullable
    - `max_concurrent_requests` integer, nullable
    - `mcp_access_groups` string[]
    - `mcp_info` object, nullable
    - `oauth2_flow` 'client_credentials' | 'authorization_code', nullable
    - `oauth_passthrough` boolean
    - `registration_url` string, nullable
    - `review_notes` string, nullable
    - `reviewed_at` string, date-time, nullable
    - `server_id` string, required
    - `server_name` string, nullable
    - `source_url` string, nullable
    - `spec_path` string, nullable
    - `static_headers` object, nullable
    - `status` 'healthy' | 'unhealthy' | 'unknown', nullable — Health status: 'healthy', 'unhealthy', 'unknown'
    - `subject_token_type` string, nullable
    - `submitted_at` string, date-time, nullable
    - `submitted_by` string, nullable
    - `teams` object[]
    - `timeout` number, nullable
    - `token_exchange_endpoint` string, nullable
    - `token_exchange_profile` string, nullable
    - `token_url` string, nullable
    - `tool_name_to_description` object, nullable
    - `tool_name_to_display_name` object, nullable
    - `transport` 'sse' | 'http' | 'stdio', required
    - `updated_at` string, date-time, nullable
    - `updated_by` string, nullable
    - `url` string, nullable
  - `pending_review` integer, required
  - `rejected` integer, required
  - `total` integer, required

## Changes

- **2026-09-23** `7ed45f30a5f0` — 2 info
  - api tag `mcp_management` added
  - api tag `mcp` removed
- **2026-09-21** `6246f8d427b7` — 2 info
  - api tag `mcp` added
  - api tag `mcp_management` removed
- **2026-09-19** `c357baf422ab` — 2 info
  - api tag `mcp_management` added
  - api tag `mcp` removed
- **2026-09-18** `082b5fabd909` — 1 info
  - endpoint added
- **2026-09-16** `7afc3544d64d` — 1 breaking
  - api path removed without deprecation

[Full history](https://skmtc.dev/flock/apis/litellm-api/changes/v1/mcp/server/submissions/get.md)

---

[API](https://skmtc.dev/flock/apis/litellm-api.md) · [All operations](https://skmtc.dev/flock/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flock/apis/litellm-api/revisions/7ed45f30a5f0?raw)