io.github.ANAMIZED/superagenticmcp

SuperAgenticMCP

The switchboard for your agent swarm.

SuperAgenticMCP is a production-oriented, MCP-native router and multi-agent control plane. It sits between your agents and the MCP servers they need — planning the task, routing each tool call to the right server, streaming every step, and filing results into memory.

Patch every agent into every tool.

Support Agentic OS Kernels ($99) · Agentic OS Cycle ($0.75) · Public Goods Support · USDC

Layout standard: Server OS — see docs/LAYOUT.md.

Surfaces

Why SuperAgenticMCP?

Features

Commerce is not reimplemented here. Rack the x402 Worker; keep Stripe Payment Links for humans. Receipts are not Desk unlocks.

Quick start

git clone https://github.com/ANAMIZED/SuperAgenticMCP
cd SuperAgenticMCP
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

superagenticmcp                 # MCP server (stdio)
superagenticmcp-cli status
make test
bash scripts/verify.sh

Zero-install hero:

https://htmlpreview.github.io/?https://github.com/ANAMIZED/SuperAgenticMCP/blob/main/superagenticmcp.html

MCP client config

{
  "mcpServers": {
    "superagenticmcp": {
      "command": "superagenticmcp",
      "args": []
    }
  }
}

Docker (scaffold)

docker compose up --build

How routing works

1. Protocol — Model Context Protocol; one session per racked server.
2. Agent loop — Planner decomposes; workers run in parallel where allowed; critic checks before ship.
3. Routing — Capability match first, latency as tie-break, fallback when a server drops.
4. Guardrails — Per-server allow-lists and per-run call budgets.
5. Telemetry — JSONL lines + board replay.
6. Footprint — Single process for the core path; no DB required.

Repository layout

src/superagenticmcp/   # MCP, CLI, SDK
skills/                # Packaged skills (Server OS style)
web/                   # Control-plane path
scripts/verify.sh      # Verify contract
tests/                 # Smoke + contract tests
superagenticmcp.html   # Hero demo
docs/LAYOUT.md         # Permanent layout standard = Server OS
AGENTS.md              # Agent contract

Support

Fiat (Stripe)

GitHub Sponsors: ANAMIZED

USDC (crypto)

Non-custodial addresses controlled by ANAMIZED. Pure x402 micropayments preferred for agents — see x402-cloudflare-starter.

Send only USDC on the matching network. Wrong asset or chain can mean permanent loss.

Related projects

• server-os — layout standard · agents as processes
• OpenGOS — grants + public-goods funding MCP
• LRSI — local recursive self-improvement kernel
• x402-cloudflare-starter — USDC micropayments (Base + Solana)

License

Apache-2.0

Built for the Model Context Protocol · Unit 001 · SA-MCP MK.4 · Server OS layout