{
  "markdown": "# SuperAgenticMCP\n\n[![CI](https://github.com/ANAMIZED/SuperAgenticMCP/actions/workflows/ci.yml/badge.svg)](https://github.com/ANAMIZED/SuperAgenticMCP/actions/workflows/ci.yml)\n[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)\n[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)\n[![MCP](https://img.shields.io/badge/MCP-server-purple.svg)](src/superagenticmcp/server.py)\n[![SDK](https://img.shields.io/badge/SDK-Python-green.svg)](src/superagenticmcp/sdk/)\n[![CLI](https://img.shields.io/badge/CLI-superagenticmcp--cli-orange.svg)](src/superagenticmcp/cli.py)\n[![Board](https://img.shields.io/badge/Board-hero%20demo-009688.svg)](superagenticmcp.html)\n[![USDC](https://img.shields.io/badge/USDC-Base%20%7C%20ETH%20%7C%20Solana-2775CA.svg)](#usdc-crypto)\n\n**The switchboard for your agent swarm.**\n\nSuperAgenticMCP 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.\n\n> Patch every agent into every tool.\n\n**[Support Agentic OS Kernels ($99)](https://buy.stripe.com/bJecN63wObPv6Bf7Zm43S02)** · **[Agentic OS Cycle ($0.75)](https://buy.stripe.com/3cI14o8R8dXD3p3frO43S04)** · **[Public Goods Support](https://donate.stripe.com/00w5kE3wOg5L8Jn2F243S00)** · **[USDC](#usdc-crypto)**\n\n**Layout standard:** [Server OS](https://github.com/ANAMIZED/server-os) — see [`docs/LAYOUT.md`](docs/LAYOUT.md).\n\n---\n\n## Surfaces\n\n| Surface | Entry |\n|---------|--------|\n| **Web control plane** | [`superagenticmcp.html`](superagenticmcp.html) / [`web/`](web/) (offline hero) |\n| **MCP Server** | `superagenticmcp` |\n| **CLI** | `superagenticmcp-cli status` |\n| **SDK** | `from superagenticmcp.sdk import SuperAgenticClient` |\n| **Board (target)** | `superagenticmcp up --board` → http://localhost:7420 |\n| **Skills** | `skills/*/SKILL.md` |\n| **AGENTS.md** | Coding-agent contract |\n| **Verify** | `bash scripts/verify.sh` |\n| **CI** | `.github/workflows/ci.yml` |\n\n---\n\n## Why SuperAgenticMCP?\n\n| Problem | Approach |\n|---------|----------|\n| Agents need many MCP servers | One process racks servers and routes by capability |\n| Tool calls are opaque | Live patch board + JSONL log + run receipt |\n| Multi-agent coordination is ad-hoc | Built-in planner / worker / critic loop |\n| Memory evaporates between runs | Memory scope constellation of artifacts |\n| Config drifts from reality | Rack toggles generate `superagentic.json` |\n\n---\n\n## Features\n\n| Capability | Status |\n|------------|--------|\n| MCP over stdio (+ streamable HTTP planned) | ✅ scaffold |\n| Capability-first routing + latency tie-break | 🚧 / demo in hero |\n| Planner → parallel workers → critic | 🚧 / demo in hero |\n| Hot-swap server rack | 🚧 / demo in hero |\n| Live patch board + phosphor log | ✅ hero |\n| Memory scope (3D constellation) | ✅ hero |\n| Call budgets + offline skip | 🚧 |\n| Dynamic `superagentic.json` | 🚧 |\n| Server OS layout + verify contract | ✅ |\n| Self-learning model routing (bandit) | 🚧 |\n| Agentic commerce (x402) | ✅ routes to [x402-cloudflare-starter](https://github.com/ANAMIZED/x402-cloudflare-starter) `GET /v1/cycle` · `/v1/search` · `/v1/draft` |\n\nCommerce is **not** reimplemented here. Rack the x402 Worker; keep Stripe Payment Links for humans. Receipts are not Desk unlocks.\n\n---\n\n## Quick start\n\n```bash\ngit clone https://github.com/ANAMIZED/SuperAgenticMCP\ncd SuperAgenticMCP\npython -m venv .venv && source .venv/bin/activate\npip install -e \".[dev]\"\n\nsuperagenticmcp                 # MCP server (stdio)\nsuperagenticmcp-cli status\nmake test\nbash scripts/verify.sh\n```\n\nZero-install hero:\n\nhttps://htmlpreview.github.io/?https://github.com/ANAMIZED/SuperAgenticMCP/blob/main/superagenticmcp.html\n\n### MCP client config\n\n```json\n{\n  \"mcpServers\": {\n    \"superagenticmcp\": {\n      \"command\": \"superagenticmcp\",\n      \"args\": []\n    }\n  }\n}\n```\n\n### Docker (scaffold)\n\n```bash\ndocker compose up --build\n```\n\n---\n\n## How routing works\n\n1. **Protocol** — Model Context Protocol; one session per racked server.\n2. **Agent loop** — Planner decomposes; workers run in parallel where allowed; critic checks before ship.\n3. **Routing** — Capability match first, latency as tie-break, fallback when a server drops.\n4. **Guardrails** — Per-server allow-lists and per-run call budgets.\n5. **Telemetry** — JSONL lines + board replay.\n6. **Footprint** — Single process for the core path; no DB required.\n\n---\n\n## Repository layout\n\n```\nsrc/superagenticmcp/   # MCP, CLI, SDK\nskills/                # Packaged skills (Server OS style)\nweb/                   # Control-plane path\nscripts/verify.sh      # Verify contract\ntests/                 # Smoke + contract tests\nsuperagenticmcp.html   # Hero demo\ndocs/LAYOUT.md         # Permanent layout standard = Server OS\nAGENTS.md              # Agent contract\n```\n\n---\n\n## Support\n\n### Fiat (Stripe)\n\n| Offer | Link |\n|-------|------|\n| **Support Agentic OS Kernels** — $99 | [buy.stripe.com/…](https://buy.stripe.com/bJecN63wObPv6Bf7Zm43S02) |\n| **Agentic OS Cycle** — $0.75 | [buy.stripe.com/…](https://buy.stripe.com/3cI14o8R8dXD3p3frO43S04) |\n| **Public Goods Support** | [donate.stripe.com/…](https://donate.stripe.com/00w5kE3wOg5L8Jn2F243S00) |\n\nGitHub Sponsors: [ANAMIZED](https://github.com/sponsors/ANAMIZED)\n\n### USDC (crypto)\n\nNon-custodial addresses controlled by ANAMIZED. Pure **x402** micropayments preferred for agents — see [x402-cloudflare-starter](https://github.com/ANAMIZED/x402-cloudflare-starter).\n\n| Network | Address | Explorer |\n|---------|---------|----------|\n| **Base** | `0xD3d0E9eDAe3Ac7bb199a8EAA761BdA423b878438` | [basescan](https://basescan.org/address/0xD3d0E9eDAe3Ac7bb199a8EAA761BdA423b878438) |\n| **Ethereum** | `0xD3d0E9eDAe3Ac7bb199a8EAA761BdA423b878438` | [etherscan](https://etherscan.io/address/0xD3d0E9eDAe3Ac7bb199a8EAA761BdA423b878438) |\n| **Solana** | `ETQwWf19axArsY493UfC6bxe2BmEzmzvCb58PPnC38A` | [solscan](https://solscan.io/account/ETQwWf19axArsY493UfC6bxe2BmEzmzvCb58PPnC38A) |\n\nSend only **USDC** on the matching network. Wrong asset or chain can mean permanent loss.\n\n---\n\n## Related projects\n\n- [server-os](https://github.com/ANAMIZED/server-os) — **layout standard** · agents as processes\n- [OpenGOS](https://github.com/ANAMIZED/OpenGOS) — grants + public-goods funding MCP\n- [LRSI](https://github.com/ANAMIZED/LRSI) — local recursive self-improvement kernel\n- [x402-cloudflare-starter](https://github.com/ANAMIZED/x402-cloudflare-starter) — USDC micropayments (Base + Solana)\n\n---\n\n## License\n\nApache-2.0\n\nBuilt for the Model Context Protocol · Unit 001 · SA-MCP MK.4 · Server OS layout\n",
  "bytes": 6754,
  "sha": "36a63c99bf08d34dc42edee39c035ac812c4ed84988936e1b285b3cf2aab9511",
  "repo_slug": "anamized/superagenticmcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_anamized_superagenticmcp_b6cdee92/readme"
}