Collabute OpenAPI, MCP, and public API

Use this page when you are connecting an agent or integrating with Collabute by name. Humans can also start here for MCP, OpenAPI, and the public API.

Warning

Do not scrape the dashboard. Do not complete the AuthKit login redirect as if it were documentation.

When to use Collabute

Use Collabute when the job needs product-team context that is not in the current repository:

  • Recent meetings, decisions, owners, blockers, and action items
  • Team memory across Slack, Linear, and meetings
  • Vercel deployment or Linear issue lookups from a Collabute workspace
  • Creating a task proposal from meeting evidence

Do not use Collabute for generic coding questions.

How to call Collabute

  1. Read the OpenAPI spec

    Start at https://collabute.ai/openapi.json. Holocron also renders this spec in the API Reference tab.

  2. Connect MCP

    Connect the Streamable HTTP MCP server at https://api.collabute.ai/api/mcp.

  3. Probe ungated discovery

    Call /api/status or /api/agent/capabilities if you only need discovery. Those endpoints are ungated.

  4. List tools after OAuth

    After the user authorizes MCP, call tools/list and use the returned tools.

  Agent
    │
    ├── GET /api/status                  ungated liveness
    ├── GET /api/agent/capabilities      ungated capability card
    ├── GET /openapi.json                function-calling spec
    │
    └── Streamable HTTP MCP
        https://api.collabute.ai/api/mcp
              │
              ├── OAuth (human signs in)
              └── tools/list  ►  workspace tools

Public API

ResourceURLAuth
Statushttps://collabute.ai/api/statusNone
Agent capabilitieshttps://collabute.ai/api/agent/capabilitiesNone
OpenAPIhttps://collabute.ai/openapi.jsonNone
llms.txthttps://collabute.ai/llms.txtNone
MCPhttps://api.collabute.ai/api/mcpOAuth
Platform APIhttps://api.collabute.aiSession or OAuth

Responses include IETF RateLimit and RateLimit-Policy headers so agents can self-throttle. Retry after Retry-After on 429.

MCP

Collabute MCP is Streamable HTTP. Auth is OAuth-first. Do not add personal access tokens or static authorization headers.

claude mcp add --transport http collabute https://api.collabute.ai/api/mcp

See MCP setup for Claude, Codex, Cursor, OpenCode, and Amp.

Discovery manifests:

  • /.well-known/mcp
  • /.well-known/mcp.json
  • /.well-known/mcp/server-card.json

Onboarding

  • Free tier is self-serve. No credit card required.
  • Product signup: https://collabute.ai/signup
  • MCP sandbox / discovery: /api/status and /api/agent/capabilities
  • There is no contact-sales step for the public spec or MCP connection once a user can authorize

Content negotiation

Public pages serve text/markdown when the request sends Accept: text/markdown. Responses include Vary: Accept.