Skip to content
MCP Gateway

Read an MCP server registry record with owner, health, approval, and history.

GET
/v1/mcp-servers/{server_id}

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
server_id
required
string

Query Parameters

Section titled “Query Parameters ”
tenant_id
string
>= 1 characters

Defaults to the configured bootstrap tenant when omitted.

environment_id
string
>= 1 characters

Defaults to the configured bootstrap environment when omitted.

Responses

Section titled “ Responses ”

200

Section titled “200 ”

MCP server registry record with resource permissions.

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
Examples
{
  "schema_version": "gateway.registry.server/v1",
  "server_id": "srv_legal_contracts_prod",
  "name": "legal-contract-review",
  "lifecycle_state": "submitted",
  "approval_status": "submitted",
  "registration_status": "registered",
  "environment_id": "prod",
  "credential_mode": "agent_scoped",
  "catalog_visible": false,
  "owner": {
    "team": "legal-platform",
    "user_id": "user_mina_owner",
    "escalation_contact": "legal-platform-oncall",
    "oncall_rotation": "legal-platform-primary"
  },
  "approved_tools": [],
  "denied_candidates": [],
  "change_history_pointers": [],
  "permissions": {
    "resource_type": "mcp_server",
    "resource_id": "srv_legal_contracts_prod",
    "allowed_actions": [
      "mcp_server.read",
      "mcp_server.edit_owner"
    ]
  }
}

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