Server Catalog

The MCP Gateway includes a built-in catalog of popular MCP servers that can be installed with a single command.

Browsing the Catalog

Via CLI

mcpg list-catalog

Output:
  NAME                DESCRIPTION
  context7            Library documentation lookup
  supabase            Supabase database access
  github              GitHub API integration
  playwright          Browser automation
  filesystem          Local file access
  sequential-thinking Multi-step reasoning
  postgres            PostgreSQL database
  sqlite              SQLite database
  brave-search        Web search via Brave
  fetch               Web content fetching
  ...

Via Gateway Tools

# List all available servers in catalog
list_catalog()

# Search for specific capabilities
list_catalog(search="database")

Installing Servers

Global Install

Install a server that's available to all projects:

mcpg install context7

Or via gateway tools:

install_server(server="context7", scope="global")

Scope Required

Global installs require explicit scope="global" to prevent accidental modifications.

Project-Specific Install

Install for the current project only:

cd /path/to/my-project
mcpg install supabase

Or via gateway tools:

install_server(server="supabase", cwd="/path/to/my-project")

With Environment Variables

Some servers require API keys:

mcpg install github --env GITHUB_TOKEN=ghp_xxxxx

Or add them to your project's .env file:

# /my-project/.env
GITHUB_TOKEN=ghp_xxxxxxxxxxxxx

Uninstalling Servers

mcpg uninstall context7

Server Details

View details about a specific server:

mcpg describe context7

Output:
  Name: context7
  Description: Library documentation lookup
  Transport: http
  URL: https://mcp.context7.com/mcp
  Scope: global (recommended)
  Required env vars: none
  Capabilities: docs, libraries

Popular Servers

Server	Description	Scope	Requires
context7	Library documentation lookup	global	none
supabase	Supabase database access	workspace	SUPABASE_*
github	GitHub API integration	credential	GITHUB_TOKEN
filesystem	Local file access	global	none
playwright	Browser automation	global	none
sequential-thinking	Multi-step reasoning	global	none
postgres	PostgreSQL database	workspace	DATABASE_URL
brave-search	Web search	global	BRAVE_API_KEY

Contributing to the Catalog

Want to add your MCP server to the catalog? See the Catalog Contribution Guide.

Requirements

1. Server must implement the MCP specification
2. Server must be published to npm or available as a Docker image
3. Include clear documentation for required environment variables
4. Specify recommended scope (global, workspace, or credential)

Submission

Open a PR adding your server to templates/catalog.yaml:

my-server:
  description: "What my server does"
  transport: stdio
  command: npx
  args: [-y, "@my-org/my-mcp-server"]
  scope: global
  requires: []  # or [MY_API_KEY]
  capabilities: [feature1, feature2]