Skip to content
MCP Gateway

Probe a remote MCP server and return discovered tools for registration review.

POST
/v1/registry/probe-mcp-server

Performs MCP initialize and tools/list from the backend. The probe does not register or approve the server.

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
object
tenant_id
required
string
>= 1 characters
environment_id
required
string
>= 1 characters
transport
required
One of:
endpoint
string format: uri
/^https:///
credential_mode
Allowed values: service_account user_delegated agent_scoped workload_mapped
credential_binding_id
string
>= 1 characters

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Probe result. Network and protocol failures are returned as failed probe results, not registry records.

object
probe_id
required
string
>= 1 characters
probe_status
required
Allowed values: running succeeded failed
tenant_id
required
string
>= 1 characters
environment_id
required
string
>= 1 characters
transport
required
One of:
endpoint
string format: uri
protocol_version
required
One of:
string
capabilities
required
Array<string>
tools
required
Array<object>
object
tool_id
required
string
>= 1 characters
name
required
string
>= 1 characters
description
required
string
input_schema
required
suggested_risk_tier
required
Allowed values: low medium high critical
suggested_gateway_status
required
Allowed values: allowed denied_candidate
denied_reason
string
/^[a-z0-9_]+$/
input_schema_ref
required
string
>= 1 characters
policy_refs
required
Array<string>
warnings
required
Array<object>
object
reason_code
required
string
/^[a-z0-9_]+$/
field
required
string
>= 1 characters
message
required
string
>= 1 characters
errors
required
Array<object>
object
reason_code
required
string
/^[a-z0-9_]+$/
field
required
string
>= 1 characters
message
required
string
>= 1 characters

422

Section titled “422 ”

Probe request rejected before outbound network access.

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