SuperAgenticMCP

Name: SuperAgenticMCP
Author: anamized

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

Surface	Entry
Web control plane	`superagenticmcp.html` / `web/` (offline hero)
MCP Server	`superagenticmcp`
CLI	`superagenticmcp-cli status`
SDK	`from superagenticmcp.sdk import SuperAgenticClient`
Board (target)	`superagenticmcp up --board` → http://localhost:7420
Skills	`skills/*/SKILL.md`
AGENTS.md	Coding-agent contract
Verify	`bash scripts/verify.sh`
CI	`.github/workflows/ci.yml`

Why SuperAgenticMCP?

Problem	Approach
Agents need many MCP servers	One process racks servers and routes by capability
Tool calls are opaque	Live patch board + JSONL log + run receipt
Multi-agent coordination is ad-hoc	Built-in planner / worker / critic loop
Memory evaporates between runs	Memory scope constellation of artifacts
Config drifts from reality	Rack toggles generate `superagentic.json`

Features

Capability	Status
MCP over stdio (+ streamable HTTP planned)	✅ scaffold
Capability-first routing + latency tie-break	🚧 / demo in hero
Planner → parallel workers → critic	🚧 / demo in hero
Hot-swap server rack	🚧 / demo in hero
Live patch board + phosphor log	✅ hero
Memory scope (3D constellation)	✅ hero
Call budgets + offline skip	🚧
Dynamic `superagentic.json`	🚧
Server OS layout + verify contract	✅
Self-learning model routing (bandit)	🚧
Agentic commerce (x402)	✅ routes to x402-cloudflare-starter `GET /v1/cycle` · `/v1/search` · `/v1/draft`

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

Protocol — Model Context Protocol; one session per racked server.
Agent loop — Planner decomposes; workers run in parallel where allowed; critic checks before ship.
Routing — Capability match first, latency as tie-break, fallback when a server drops.
Guardrails — Per-server allow-lists and per-run call budgets.
Telemetry — JSONL lines + board replay.
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)

Offer	Link
Support Agentic OS Kernels — $99	buy.stripe.com/…
Agentic OS Cycle — $0.75	buy.stripe.com/…
Public Goods Support	donate.stripe.com/…

GitHub Sponsors: ANAMIZED

USDC (crypto)

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

Network	Address	Explorer
Base	`0xD3d0E9eDAe3Ac7bb199a8EAA761BdA423b878438`	basescan
Ethereum	`0xD3d0E9eDAe3Ac7bb199a8EAA761BdA423b878438`	etherscan
Solana	`ETQwWf19axArsY493UfC6bxe2BmEzmzvCb58PPnC38A`	solscan

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