Skip to main content
POST
Probe a custom MCP URL

Authorizations

Authorization
string
header
required

Personal Access Token. Send as Authorization: Bearer hq_pat_....

Body

application/json

Enqueue a hq.mcp.tenant.{tenant_id}.changed event into the outbox. The publisher relays to NATS; every gateway instance receives it and invalidates the per-tenant Forge catalog cache.

url
string
required

Response

Detected auth + connectability + tool preview

auth
string
required

none | api_key | oauth | oauth_unsupported

auth_label
string
required

Short human label for the detected method.

connectable
boolean
required

True when the tenant can finish the connection with no operator involvement (open, OAuth + DCR public client, or paste-a-key).

endpoint
string
required
tool_count
integer
required
Required range: x >= 0
tools
object[]
required
note
string | null

Set when connectable is false: why, in one sentence.

server_name
string | null