{
  "markdown": "# AI Gateway tier in Azure API Management\n\n**One gateway for every model and tool.**\n[AI Gateway tier in Azure API Management](https://aka.ms/aigateway/docs) is the AI-focused tier of Azure API\nManagement. It gives developers one familiar way to call model APIs and MCP tools, while\nplatform teams enforce security, policy, networking, and observability.\n\n- **Govern model APIs** — Microsoft Foundry, OpenAI, Anthropic, Google Vertex, and more, while developers keep the SDKs they already use.\n- **Federate MCP tools** — combine MCP servers, OpenAPI APIs, and SaaS connectors behind one governed MCP endpoint.\n- **Enforce AI policies** — access, content safety, token, and rate controls, globally or per model and tool.\n- **Observe AI traffic** — token usage, latency, errors, and policy outcomes in dashboards and logs.\n- **Run on a trusted platform** — the Azure API Management platform, with Private Link, virtual network integration, and managed identity.\n\n> AI Gateway is in **public preview**, available free of charge. See the **[documentation](https://aka.ms/aigateway/docs)** to get started.\n\n---\n\n## Coding-agent plugin\n\nThis repository hosts the official **plugin** for coding agents. It helps\ndevelopers **build applications on top of an existing AI Gateway tier in Azure API Management resources**: it discovers the\nmodels and MCP tool servers registered in a gateway and integrates them into whatever\nyou're building — call a model over the OpenAI-compatible passthrough, connect MCP\ntools, or scaffold a runnable agent — all from your coding agent.\n\nThe plugin follows the [Claude Code plugin spec](https://code.claude.com/docs/en/plugins),\nthe [GitHub Copilot / awesome-copilot plugin convention](https://github.com/github/awesome-copilot/blob/main/CONTRIBUTING.md#adding-plugins),\nthe [Cursor plugin format](https://cursor.com/docs/plugins), and the\n[Gemini CLI extension format](https://geminicli.com/docs/extensions/), so it installs\nin any of those coding agents (and other agents that support the plugin standard).\n\n> **Consumption only.** The plugin is read-only against the gateway — it never\n> provisions, updates, or deletes resources. Creating gateways, models, or tools\n> is an administrator task done in the [AI Gateway Portal](https://ai.gateway.azure.com).\n\n### What's inside\n\n| Component | Invoked as | Purpose |\n| --------- | ---------- | ------- |\n| Skill `use-ai-gateway` | `/ai-gateway:use-ai-gateway` | Full discover → select → credential → integrate workflow (call a model, connect MCP tools, or scaffold an agent). |\n| Command `discover` | `/ai-gateway:discover` | Read-only: list a gateway's models and MCP tool servers and pick the ones that fit your use case. |\n| Command `build` | `/ai-gateway:build` | End-to-end: discover, retrieve a credential, and integrate the models/tools into your app. |\n\n### Install\n\nThe plugin is hosted in this repository, so your coding agent can install it\ndirectly from Git — no manual file downloads. Pick the tab for your agent:\n\n**Claude Code / GitHub Copilot CLI** (plugin marketplace protocol):\n\n```\n/plugin marketplace add Azure/ai-gateway\n/plugin install ai-gateway@azure\n```\n\n**Cursor** — add this repository as a team marketplace from **Dashboard → Plugins →\nAdd Marketplace → Import from Repo** (`https://github.com/Azure/ai-gateway`), then\ninstall **ai-gateway** from **Customize**. For local testing, symlink the repo into\n`~/.cursor/plugins/local/ai-gateway` and reload the window.\n\n**Gemini CLI**:\n\n```\ngemini extensions install https://github.com/Azure/ai-gateway\n```\n\n### Usage\n\nPoint the plugin at your gateway's **ARM resource id** (required to list its models and\ntools) and describe what you want to build:\n\n```\n/ai-gateway:build /subscriptions/<sub>/resourceGroups/<rg>/providers/Microsoft.ApiManagement/service/<gateway> a service that summarizes support tickets\n```\n\nOr explore first, then integrate:\n\n```\n/ai-gateway:discover /subscriptions/<sub>/resourceGroups/<rg>/providers/Microsoft.ApiManagement/service/<gateway>\n```\n\n### Security\n\nThe generated code authenticates the model passthrough and the MCP tool servers\nwith a gateway **API key**, read from an environment variable\n(`AI_GATEWAY_API_KEY`) and never hardcoded. Scaffolded projects keep `.env` out of\nsource control. If a key is ever exposed, rotate it in the [AI Gateway Portal](https://ai.gateway.azure.com).\n\nTo report a security issue, see [SECURITY.md](SECURITY.md).\n\n## Samples\n\nLooking for working examples? The [samples catalog](samples/README.md) curates end-to-end\nsamples and infrastructure that build on the AI Gateway tier in Azure API Management.\n\n## Contributing\n\nThis project welcomes contributions and suggestions. Most contributions require you\nto agree to a Contributor License Agreement (CLA) declaring that you have the right\nto, and actually do, grant us the rights to use your contribution. For details,\nvisit [Contributor License Agreements](https://cla.opensource.microsoft.com).\n\nWhen you submit a pull request, a CLA bot will automatically determine whether you\nneed to provide a CLA and decorate the PR appropriately (e.g., status check,\ncomment). Simply follow the instructions provided by the bot. You will only need to\ndo this once across all repos using our CLA.\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)\nor contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any\nadditional questions or comments.\n\n## Trademarks\n\nThis project may contain trademarks or logos for projects, products, or services.\nAuthorized use of Microsoft trademarks or logos is subject to and must follow\n[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/legal/intellectualproperty/trademarks/usage/general).\nUse of Microsoft trademarks or logos in modified versions of this project must not\ncause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or\nlogos are subject to those third-party's policies.\n",
  "bytes": 6106,
  "sha": "a6bf2ab0d281eff42e0f521543d1806f31a3c0f97b5c6da709e13b670c0cbf6c",
  "repo_slug": "azure/ai-gateway",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_azure_ai_gateway_3f3d29cd/readme"
}