AAI Gateway

by gybob

Not rated
GitHub

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

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)

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.