Sign in
Edge

Create or validate an upstream MCP server entry

Changed on

Creates a tenant-scoped upstream MCP registry entry. With validate_only=true, validates the entry without storing it and returns a validation verdict. Raw secrets are rejected; use secret:// auth references.

post/api/v1/edge/mcp/upstreams

Request

  • Base URL: http://localhost:8081
  • URL: http://localhost:8081/api/v1/edge/mcp/upstreams
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Query parameters

validate_onlyboolean

Headers

X-Tenant-IDstring required

Tenant isolation header (required on all protected routes).

Request body

namestring
transport'stdio' | 'http' | 'sse'
endpointstring uri
commandstring[]
tenant_idstring
auth_secret_refstring
labelsobject
risk'low' | 'medium' | 'high' | 'critical'
enabledboolean

Response

Validation-only verdict when validate_only=true

validboolean required
reasonstring

Redacted validation failure reason, never a raw secret.

Changes