GET /v1/mcp-catalog — Catalog
Response
config_schema describes what the customer needs to supply at
registration (for tenant mode) or what each end-user supplies via the
hosted connect URL (for per-user mode). Fields with format: password
get rendered as secret inputs in the dashboard form.
POST /v1/mcp-servers — Register from catalog
- Curated (this page):
catalog_slug+config(matches the catalog’sconfig_schema). qlaud applies the entry’sbuildAuthHeaderstemplate to convert the config into the actual HTTP headers the server expects (e.g.{api_key: 'lin_…'}→{Authorization: 'lin_…'}for Linear; Notion adds theNotion-Versionheader automatically). - Raw URL (see /api-reference/mcp): for vendors not in the catalog or for your own internal MCP servers.
catalog_slug and server_url — pick one.
Body fields
| Field | Type | Required | Description |
|---|---|---|---|
name | string | yes | Per-account unique label, lowercase alnum + -/_, ≤31 chars. Becomes the prefix on every tool from this server. |
catalog_slug | string | yes (curated) | A slug from /v1/mcp-catalog. |
auth_mode | string | no | tenant (default) or per_user. See auth modes. |
config | object | conditional | Required when auth_mode='tenant'; matches the catalog entry’s config_schema. Omit when auth_mode='per_user' — credentials come from each end-user inline at runtime via the hosted connect URL flow. |
Per-user mode + curated catalog
When you register a curated MCP server withauth_mode: 'per_user',
each end-user supplies the same fields the catalog’s config_schema
declares — but inline in chat, via the hosted connect URL flow:
Authorization header value
they’re constructing — they fill in the friendly api_key field;
qlaud’s per-catalog template handles vendor-specific quirks (Linear’s
missing Bearer prefix, Notion’s Notion-Version header, Atlassian’s
HTTP Basic encoding).
Current catalog (35 entries)
Productivity & ticketing: linear, asana, clickup, monday, airtable, trello, hubspot, intercom, salesforce, pipedrive, zendesk, atlassian, notion. Dev / infra: github, gitlab, bitbucket, vercel, netlify, neon, supabase, cloudflare, sentry. Comms / scheduling: slack, cal, zoom, twilio. Analytics / observability: datadog, pagerduty, mixpanel. Payments: stripe, paypal, square, plaid. E-commerce / marketing: shopify, mailchimp. HitGET /v1/mcp-catalog for the live list with auth_mode,
config_schema, and approx_tool_count per entry. More vendors land
monthly — file an issue for any vendor publishing an MCP server we
should add.
Errors
| Status | Meaning |
|---|---|
| 400 | Body malformed: name invalid, both catalog_slug AND server_url set, unknown catalog_slug, missing required config field for the chosen catalog entry. |
| 401 | Bad / revoked qlk key. |
| 403 | Caller used a per-user (standard-scope) key. /v1/mcp-servers requires master scope. |
| 409 | An MCP server with the same name already exists for this account. |