AAI Gateway
About
Unified MCP & skill management gateway with progressive disclosure. Manages multiple MCP servers as Agent Apps, loading tool schemas on demand for 99% context token savings. Shared across Claude Code, Codex, OpenCode and more.
Details
- Author
- gybob
- Categories
- Other, AI, Developer Tools, Automation, API
Jump to
Setup
Install AAI Gateway in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/gybob/aai-gateway
Follow the installation instructions in the repository README, then restart your MCP client.
AAI Gateway: Unified MCP & Skill Management, Shared Across AI Agents, 99% Context Token Savings
AAI Gateway is the interaction gateway for Agent Apps.
What is anAgent App? An Agent App is a collection of capabilities that an Agent can use. For example:
- AnMCP Serveris an Agent App — it provides a set of tools
- ASkill packageis an Agent App — it provides one or more skills
In AAI Gateway, they are abstracted asAgent Appsunder unified management. Import once, and all AI Agents can use them immediately.
Traditional: 10 MCPs × 5 tools =50 full schemas ≈ 7,500 tokensinjected into every conversation.
AAI Gateway: each Agent App needs onlyfewer than 50 tokens for a summary, with details loaded on demand.99% token savings.
Traditional: search GitHub → read READMEs → copy JSON configs → debug connections → restart Agent.
AAI Gateway:tell your Agent "use AAI to search for xxx" — auto-searches, installs, ready to use.
"Use AAI to search for a browser automation tool"
→ Search → finds Playwright MCP → Agent summarizes a one-line Agent App summary → install → ready to use, no restart needed
"Use AAI to search for a PPT creation skill"
→ Search → finds PPT Skill → uses skill description as Agent App summary → install → ready to use, no restart needed
Configure the same thing in Claude Code, Codex, and OpenCode separately? Import once through AAI Gateway, all Agents share instantly.
claude mcp add --scope user --transport stdio aai-gateway -- npx -y aai-gateway
codex mcp add aai-gateway -- npx -y aai-gateway
OpenCode— add to~/.config/opencode/opencode.json:
{ "mcp": { "aai-gateway": { "type": "local", "command": ["npx", "-y", "aai-gateway"], "enabled": true } } }
openclaw plugins install openclaw-aai-gateway-plugin
Once installed, just tell your Agent what you want to do.
Each imported Agent App generates anapp_<app-id>tool that returns the full operation guide and tool list when called.
Preset Agent Apps (auto-discovered when locally installed)
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





