Skip to content
MCP Gateway

List MCP server registry records with UI-ready envelope metadata.

GET
/v1/mcp-servers

Fixed page_size is 50 and page is 1-indexed. Filtering uses the UI query keys exactly. Items include inline health, max tool risk tier, live/latest/pending immutable metadata, and backend-computed resource permissions.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
tenant_id
string
q
string
approval_status
string
risk
string
health
string
owner_team
string
credential_mode
string
last_used
string
all_envs
boolean
environment_id
string
show_archived
boolean
include_rejected
boolean
sort
string
/^[a-z_]+:(asc|desc)$/
page
integer
default: 1 >= 1

Responses

Section titled “ Responses ”

200

Section titled “200 ”

UI list envelope with records, KPIs, facets, and resource permissions.

object
schema_version
required
page
required
integer
>= 1
page_size
required
integer
total_count
required
integer
total_pages
required
integer
>= 1
kpis
required
object
total_servers
required
integer
approved_servers
required
integer
pending_submissions
required
integer
rejected_servers
required
integer
archived_servers
required
integer
deprecated
required
integer
teams
required
integer
unhealthy_servers
required
integer
critical_risk_servers
required
integer
facets
required
object
approval_status
required
Array<object>
object
value
required
string
>= 1 characters
count
required
integer
risk
required
Array<object>
object
value
required
string
>= 1 characters
count
required
integer
health
required
Array<object>
object
value
required
string
>= 1 characters
count
required
integer
owner_team
required
Array<object>
object
value
required
string
>= 1 characters
count
required
integer
credential_mode
required
Array<object>
object
value
required
string
>= 1 characters
count
required
integer
environment_id
required
Array<object>
object
value
required
string
>= 1 characters
count
required
integer
items
required
Array
object
schema_version
required
server_id
required
string
>= 1 characters
name
required
string
>= 1 characters
lifecycle_state
required
Allowed values: submitted under_review approved rejected disabled archived
approval_status
required
Allowed values: submitted under_review approved rejected disabled archived
registration_status
required
Allowed values: registered disabled deprecated
live_snapshot_id
string
>= 1 characters
live_manifest_hash
string
/^sha256:[0-9a-f]{64}$/
latest_submission
object
submission_id
required
string
>= 1 characters
sequence
required
integer
>= 1
status
required
string
Allowed values: submitted under_review approved rejected superseded
manifest_hash
required
string
/^sha256:[0-9a-f]{64}$/
submitted_by
required
string
>= 1 characters
submitted_at
required
string format: date-time
reviewed_by
string
reviewed_at
string format: date-time
review_reason_code
string
/^[a-z0-9_]+$/
review_reason
string
>= 1 characters
version
required
string
>= 1 characters
max_tool_risk_tier
required
Allowed values: low medium high critical
approved_tool_count
required
integer
denied_candidate_count
required
integer
superseded_by_submission_id
string
created_from_snapshot_id
string
pending_submission
object
submission_id
required
string
>= 1 characters
sequence
required
integer
>= 1
status
required
string
Allowed values: submitted under_review approved rejected superseded
manifest_hash
required
string
/^sha256:[0-9a-f]{64}$/
submitted_by
required
string
>= 1 characters
submitted_at
required
string format: date-time
reviewed_by
string
reviewed_at
string format: date-time
review_reason_code
string
/^[a-z0-9_]+$/
review_reason
string
>= 1 characters
version
required
string
>= 1 characters
max_tool_risk_tier
required
Allowed values: low medium high critical
approved_tool_count
required
integer
denied_candidate_count
required
integer
superseded_by_submission_id
string
created_from_snapshot_id
string
updated_at
required
string format: date-time
last_used_at
required
string format: date-time
nullable
owner
required
object
team
required
string
>= 1 characters
user_id
required
string
>= 1 characters
escalation_contact
required
string
>= 1 characters
oncall_rotation
required
string
>= 1 characters
environment_id
required
string
>= 1 characters
endpoint
string format: uri
transport
required
One of:
version
required
string
>= 1 characters
credential_mode
required
Allowed values: service_account user_delegated agent_scoped workload_mapped
max_tool_risk_tier
required
Allowed values: low medium high critical
health
required
object
status
required
Allowed values: healthy degraded unhealthy unknown
route_available
required
boolean
last_checked_at
required
string format: date-time
latency_ms
required
integer
checked_by
required
string
>= 1 characters
failure_reason
required
string
nullable /^[a-z0-9_]+$/
connector_status
required
Allowed values: healthy degraded unhealthy unknown not_configured
approved_tools
required
Array<object>
object
tool_id
required
string
>= 1 characters
name
required
string
>= 1 characters
description
required
string
>= 1 characters
risk_tier
required
Allowed values: low medium high critical
denied_candidates
required
Array<object>
object
tool_id
required
string
>= 1 characters
name
required
string
>= 1 characters
risk_tier
required
Allowed values: low medium high critical
reason_code
required
string
/^[a-z0-9_]+$/
change_history_pointers
required
Array<string>
catalog_visible
required
boolean
permissions
required
object
resource_type
required
Allowed values: mcp_server agent credential_binding client_session
resource_id
required
string
>= 1 characters
allowed_actions
required
Array
Allowed values: mcp_server.read mcp_server.register mcp_server.submit_revision mcp_server.resubmit mcp_server.edit_owner mcp_server.validate_manifest mcp_server.reprobe mcp_server.approve_submission mcp_server.reject_submission mcp_server.disable mcp_server.deprecate mcp_server.archive mcp_server.compare_versions agent.read agent.submit agent.edit agent.approve agent.reject agent.disable agent.archive agent.revoke api_source.read api_source.import api_source.review api_source.approve api_source.reject api_source.disable api_source.archive credential_binding.read credential_binding.create credential_binding.update credential_binding.rotate credential_binding.disable credential_binding.revoke credential_binding.approve credential_binding.audit_read identity_provider.read identity_provider.diagnose role_binding.read role_binding.manage local_identity.read local_identity.manage reason_code.read reason_code.manage approval_queue.read approval_queue.batch_approve

Type set in Geist, Source Serif 4, and Departure Mono.