Magg: The MCP Aggregator Details

Magg is an MCP Aggregator – a meta-MCP server that manages, aggregates, and proxies multiple MCP servers. It acts as a central hub for discovering, configuring, and orchestrating MCP servers, allowing large language models to extend their capabilities at runtime. Magg exposes a suite of tools to search, add, configure, enable/disable, and proxy MCP servers and their tools, merging them under unified prefixes and persisting configurations across sessions. It also includes built-in health and status tools, Real-time Notifications, and MBro (MCP Browser) for interactive exploration, making it easier to compose, manage, and monitor complex MCP ecosystems. Whether you’re running stdio, HTTP, or hybrid transports, Magg provides flexible deployment modes, kit management, and secure access with optional JWT-based authentication.

Use Case

Magg serves as a central MCP registry and proxy layer that lets LLMs dynamically discover, configure, and aggregate MCP servers and their tools. Use Magg to: 1) search for MCP servers and fetch setup instructions; 2) add and configure new MCP servers with per-server prefixes; 3) enable/disable servers on demand; 4) aggregate tools from several servers under a unified namespace; 5) reload configuration from disk and manage kits of servers. The documentation includes concrete usage patterns such as running Magg in different transports, interacting with MBro for exploration, and using Magg’s tools via MCP clients. Example: run Magg in hybrid mode and connect with Claude Code or mbro, then list servers or tools via the MCP interface. See code samples below for authenticating and listing tools with MaggClient or FastMCP Client, and for adding a server via Claude Desktop integration.

Available Tools (16)

Examples & Tutorials

Running Magg and getting started:

<h1 class="text-2xl font-semibold mt-5 mb-3">Install Magg as a tool</h1>
uv tool install magg

<h1 class="text-2xl font-semibold mt-5 mb-3">Run with stdio transport (Claude Desktop, Cline, etc.)</h1>
magg serve

<h1 class="text-2xl font-semibold mt-5 mb-3">Run with HTTP transport (system-wide access)</h1>
magg serve --http

Alternative: Run directly from GitHub

<h1 class="text-2xl font-semibold mt-5 mb-3">Run with stdio transport</h1>
uvx --from git+https://github.com/sitbon/magg.git magg

<h1 class="text-2xl font-semibold mt-5 mb-3">Run with HTTP transport</h1>
uvx --from git+https://github.com/sitbon/magg.git magg serve --http

Local development:

<h1 class="text-2xl font-semibold mt-5 mb-3">Clone the repository</h1>
git clone https://github.com/sitbon/magg.git
cd magg

<h1 class="text-2xl font-semibold mt-5 mb-3">Install in development mode with dev dependencies</h1>
uv sync --dev
<h1 class="text-2xl font-semibold mt-5 mb-3">or with poetry</h1>
poetry install --with dev

<h1 class="text-2xl font-semibold mt-5 mb-3">Run the CLI</h1>
magg --help

Claude Desktop / mbro integration examples:

<h1 class="text-2xl font-semibold mt-5 mb-3">Claude Code example to use Magg in hybrid mode</h1>
claude mcp add magg -- magg serve --hybrid --port 42000

MBro usage to inspect Magg:

mbro connect magg "magg serve --hybrid --port 8080"
mbro:local-magg> call magg_status
mbro:local-magg> call magg_list_servers

Magg client usage (authenticated via JWT):

from magg.client import MaggClient

async def main():
async with MaggClient("http://localhost:8000/mcp") as client:
tools = await client.list_tools()

JWT authentication with FastMCP:

from fastmcp import Client
from fastmcp.client import BearerAuth

jwt_token = "your-jwt-token-here"
async with Client("http://localhost:8000/mcp", auth=BearerAuth(jwt_token)) as client:
tools = await client.list_tools()


Installation Guide

Step-by-step installation and setup from the documentation:

1) Quick Install (Recommended):

<h1 class="text-2xl font-semibold mt-5 mb-3">Install Magg as a tool</h1>
uv tool install magg

<h1 class="text-2xl font-semibold mt-5 mb-3">Run with stdio transport</h1>
magg serve

<h1 class="text-2xl font-semibold mt-5 mb-3">Run with HTTP transport</h1>
magg serve --http

