Componecat MCP server

Componecat MCP Server

Componecat is a software component catalog: a hierarchical, richly-typed registry of every system, service, and library your organization operates — with structured metadata, Git integration, hosted documentation, endpoint definitions, dependency relationships, and team ownership. Its MCP server gives AI agents the organizational context they're usually missing, so they can answer with your architecture instead of guessing.

This repository is the public home of the server's MCP registry metadata (server.json) and the @componecat/mcp stdio bridge. The server itself is part of the hosted Componecat app:

https://app.componecat.ai/api/mcp

Registry name: ai.componecat/componecat · Transport: Streamable HTTP · Website: componecat.ai · Docs: docs.componecat.ai

Catalogs are private and organization-scoped, so the endpoint requires authentication (see Authorization). You'll need a Componecat account — sign up at app.componecat.ai.

Install

VS Code

Click an install badge above, or add to your mcp.json:

{
  "servers": {
    "componecat": {
      "type": "http",
      "url": "https://app.componecat.ai/api/mcp"
    }
  }
}

Claude Code

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

Claude.ai / Claude Desktop

Add a custom connector: Settings → Connectors → Add custom connector, with URL https://app.componecat.ai/api/mcp.

Cursor

Add to Cursor, or add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "componecat": {
      "url": "https://app.componecat.ai/api/mcp"
    }
  }
}

ChatGPT

Add a connector in Settings → Connectors (developer mode) with the server URL https://app.componecat.ai/api/mcp.

Stdio-only clients

For clients that only speak stdio, the bridge in this repo proxies to the remote endpoint via mcp-remote (OAuth completes in your browser):

{
  "mcpServers": {
    "componecat": {
      "command": "npx",
      "args": ["-y", "@componecat/mcp"]
    }
  }
}

Self-hosted Componecat instance? Point the bridge at it with COMPONECATMCPURL=https://your-instance.example.com/api/mcp.

Authorization

Componecat implements the standard MCP authorization flow with OAuth 2.1:

• OAuth (authorization code + PKCE) — the usual path for interactive clients. The client discovers the authorization server automatically; dynamic client registration is supported, so most clients need no manual setup. Device flow is available for clients that can't open a browser.
• Personal access tokens — bearer tokens for scripts and non-interactive clients.

Access is scoped: you grant an agent read or write access per resource category (catalog entities, teams, schema), and can scope a token down to specific entities. A read-only grant is enough for an agent that only needs context.

Tools

Shortened. The full README is on GitHub.