AAI Gateway — Claude Code MCP server: what it does, how to install
A gateway that keeps MCP servers and skills in one place: the agent pulls them in on demand and sees a short summary in context.
claude mcp add aai-gateway -- npx -y aai-gatewayWhat AAI Gateway does
AAI stands for Agent App Interface. An MCP server and a skill package both count as an Agent App here: import once and every connected agent gets it. One shared setup instead of pasting the same JSON into Claude, Codex and Cursor.
The server ships its own tools. search:discover finds and installs from a plain-language description, mcp:import and skill:import add a server or a skill, listAllAaiApps lists what is registered, enableApp and disableApp toggle an app for one agent. Every imported app gets an app_<app-id> tool that returns the operation guide and tool list when called. Full schemas load on demand, so the agent does not carry them in every session.
It runs through npx -y aai-gateway, which means Node.js and a working npx on the machine. Developers can get an app picked up automatically with an aai.json descriptor whose checks cover command, file or path; there is no auto-discovery without that file.
What it helps with
- Wire one MCP server into several agents without copying configs
- Find and install a tool from a description instead of reading READMEs and editing JSON
- Keep context small by loading schemas only when a tool is called
- Enable or disable an app per agent
- Register your own app so agents discover it automatically
Example prompts for the agent
- Use AAI to find and install a browser automation tool
- Import the
playwrightMCP server as an Agent App - List all registered Agent Apps and disable
codexfor this project
How to install AAI Gateway
Platform CLI
claude mcp add aai-gateway -- npx -y aai-gatewayPlatform CLI
codex mcp add aai-gateway -- npx -y aai-gatewayConfig file
{
"mcpServers": {
"aai-gateway": {
"command": "npx",
"args": [
"-y",
"aai-gateway"
]
}
}
}Config file
{
"servers": {
"aai-gateway": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"aai-gateway"
]
}
}
}Platform CLI
gemini mcp add aai-gateway npx -y aai-gatewayStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about AAI Gateway
How do I install AAI Gateway in Claude Code?
Run claude mcp add aai-gateway -- npx -y aai-gateway. The server is then available to the agent and you can ask it to search for and install apps.
What does AAI Gateway do?
It keeps MCP servers and skill packages in one store of Agent Apps and shares them with every connected agent. Only a short summary goes into context, and details load when a tool is called.
What does the server need to run?
Node.js and npx: the install command launches the aai-gateway package through npx -y.