2) Alternative: Run Directly from GitHub

<h1 class="text-2xl font-semibold mt-5 mb-3">Run with stdio transport</h1>
uvx --from git+https://github.com/sitbon/magg.git magg

<h1 class="text-2xl font-semibold mt-5 mb-3">Run with HTTP transport</h1>
uvx --from git+https://github.com/sitbon/magg.git magg serve --http

3) Local Development:

<h1 class="text-2xl font-semibold mt-5 mb-3">Clone the repository</h1>
git clone https://github.com/sitbon/magg.git
cd magg

<h1 class="text-2xl font-semibold mt-5 mb-3">Install in development mode with dev dependencies</h1>
uv sync --dev

<h1 class="text-2xl font-semibold mt-5 mb-3">Or with poetry</h1>
poetry install --with dev

<h1 class="text-2xl font-semibold mt-5 mb-3">Run the CLI</h1>
magg --help

Integration Guides

Frequently Asked Questions

Is this your MCP?

Claim ownership and get verified badge

Repository Stats

Sponsored

Ad Space Available
Important Notes

Notes and important details from the docs:

  • Magg exposes a built-in MBro (MCP Browser) for interactive exploration.

  • It supports multiple transport modes: stdio, HTTP, and hybrid.

  • Authentication is optional via RSA-based JWT; MAGG can be configured with an auth mechanism.

  • Configuration is stored in .magg/config.json and can be dynamically reloaded.

  • Kits allow grouping of servers; you can load/unload kits and query kit info.

  • Magg provides health and status tools (magg_status, magg_check) to monitor and repair MCP servers.

  • Docker images are provided for production, staging, and development, with multi-stage builds (pro/pre/dev).
  • Prerequisites

    Prerequisites: Python 3.12 or higher (3.13+ recommended); Python package uv is recommended and can be installed from astral.sh/uv. Magg is run as a tool via uv (uv tool install magg).

    Details
    Last Updated1/1/2026
    Websitepypi.org
    SourceGitHub

    Compare Alternatives

    Similar MCP Tools

    9 related tools
    Graphiti MCP Server

    Graphiti MCP Server

    Graphiti MCP Server is an experimental implementation that exposes Graphiti's real-time, temporally-aware knowledge graph capabilities through the MCP (Model Context Protocol) interface. It enables AI agents and MCP clients to interact with Graphiti's knowledge graph for structured extraction, reasoning, and memory across conversations, documents, and enterprise data. The server supports multiple backends (FalkorDB by default and Neo4j), a variety of LLM providers (OpenAI, Anthropic, Gemini, Groq, Azure OpenAI), and multiple embedder options, all accessible via an HTTP MCP endpoint at /mcp/ for broad client compatibility. It also includes queue-based asynchronous episode processing, rich entity types for structured data, and flexible configuration through config.yaml, environment variables, or CLI arguments.

    Context7 MCP Server

    Context7 MCP Server

    Context7 MCP Server delivers up-to-date, code-first documentation and examples for LLMs and AI code editors by pulling content directly from the source. It supports multiple MCP clients and exposes tools that help you resolve library IDs and retrieve library documentation, ensuring prompts use current APIs and usage patterns. The repository provides installation and integration guides for Cursor, Claude Code, Opencode, and other clients, along with practical configuration samples and OAuth options for remote HTTP connections. This MCP server is designed to keep prompts in sync with the latest library docs, reducing hallucinations and outdated code snippets.

    TrendRadar MCP

    TrendRadar MCP

    TrendRadar MCP is an AI-driven Model Context Protocol (MCP) based analysis server that exposes a suite of specialized tools for cross-platform news analysis, trend tracking, and intelligent push notifications. It integrates with TrendRadar’s multi-platform data aggregation (RSS and trending topics) and provides advanced AI-powered insights, sentiment analysis, and cross-platform correlation. The MCP server enables developers to query, analyze, and compare news across platforms using a consistent toolset, with ongoing updates that expand capabilities such as RSS querying, date parsing, and multi-date trend analysis. This documentation references the MCP module updates, tool additions, and architecture changes that enhance extensibility, cross-platform data handling, and AI-assisted reporting.

    ChainAware Behavioural Prediction MCP

    ChainAware Behavioural Prediction MCP

    The ChainAware Behavioural Prediction MCP is an MCP-based server that provides AI-powered tools to analyze wallet behaviour prediction, fraud detection, and rug pull prediction. Designed for Web3 security and DeFi analytics, it enables developers and platforms to integrate risk assessment, predictive wallet behavior insights, and rug-pull detection through MCP-compatible clients. The server exposes three specialized tools and uses Server-Sent Events (SSE) for real-time responses, helping safeguard DeFi users, monitor liquidity risks, and score wallet or contract trustworthiness. Access to production endpoints is API-key gated, reflecting a private backend architecture that supports secure, scalable risk analytics across wallets, contracts, and pools.

    Playwright MCP

    Playwright MCP

    Playwright MCP server. A Model Context Protocol (MCP) server that provides browser automation capabilities using Playwright. This server enables large language models (LLMs) to interact with web pages through structured accessibility snapshots, bypassing the need for screenshots or visually-tuned models. The server is designed to be fast, lightweight, and deterministic, offering LLM-friendly tooling and a rich set of browser automation capabilities via MCP tools. It supports standalone operation, containerized deployments, and integration with a variety of MCP clients (Claude Desktop, VS Code, Copilot, Cursor, Goose, Windsurf, and others).

    Sequential Thinking MCP Server

    Sequential Thinking MCP Server

    Sequential Thinking MCP Server provides a dedicated MCP tool that guides problem-solving through a structured, step-by-step thinking process. It supports dynamic adjustment of the number of thoughts and allows revision and branching within a controlled workflow, making it ideal for complex analysis and solution hypothesis development. This server is designed to register a single tool, sequential_thinking, and is integrated with common MCP deployment methods (NPX, Docker) as well as editor integrations like Claude Desktop and VS Code for quick setup. The documentation provides exact configuration snippets, usage patterns, and building instructions to help you deploy and use the MCP server effectively, including Codex CLI, NPX, and Docker installation examples.

    N8N MCP Server

    N8N MCP Server

    An MCP (Model Context Protocol) server designed to integrate Claude Desktop, Claude Code, Windsurf, and Cursor with n8n workflows. This MCP enables users to build, test, and orchestrate complex workflows by exposing a set of tools that bridge Claude’s capabilities with n8n’s automation platform. The project emphasizes robust trigger handling, multi-tenant readiness, and progressive documentation to help developers understand how tools map to real-world workflow tasks. It also outlines future tooling integration points (such as getNodeEssentials and getNodeInfo) to further enhance node-structure awareness within MCP-powered automations.

    Hugging Face MCP Server

    Hugging Face MCP Server

    Hugging Face Official MCP Server connects your large language models (LLMs) to the Hugging Face Hub and thousands of Gradio AI Applications, enabling seamless MCP (Model Context Protocol) integration across multiple transports. It supports STDIO, SSE (to be deprecated but still commonly deployed), StreamableHTTP, and StreamableHTTPJson, with the Web Application allowing dynamic tool management and status updates. This MCP server is designed to be run locally or in Docker, and it provides integrations with Claude Desktop, Claude Code, Gemini CLI (and its extension), VSCode, and Cursor, making it easy to configure and manage MCP-enabled tools and endpoints. Tools such as hf_doc_search and hf_doc_fetch can be enabled to enhance document discovery, and an optional Authenticate tool can be included to handle OAuth challenges when called.

    Shadcn UI MCP Server v4

    Shadcn UI MCP Server v4

    Shadcn UI v4 MCP Server is an advanced MCP (Model Context Protocol) server designed to give AI assistants comprehensive access to shadcn/ui v4 components, blocks, demos, and metadata. It enables multi-framework support (React, Svelte, Vue, and React Native) with fast, cache-friendly access to component source code, demos, and directory structures, empowering AI-driven development workflows. The project emphasizes production-readiness with Docker Compose, SSE transport for multi-client deployments, and smart caching to optimize GitHub API usage while providing rich metadata and usage patterns for rapid prototyping and learning across frameworks.