Install an MCP server

curl --request POST \
  --url https://api.hq.zone/v1/mcp/installs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "slug": "<string>",
  "config": "<unknown>"
}
'

{
  "enabled": true,
  "slug": "<string>"
}

Integrations

Install an MCP server

Installs or re-enables an MCP integration for the caller’s workspace, marking it active and enabled. Servers using a tenant credential model (tenant_api_key or tenant_oauth) require a credential reference in the request, which must be provisioned beforehand. Accepts an optional per-tenant config blob. Idempotent: re-installing updates the existing entry and preserves the prior credential reference and config when they are omitted. Returns the slug and enabled flag. Admin only; scoped to the caller’s own workspace.

POST

mcp

installs

curl --request POST \
  --url https://api.hq.zone/v1/mcp/installs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "slug": "<string>",
  "config": "<unknown>"
}
'

{
  "enabled": true,
  "slug": "<string>"
}

Authorizations

Authorization

string

header

required

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

Body

application/json

slug

string

required

config

any

Optional per-tenant config blob. Stored as-is in tenant_skill_installs.config - the materializer can read it when staging the pack.

Response

The installed / re-enabled server

enabled

boolean

required

slug

string

required

Get an MCP catalog icon Set an MCP server API key

⌘I