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 OMNISKILL 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
omniskill catalog list

# Search for database servers
omniskill catalog search database

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

# Check if all dependencies are satisfied
omniskill 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

omniskill catalog list

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

omniskill catalog list
omniskill catalog list --category database
omniskill catalog list --json

omniskill catalog search <query>

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

omniskill catalog search git
omniskill catalog search "version control"

omniskill catalog info <server>

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

omniskill catalog info github
omniskill catalog info postgres

omniskill catalog recommend

Get personalized recommendations based on installed skills and bundles. 

omniskill catalog recommend

omniskill catalog install <server>

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

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

omniskill catalog check

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

omniskill catalog check
omniskill 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 omniskill validate to check for errors
  4. Run omniskill catalog info <name> to verify

🔍 Troubleshooting