Log inSubmit server
Magg logo

Magg

by sitbon

Discovers, configures, proxies, and groups MCP servers with persistent settings and stdio, HTTP, or hybrid transports.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Magg

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "sitbon-magg": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/sitbon/magg.git",
        "magg"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

uvx --from git+https://github.com/sitbon/magg.git magg

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 28d ago.

Overview

The sitbon/magg MCP server manages a collection of MCP servers and exposes their tools through a single MCP endpoint. It can search for servers, add or configure them, enable or disable them, proxy their tools with prefixes, and persist settings in `.magg/config.json`. Use it when an agent needs to extend its available tools dynamically or when several MCP backends should be accessed through one connection.

Use cases

  • Discover MCP servers from an agent workflow
  • Aggregate several MCP backends behind one connection
  • Enable or disable server groups with kits
  • Expose MCP tools to clients lacking dynamic updates

Key features

  • Dynamic MCP server discovery and configuration
  • Tool aggregation with configurable prefixes
  • Persistent configuration in .magg/config.json
  • Stdio, HTTP, hybrid, and in-memory transports
  • Health checks and notification proxying
  • Optional RSA JWT bearer authentication

Tools14

What Magg lets your agent do. Expand a tool for its parameters.

Self-reported~199 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

6/7 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · magg (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars144Stargazers on the source repository.
Last commit1mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed14Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How Magg works

What sitbon/magg MCP server does

The sitbon/magg MCP server provides a central management layer for other MCP servers. Agents can use it to search for MCP servers, inspect setup instructions, add servers, configure them, and turn them on or off. Tools from enabled servers are made available through Magg, using configurable prefixes to help distinguish their origins.

Configuration is persisted in .magg/config.json, so server selections and settings can remain available between sessions. Magg also supports kits, which group related MCP servers so they can be loaded or unloaded together.

How it works

Magg can connect to backend MCP servers through stdio, HTTP, or in-memory transports. It watches for configuration changes and reloads them without requiring a process restart. Backend tool, resource, and progress notifications can be passed through to the connected client.

The server includes a proxy tool for clients that do not support MCP notifications or dynamic tool updates. Health and connectivity checks are available through the magg_status and magg_check tools.

Magg can run in stdio mode for local clients, HTTP mode for system-wide access or web integrations, or hybrid mode to provide both transports at once. HTTP access can optionally use RSA-based JWT bearer-token authentication.

Setup and configuration

The sitbon/magg MCP server requires Python 3.12 or newer. The documented recommended installation uses uv:

bash
uv tool install magg
magg serve
bash
uvx --from git+https://github.com/sitbon/magg.git magg

Use magg serve --http for HTTP mode, or magg serve --hybrid for both stdio and HTTP. The HTTP port can be changed with --port. Docker images are also published to GitHub Container Registry, and Docker Compose files are provided for production, beta, and development workflows.

The documented Docker authentication option uses the MAGG_PRIVATE_KEY environment variable or a mounted private key file. Configuration can also be supplied through the .magg directory; the README gives examples for mounting a custom directory in Docker.

Tools and capabilities

  • Search for MCP servers and discover installation instructions.
  • Add, configure, enable, and disable backend servers.
  • Aggregate backend tools under configurable prefixes.
  • Check server status and health with magg_status and magg_check.
  • Group servers into loadable kits.
  • Proxy MCP traffic for clients with limited dynamic-update support.
  • Explore and manage servers interactively or through scripts with the included MBro CLI.

Limitations and notes

The sitbon/magg MCP server manages and proxies other MCP servers; its available domain-specific tools depend on the backends that are added.

Dynamic updates and notifications depend partly on client support, which is why Magg includes its proxy tool. HTTP authentication is optional rather than a stated prerequisite for every deployment. The documented runtime requirement is Python 3.12 or later, and the supplied examples use uv, Docker, or a local development checkout.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Magg

Install it as a uv tool with `uv tool install magg`, or run it directly from GitHub with `uvx --from git+https://github.com/sitbon/magg.git magg`.

Yes.

Yes. Run `magg serve --http`, optionally specifying a port with `--port`. Hybrid mode provides stdio and HTTP together.

It can search for servers, discover setup instructions, add and configure them, enable or disable them, and expose their tools through a unified proxy.

Related MCP servers

All in Aggregators All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMagg AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/sitbon-magg?style=directory)](https://allmcps.com/mcp/sitbon-magg)
HTML Embed
<a href="https://allmcps.com/mcp/sitbon-magg"><img src="https://allmcps.com/api/badge/sitbon-magg?style=directory" alt="Magg on AllMCPs" /></a>