{
  "markdown": "# Componecat MCP Server\n\n**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](https://modelcontextprotocol.io) server gives AI agents the organizational context they're usually missing, so they can answer with *your* architecture instead of guessing.\n\nThis repository is the public home of the server's MCP registry metadata ([`server.json`](server.json)) and the [`@componecat/mcp`](https://www.npmjs.com/package/@componecat/mcp) stdio bridge. The server itself is part of the hosted Componecat app:\n\n```\nhttps://app.componecat.ai/api/mcp\n```\n\nRegistry name: **`ai.componecat/componecat`** · Transport: **Streamable HTTP** · Website: [componecat.ai](https://www.componecat.ai) · Docs: [docs.componecat.ai](https://docs.componecat.ai)\n\nCatalogs are private and organization-scoped, so the endpoint requires authentication (see [Authorization](#authorization)). You'll need a Componecat account — sign up at [app.componecat.ai](https://app.componecat.ai).\n\n## Install\n\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Componecat_MCP-0098FF?logo=githubcopilot&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=componecat&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapp.componecat.ai%2Fapi%2Fmcp%22%7D) [![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Componecat_MCP-24bfa5?logo=githubcopilot&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=componecat&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapp.componecat.ai%2Fapi%2Fmcp%22%7D&quality=insiders)\n\n### VS Code\n\nClick an install badge above, or add to your `mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"componecat\": {\n      \"type\": \"http\",\n      \"url\": \"https://app.componecat.ai/api/mcp\"\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http componecat https://app.componecat.ai/api/mcp\n```\n\n### Claude.ai / Claude Desktop\n\nAdd a custom connector: **Settings → Connectors → Add custom connector**, with URL `https://app.componecat.ai/api/mcp`.\n\n### Cursor\n\n[Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=componecat&config=eyJ1cmwiOiJodHRwczovL2FwcC5jb21wb25lY2F0LmFpL2FwaS9tY3AifQ==), or add to `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"componecat\": {\n      \"url\": \"https://app.componecat.ai/api/mcp\"\n    }\n  }\n}\n```\n\n### ChatGPT\n\nAdd a connector in **Settings → Connectors** (developer mode) with the server URL `https://app.componecat.ai/api/mcp`.\n\n### Stdio-only clients\n\nFor clients that only speak stdio, the bridge in this repo proxies to the remote endpoint via [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) (OAuth completes in your browser):\n\n```json\n{\n  \"mcpServers\": {\n    \"componecat\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@componecat/mcp\"]\n    }\n  }\n}\n```\n\nSelf-hosted Componecat instance? Point the bridge at it with `COMPONECAT_MCP_URL=https://your-instance.example.com/api/mcp`.\n\n## Authorization\n\nComponecat implements the standard MCP authorization flow with OAuth 2.1:\n\n- **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.\n- **Personal access tokens** — bearer tokens for scripts and non-interactive clients.\n\nAccess 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.\n\n## Tools\n\n60 tools, each annotated with read-only / destructive / idempotent hints so clients can gate confirmation appropriately.\n\n**Search & browse**\n`global_search` · `search_catalog` (full-text with typo tolerance, or a structured query language — `field:value`, AND/OR/NOT, comparisons, ranges) · `list_catalog_entities` · `get_catalog_entity` · `list_by_owner` · `list_entity_kind_definitions` · `get_current_organization`\n\n**Relationships & impact analysis**\n`get_relationships` · `get_relationship_kinds` · `add_relationship` · `remove_relationship` · `get_impact_analysis` (transitive downstream impact of a change)\n\n**Interfaces & endpoints**\n`get_interfaces` · `create_interface` · `update_interface` · `delete_interface` · `import_interface_spec` (import OpenAPI/AsyncAPI specs)\n\n**Documentation**\n`get_documentation` · `create_documentation_section` · `update_documentation_section` · `delete_documentation_section` · `list_documentation_links` · `create_documentation_link` · `update_documentation_link` · `delete_documentation_link`\n\n**Git-sourced documentation** (sections synced from Markdown in your repos)\n`configure_git_sourced_documentation` · `list_git_sourced_documentation` · `update_git_sourced_documentation` · `remove_git_sourced_documentation` · `sync_git_sourced_documentation`\n\n**Activity log**\n`list_activity_log_entries` · `add_activity_log_entry` · `delete_activity_log_entry`\n\n**Catalog maintenance**\n`create_catalog_entity` · `update_catalog_entity` · `delete_catalog_entity` · `update_entity_field_values`\n\n**Schema definitions** (entity kinds, custom fields, relationship kinds)\n`create_entity_kind_definition` · `update_entity_kind_definition` · `delete_entity_kind_definition` · `list_entity_field_definitions` · `create_entity_field_definition` · `update_entity_field_definition` · `delete_entity_field_definition` · `add_kind_field_assignment` · `update_kind_field_assignment` · `remove_kind_field_assignment` · `list_relationship_kind_definitions` · `create_relationship_kind_definition` · `update_relationship_kind_definition` · `delete_relationship_kind_definition`\n\n**Teams & ownership**\n`list_teams` · `get_team` · `create_team` · `update_team` · `delete_team` · `add_team_members` · `remove_team_member`\n\n**Product documentation**\n`list_componecat_documentation` · `read_componecat_documentation` — Componecat's own docs, so an agent can walk you through setup instead of guessing.\n\nThe server also exposes the catalog as MCP **resources**: every entity is readable as its `componecat.yaml` descriptor, and a kind's entities can be listed without knowing the taxonomy in advance.\n\n## Typical workflows\n\n- **Grounded code generation** — before generating code for a service, the agent looks up its kind, languages, interfaces, and conventions.\n- **Cross-service integration** — the agent follows `depends-on` edges, reads the target's interface spec, and writes a correct client.\n- **Impact analysis** — before a change, the agent traverses transitive relationships to see what breaks downstream.\n- **Ownership resolution** — the agent finds the owning team to route a review or an escalation.\n- **Documentation-grounded answers** — runbooks and architecture notes answer questions with your context, not generic guesswork.\n\n## Links\n\n- [Product documentation](https://docs.componecat.ai) — including the [Connect AI agents](https://docs.componecat.ai/app/guides/connect-ai-agents/) guide\n- [Website](https://www.componecat.ai)\n- [REST API OpenAPI spec](https://app.componecat.ai/api/rest/v1/openapi.json)\n- [llms.txt](https://app.componecat.ai/llms.txt)\n\n## License\n\nThe contents of this repository (registry metadata and the stdio bridge) are [MIT licensed](LICENSE). The Componecat application itself is a hosted product and is not open source.\n",
  "bytes": 7702,
  "sha": "d437a688e710e6575c4c486a71a79e57fd94fbede565604c447a51cc9d53bb6e",
  "repo_slug": "componecat/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_shaftware_componecat_032745ff/readme"
}