Home › Documentation › Integration Catalog
DOCUMENTATION

Integration Catalog

A curated catalog of MCP servers — browse, search, and auto-configure integrations for your AI coding platform.

🔌 What is the Integration Catalog?

The MCP Server Integration Catalog is a curated collection of Model Context Protocol servers that work with Archon skills, agents, and bundles. It ships as a YAML data file (catalog/mcp-servers.yaml) with ~20 vetted entries spanning 8 categories.

The catalog enables:

⚡ Quick Start

# Browse all available servers
archon catalog list

# Search for database servers
archon catalog search database

# Install GitHub server for Copilot CLI
archon catalog install github --platform copilot-cli

# Check if all dependencies are satisfied
archon catalog check

📂 Server Categories

Category Description Example Servers
core Essential utilities filesystem, fetch, memory
development Dev tools & version control github, git, gitlab, docker
database Database access postgres, sqlite, redis
research Web search & automation brave-search, exa, puppeteer
design Design tools figma
ai AI capabilities sequential-thinking
cloud Cloud providers aws, gcp
communication Messaging platforms slack

🖥️ CLI Reference

archon catalog list

Lists all servers in a formatted table. Use --category to filter. 

archon catalog list
archon catalog list --category database
archon catalog list --json

archon catalog search <query>

Search by keyword, tag, or description. Results scored by relevance (name > tags > description). 

archon catalog search git
archon catalog search "version control"

archon catalog info <server>

Show full details: package, environment variables, recommendations, install command. 

archon catalog info github
archon catalog info postgres

archon catalog recommend

Get personalized recommendations based on installed skills and bundles. 

archon catalog recommend

archon catalog install <server>

Generate and merge MCP config for a platform. If no --platform flag, targets all detected platforms. 

archon catalog install github
archon catalog install github --platform copilot-cli
archon catalog install postgres --platform claude-code

archon catalog check

Audit MCP config against skills' mcp-dependencies. Reports missing servers with remediation commands. 

archon catalog check
archon catalog check --json

🔧 Platform Config Formats

Platform Config Path Root Key
Copilot CLI ~/.copilot/mcp-config.json servers
Claude Code ~/.claude/mcp.json mcpServers
Cursor .cursor/mcp.json mcpServers

Each server entry in the config file has command, args, and optionally env fields: 

{
  "servers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "YOUR_GITHUB_TOKEN_HERE" }
    }
  }
}

🎯 How Recommendations Work

Two strategies are used:

  1. Dependency scanning — Loads all installed skills' manifests and collects their mcp-dependencies lists. Each dependency is matched against catalog server names.
  2. Reverse matching — Each catalog server has a recommended-for field. The system checks which referenced skills, agents, and bundles are in your registry.

➕ Adding a Custom Server

  1. Edit catalog/mcp-servers.yaml
  2. Add a new entry following the format (unique kebab-case name, valid category, etc.)
  3. Run archon validate to check for errors
  4. Run archon catalog info <name> to verify

🔍 Troubleshooting