
Magg
Meta-MCP server that manages, aggregates, and proxies other MCP servers so LLMs can extend themselves.
Add to your client
Copy the config for your MCP client and paste it into its config file.
uv tool install maggPaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"magg": {
"command": "magg",
"args": [
"serve"
]
}
}
}Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf
Before you start
- Python 3.12 or higher (3.13+ recommended)
- uv (recommended) — installed from astral.sh/uv
- Optional: Docker, for running the pre-built ghcr.io/sitbon/magg images
About Magg
Magg ("The MCP Aggregator") is a Model Context Protocol server that manages, aggregates, and proxies other MCP servers, enabling LLMs to dynamically extend their own capabilities. It can search for and add new MCP servers without human intervention, automatically expose their tools under configurable prefixes, reload configuration without restarting, and bundle servers into reusable "kits." Magg runs in stdio mode (for Claude Desktop, Cline, Cursor, Claude Code), HTTP mode for system-wide access, or a hybrid of both, and ships with the mbro MCP Browser CLI for interactive exploration.
Tools & capabilities (16)
magg_list_serversList all configured MCP servers.
magg_add_serverAdd a new MCP server.
magg_remove_serverRemove a server.
magg_enable_serverEnable a server, making it available.
magg_disable_serverDisable a server, toggling off its availability.
magg_search_serversSearch for MCP servers online.
magg_list_toolsList all available tools from all servers.
magg_smart_configureIntelligently configure a server from just a URL.
magg_analyze_serversAnalyze configured servers and suggest improvements.
magg_statusGet server and tool statistics.
magg_checkHealth-check servers with repair actions (report/remount/unmount/disable).
magg_reload_configReload configuration from disk and apply changes.
magg_load_kitLoad a kit and its servers into the configuration.
magg_unload_kitUnload a kit and optionally its servers from the configuration.
magg_list_kitsList all available kits with their status.
magg_kit_infoGet detailed information about a specific kit.
When to use it
- Let an LLM self-service its own toolset — search for, add, and configure new MCP servers at runtime without human intervention.
- Aggregate tools from many MCP servers behind a single endpoint, namespaced with configurable prefixes.
- Bundle related MCP servers into reusable 'kits' that can be loaded or unloaded as a group.
- Provide a single authenticated HTTP MCP gateway (with JWT bearer tokens) for system-wide or team access to multiple backend servers.
- Inspect and manage MCP setups interactively with the bundled mbro CLI, including scriptable automation.
Security notes
HTTP transport supports optional bearer-token authentication via an RSA keypair. Run `magg auth init` to generate keys (stored in `~/.ssh/magg/` by default), then `magg auth token` to mint JWTs; clients pass the token via the MAGG_JWT env var or BearerAuth. The private key may also be supplied through MAGG_PRIVATE_KEY. By default (stdio quick-start) no auth is configured. A read-only mode is available via MAGG_READ_ONLY=true. Because Magg can dynamically add and run arbitrary backend MCP servers at an LLM's request, treat it as capable of executing whatever those servers can do.
Magg FAQ
What transports does Magg support?
stdio (default, for Claude Desktop, Cline, Cursor, Claude Code), HTTP (`magg serve --http`), and a hybrid mode that runs both simultaneously, plus in-memory transport.
How do I add it to Claude Code?
After installing Magg (`uv tool install magg`), run `claude mcp add magg -- magg serve --hybrid --port 42000`. For a plain stdio client, point it at the command `magg` with argument `serve`.
Does it require authentication?
No by default. For HTTP access you can optionally enable RSA-based JWT bearer-token auth via `magg auth init` / `magg auth token`; clients then pass the token through the MAGG_JWT environment variable or BearerAuth.
Where is configuration stored?
In `.magg/config.json` in the current working directory, allowing project-specific tool configurations. Magg supports automatic config reloading (file watching, SIGHUP, or the `magg_reload_config` tool).
Alternatives to Magg
Compare all alternatives →Microsoft's official browser-automation MCP using Playwright's accessibility tree (no vision model).
Up-to-date, version-specific library documentation injected into your coding agent.
LSP-powered coding agent toolkit: semantic symbol search, references and structural edits.
Compare Magg with: