AAI Gateway

gybob/aai-gateway

A meta-layer for managing MCP servers and skill packages across multiple AI agents. Instead of configuring the same tools separately in Claude Code, Codex, and OpenCode, you import once and share everywhere. The big win is context efficiency: traditional setups inject full schemas for every tool into every conversation, but this loads a sub-50-token summary per app and fetches details on demand. It exposes search:discover for natural language tool finding, mcp:import and skill:import for registration, and aai:exec for running tools from registered apps. Auto-discovers locally installed agents and lets you enable or disable apps per agent. Useful when you're juggling multiple AI coding assistants and tired of maintaining duplicate configs or burning tokens on unused tool definitions.

GitHub stars: 104
tools: 11
transport: STDIO
last updated: Apr 7, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp aai-gateway --name aai-gateway

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add aai-gateway -- npx -y aai-gateway

Run in your terminal. Replace YOUR_* placeholders with real values; add --scope user to install for every project.

Tools

Verified live · 11 tools

Verified live against the running server on Jun 11, 2026.

app:claudeClaude Code — AI assistant for code editing, analysis, and development tasks. Call this to see available tools and usage.

Claude Code — AI assistant for code editing, analysis, and development tasks. Call this to see available tools and usage.

No parameters. Call it with no arguments.

app:codexCodex — AI assistant powered by OpenAI for code generation and editing tasks. Call this to see available tools and usage.

Codex — AI assistant powered by OpenAI for code generation and editing tasks. Call this to see available tools and usage.

No parameters. Call it with no arguments.

app:opencodeOpenCode — AI assistant for editing files, running commands, and automating development tasks. Call this to see available tools and usage.

OpenCode — AI assistant for editing files, running commands, and automating development tasks. Call this to see available tools and usage.

No parameters. Call it with no arguments.

aai:execExecute any AAI tool action. Read the guide first (call app:*, mcp:import, skill:import, or search:discover) — it contains the required schema and parameters.3 params

Execute any AAI tool action. Read the guide first (call app:*, mcp:import, skill:import, or search:discover) — it contains the required schema and parameters.

Parameters* required

appstring

Required for app tools, omit or use "gateway" for gateway tools.

argsobject

Arguments for the selected tool.

tool*string

Tool name within the app, not prefixed with app id.

mcp:importImport an MCP server as a GLOBAL app (visible to all projects). For project-level MCP, use your agent's native config instead (e.g. .mcp.json, .cursor/mcp.json). Call this first to get the import guide. Never ask the user for API keys or secrets in chat.

Import an MCP server as a GLOBAL app (visible to all projects). For project-level MCP, use your agent's native config instead (e.g. .mcp.json, .cursor/mcp.json). Call this first to get the import guide. Never ask the user for API keys or secrets in chat.

No parameters. Call it with no arguments.

skill:importImport a local skill as a GLOBAL app (visible to all projects). For project-level skills, use your agent's native skill directory instead (e.g. .claude/skills/). Call this first to get the import guide.

Import a local skill as a GLOBAL app (visible to all projects). For project-level skills, use your agent's native skill directory instead (e.g. .claude/skills/). Call this first to get the import guide.

No parameters. Call it with no arguments.

listAllAaiAppsList imported apps (MCP servers and skills) for the current agent. This does not include built-in tools like search:discover, mcp:import, or skill:import — those are always available.

List imported apps (MCP servers and skills) for the current agent. This does not include built-in tools like search:discover, mcp:import, or skill:import — those are always available.

No parameters. Call it with no arguments.

disableAppDisable one app for the current agent only. If you do not know the app id, call listAllAaiApps first to find it.1 params

Disable one app for the current agent only. If you do not know the app id, call listAllAaiApps first to find it.

Parameters* required

app*string

Required. The app id to disable. Use listAllAaiApps to look up available app ids.

enableAppEnable or re-enable an app for the current agent. When the user asks to enable, start, turn on, or use a specific app by name, call listAllAaiApps first to check if it is already imported before searching for new tools.1 params

Enable or re-enable an app for the current agent. When the user asks to enable, start, turn on, or use a specific app by name, call listAllAaiApps first to check if it is already imported before searching for new tools.

Parameters* required

app*string

Required. The app id to re-enable. Use listAllAaiApps to look up available app ids.

removeAppRemove one AAI Gateway managed import from all agents. If you do not know the app id, call listAllAaiApps first to find it.2 params

Remove one AAI Gateway managed import from all agents. If you do not know the app id, call listAllAaiApps first to find it.

Parameters* required

app*string

Required. The imported app id to remove globally. Use listAllAaiApps to look up available app ids.

confirm*boolean

Required. Must be true only after the agent explains the global impact and the user explicitly confirms.

search:discoverFind and install new tools. Call this when: 1. The user explicitly asks to search for or install tools. 2. The user's request cannot be fulfilled by any currently available tool — proactively suggest and search for a suitable tool. Before searching, check listAllAaiApps first...

Find and install new tools. Call this when: 1. The user explicitly asks to search for or install tools. 2. The user's request cannot be fulfilled by any currently available tool — proactively suggest and search for a suitable tool. Before searching, check listAllAaiApps first...

No parameters. Call it with no arguments.

Readme

English | 简体中文 | 日本語 | 한국어

AAI Gateway: Unified MCP & Skill Management, Shared Across AI Agents, 99% Context Token Savings

What Is It

AAI = Agent App Interface

AAI Gateway is the interaction gateway for Agent Apps.

What is an Agent App? An Agent App is a collection of capabilities that an Agent can use. For example:

An MCP Server is an Agent App — it provides a set of tools
A Skill package is an Agent App — it provides one or more skills

In AAI Gateway, they are abstracted as Agent Apps under unified management. Import once, and all AI Agents can use them immediately.

What Problems Does It Solve

Context Bloat

Traditional: 10 MCPs × 5 tools = 50 full schemas ≈ 7,500 tokens injected into every conversation.

AAI Gateway: each Agent App needs only fewer than 50 tokens for a summary, with details loaded on demand. 99% token savings.

Finding Tools Is Hard

View the full README on GitHub

Details

Repository: github.com/gybob/aai-gateway
Website: github.com/gybob/aai-gateway
Package: aai-gateway
Transport: STDIO
Registry: MCP registry, active
Tools verified: Jun 11, 2026