Skip to content
Back to search

aai-gateway

AAI Gateway — Install MCP servers and skills once, share across all your AI agents. One-time setup, 90% less context overhead. The unified gateway for AI agent tooling.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/gybob--aai-gateway/badge.svg)](/listings/gybob--aai-gateway)

HTML

<a href="/listings/gybob--aai-gateway"><img src="/api/listings/gybob--aai-gateway/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Claude Code:**

claude mcp add --scope user --transport stdio aai-gateway -- npx -y aai-gateway

**Codex:**

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](https://openclaw.ai):**

openclaw plugins install openclaw-aai-gateway-plugin

Once installed, just tell your Agent what you want to do.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 156 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. [English](README.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko.md)
  2. ---
  3. # AAI Gateway: Unified MCP & Skill Management, Shared Across AI Agents, 99% Context Token Savings
  4. [![npm version](https://img.shields.io/npm/v/aai-gateway)](https://www.npmjs.com/package/aai-gateway)
  5. [![license](https://img.shields.io/npm/l/aai-gateway)](./LICENSE)
  6. ---
  7. ## What Is It
  8. **AAI** = **Agent App Interface**
  9. AAI Gateway is the interaction gateway for Agent Apps.
  10. What is an **Agent App**? An Agent App is a collection of capabilities that an Agent can use. For example:
  11. - An **MCP Server** is an Agent App — it provides a set of tools
  12. - A **Skill package** is an Agent App — it provides one or more skills
  13. In AAI Gateway, they are abstracted as **Agent Apps** under unified management. Import once, and all AI Agents can use them immediately.
  14. ---
  15. ## What Problems Does It Solve
  16. ### Context Bloat
  17. Traditional: 10 MCPs × 5 tools = **50 full schemas ≈ 7,500 tokens** injected into every conversation.
  18. AAI Gateway: each Agent App needs only **fewer than 50 tokens for a summary**, with details loaded on demand. **99% token savings.**
  19. ### Finding Tools Is Hard
  20. Traditional: search GitHub → read READMEs → copy JSON configs → debug connections → restart Agent.
  21. AAI Gateway: **tell your Agent "use AAI to search for xxx" — auto-searches, installs, ready to use**.
  22. > "Use AAI to search for a browser automation tool"
  23. >
  24. > → Search → finds Playwright MCP → Agent summarizes a one-line Agent App summary → install → ready to use, no restart needed
  25. > "Use AAI to search for a PPT creation skill"
  26. >
  27. > → Search → finds PPT Skill → uses skill description as Agent App summary → install → ready to use, no restart needed
  28. ### Duplicate Config
  29. Configure the same thing in Claude Code, Codex, and OpenCode separately? Import once through AAI Gateway, all Agents share instantly.
  30. ---
  31. ## Quick Start (30 Seconds)
  32. **Claude Code:**
  33. ```bash
  34. claude mcp add --scope user --transport stdio aai-gateway -- npx -y aai-gateway
  35. ```
  36. **Codex:**
  37. ```bash
  38. codex mcp add aai-gateway -- npx -y aai-gateway
  39. ```
  40. **OpenCode** — add to `~/.config/opencode/opencode.json`:
  41. ```json
  42. {
  43. "mcp": {
  44. "aai-gateway": {
  45. "type": "local",
  46. "command": ["npx", "-y", "aai-gateway"],
  47. "enabled": true
  48. }
  49. }
  50. }
  51. ```
  52. **[OpenClaw](https://openclaw.ai):**
  53. ```bash
  54. openclaw plugins install openclaw-aai-gateway-plugin
  55. ```
  56. Once installed, just tell your Agent what you want to do.
  57. ---
  58. ## Built-in Tools
  59. | Tool | Description |
  60. |------|-------------|
  61. | `search:discover` | Search and install new tools with natural language |
  62. | `mcp:import` | Import an MCP Server as an Agent App |
  63. | `skill:import` | Import a Skill package as an Agent App |
  64. | `listAllAaiApps` | List all registered Agent Apps |
  65. | `enableApp` / `disableApp` | Enable or disable an Agent App per Agent |
  66. | `removeApp` | Remove an Agent App |
  67. | `aai:exec` | Execute a specific tool within an Agent App |
  68. Each imported Agent App generates an **`app_<app-id>`** tool that returns the full operation guide and tool list when called.
  69. ### Preset Agent Apps (auto-discovered when locally installed)
  70. | App ID | Name | Description |
  71. |--------|------|-------------|
  72. | `claude` | Claude Code | AI coding assistant for code editing, analysis, and development |
  73. | `codex` | Codex | OpenAI-powered AI coding assistant |
  74. | `opencode` | OpenCode | AI development assistant for editing files and running commands |
  75. ---
  76. ## Architecture
  77. ![Architecture](images/architecture.png)
  78. ---
  79. ## Developers: Get Your Agent App Auto-Discovered
  80. Create an `aai.json` descriptor and submit it to `src/discovery/descriptors/`. When a user's local environment meets the `discovery.checks` conditions, the Agent will auto-discover your Agent App.
  81. ```json
  82. {
  83. "schemaVersion": "2.0",
  84. "version": "1.0.0",
  85. "app": {
  86. "name": { "default": "My App" }
  87. },
  88. "discovery": {
  89. "checks": [
  90. { "kind": "command", "command": "my-app" }
  91. ]
  92. },
  93. "access": {
  94. "protocol": "mcp",
  95. "config": {
  96. "command": "my-app-mcp",
  97. "args": ["--stdio"]
  98. }
  99. },
  100. "exposure": {
  101. "summary": "Use when the user wants to do X."
  102. }
  103. }
  104. ```
  105. `discovery.checks` supports three check types: `command` (command exists), `file` (file exists), `path` (directory exists).
  106. Supported protocols: `mcp`, `skill`, `acp-agent`
  107. Welcome to [submit a PR](../../pulls) to contribute new Agent App descriptors, or [open an issue](../../issues) for feedback.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.