Clubhouse.so API Docs

Clubhouse.so exposes a small public discovery surface for agents and integrations. It includes RFC 9727 API discovery, Markdown negotiation, agent skills, OAuth metadata for protected agent access, and a lightweight MCP endpoint for read-only site discovery.

API Catalog OpenAPI MCP Server Card Agent Skills

Public endpoints

GET /.well-known/api-catalog returns the RFC 9727 API catalog as application/linkset+json.
GET /.well-known/openid-configuration returns delegated OIDC discovery metadata backed by Supabase Auth.
GET /.well-known/oauth-authorization-server returns OAuth authorization server metadata.
GET /.well-known/oauth-protected-resource returns OAuth protected resource metadata for the MCP endpoint.
GET /.well-known/mcp/server-card.json returns the MCP server card.
GET /.well-known/agent-skills/index.json returns the agent skills discovery index.
GET /api/health returns service health metadata.

Markdown negotiation

Public HTML routes return markdown when the request includes Accept: text/markdown. HTML remains the default for browsers.

curl -H "Accept: text/markdown" https://clubhouse.so/

MCP endpoint

The MCP endpoint is available at /api/mcp and currently exposes read-only discovery tools. It expects a Supabase bearer token for authenticated access.

curl https://clubhouse.so/api/mcp

curl https://clubhouse.so/.well-known/oauth-protected-resource

curl -X POST https://clubhouse.so/api/mcp \
  -H "Authorization: Bearer <supabase-access-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {},
      "clientInfo": { "name": "example-client", "version": "1.0.0" }
    }
  }'

OpenAPI and skills

The OpenAPI document describes the public discovery surface. The skills index exposes task-specific instructions agents can fetch and verify with SHA-256 digests.