Server Catalog

The MCP Gateway includes a built-in catalog of MCP servers you can install into your gateway configuration.

Browse the Catalog

list_catalog()

# Filter by text or capability
list_catalog(search="database")
list_catalog(capability="docs")

Install a Server

Install for a workspace

install_server(server="supabase", cwd="/path/to/workspace")

Install globally

Global installs require explicit scope="global" when no cwd is provided:

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

tip

If you only use one workspace most of the time, pass cwd anyway. It keeps credential resolution predictable.

Force reinstall

install_server(server="playwright", scope="global", force=true)

Required Credentials

Many catalog entries use ${VAR} placeholders. After installation:

# See what the server needs and how it's configured
get_server_config(server="github")

Then set credentials via a workspace .env file (recommended) or update the server config.

Remove a Server

Removing a server modifies global configuration, so it requires scope="global":

manage_config(action="remove_server", name="github", scope="global")

Export Config (Masked)

manage_config(action="export")

This returns YAML with secrets masked, while keeping ${VAR} placeholders intact.