The trade is deliberate: each app contributes a one-line summary up front and its real schema only when it is called, which keeps a large collection of servers usable at the cost of one extra hop through aai:exec. The second benefit is quieter but adds up — an import is shared across every agent on the machine, so Claude Code, Codex and OpenCode stop each keeping their own copy of the same configuration.
A management layer in front of your other MCP servers and skills. Each import becomes an Agent App represented by a short summary in the session; the details are fetched when the app is actually called, and imports are shared across agents rather than configured per client.
- Mcp:import brings an MCP server in as a global app, and skill:import does the same for a local skill — both return the import guide first, so the shape of the call is not guesswork
- Aai:exec is the single entry point that runs any action on any imported app
- Search:discover finds and installs new tools during a conversation, which is what turns "I need a browser automation tool" into an installed one without a restart
- listAllAaiApps shows what is imported for the current agent, and enableApp and disableApp turn one on or off for that agent alone
- removeApp deletes an import from every agent, behind an explicit confirm
- getAppConfig returns an app's full configuration plus ready-to-share install snippets
- updateAppConfig changes one field of an imported server — an argument, a timeout, an environment variable, a transport — and preserves the rest, so a single parameter can be fixed without re-entering the whole config
No account and no key of its own — each imported app still needs whatever credentials it needs. It runs as npx -y aai-gateway over stdio, and the README gives the one-line add commands for Claude Code, Codex and OpenCode, plus a plugin for OpenClaw. Imports it manages are global, so project-scoped servers still belong in your agent's own config (.mcp.json, .cursor/mcp.json) and project-scoped skills in its skill directory.
One command — claude mcp add --scope user --transport stdio aai-gateway -- npx -y aai-gateway
