@mhdd_24/ai-gateway-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@mhdd_24/ai-gateway-mcpcheck the status of all connected LLM providers"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@mhdd_24/ai-gateway-mcp
MCP server for Manage multiple LLM providers.
Same architecture as @mhdd_24/sublime-mcp.
Full documentation: docs/WIKI.md
How it works (30 seconds)
You (chat) → MCP client → ai-gateway-mcp → AI Gateway APIs / CLIs / local toolsRelated MCP server: GoClaw MCP Server
Prerequisites
Requirement | Notes |
Node.js 18+ | ESM TypeScript MCP server |
Credentials / CLIs | See environment variables below |
Install
Option A — npm (after publish)
npm install -g @mhdd_24/ai-gateway-mcpOption B — npx
npx @mhdd_24/ai-gateway-mcpOption C — clone and build
git clone https://github.com/Mhdd-24/AI-Gateway-MCP.git
cd AI-Gateway-MCP
npm install
npm run build
node dist/index.jsConfigure Cursor
Edit ~/.cursor/mcp.json:
{
"mcpServers": {
"aigw": {
"command": "npx",
"args": ["-y", "@mhdd_24/ai-gateway-mcp"],
"env": {
"AI_GATEWAY_URL": "...",
"AI_GATEWAY_TOKEN": "..."
}
}
}
}Local development:
{
"command": "node",
"args": ["/absolute/path/to/AI-Gateway-MCP/dist/index.js"]
}Environment variables
Variable | Description |
| Gateway URL |
| Token |
Tools
Tool | Description |
| Show manage multiple llm providers configuration / health. |
| List manage multiple llm providers entities. |
| Inspect a manage multiple llm providers artifact. |
| Compare two manage multiple llm providers items. |
License
ISC
Available Tools
4 toolsaigw_compareD
Compare two manage multiple llm providers items.
| Name | Required | Description | Default |
|---|---|---|---|
| left | Yes | Left | |
| right | Yes | Right |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure, but it discloses nothing about side effects, authorization needs, output format, or potential failure modes. 'Compare' suggests a read-only operation, but the description never states this explicitly.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is short and front-loaded with the verb, but the sentence is malformed and confusing. This is under-specification rather than effective conciseness; the brevity does not aid comprehension.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a compare operation with no annotations and no output schema, the description should at least specify what fields or characteristics are compared and what the result looks like. It provides none of that, leaving the tool effectively unusable without external documentation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3 even though the parameter descriptions are only the unhelpful labels 'Left' and 'Right'. The tool description adds nothing about what values should be passed or how they are formatted, so it does not improve on the schema's minimal information.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a verb ('Compare') and two items, but the phrase 'manage multiple llm providers items' is grammatically broken and does not clearly identify what kind of objects are being compared. It does little more than restate the tool name 'compare' and leaves the resource type ambiguous even with sibling names available.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance on when to use this tool versus aigw_list, aigw_inspect, or aigw_status. No conditions, prerequisites, or alternatives are mentioned, so an agent has no basis for selecting this tool over its siblings.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
aigw_inspectC
Inspect a manage multiple llm providers artifact.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Name/id |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden of behavioral disclosure, but it only says 'Inspect'. It does not mention return format, side effects, permissions, or whether the operation is safe beyond the verb's implication. This is thin for a tool with no annotation support.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is appropriately short for a tool with one parameter, but the wording is awkward and confusing. It is concise in length yet lacks the clarity needed for the sentence to fully earn its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a one-parameter tool with no output schema and no annotations, the description should provide more context about what 'inspect' returns and what the artifact is. The unclear phrase 'manage multiple llm providers artifact' leaves important gaps for an agent deciding how to invoke and interpret the result.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema has 100% coverage for the only parameter, 'name', described as 'Name/id', so the baseline is 3. The description adds no additional meaning about the parameter's format, semantics, or allowed values beyond what the schema already provides.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific verb, 'Inspect', and a resource, 'artifact', so it is not a tautology. However, the phrase 'a manage multiple llm providers artifact' is grammatically broken and unclear, making the exact object of inspection vague. It does not explicitly differentiate from sibling tools like aigw_status, aigw_list, or aigw_compare.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus the sibling tools. The description neither states conditions, exclusions, nor alternatives, leaving the agent to infer the tool's role from its name.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
aigw_listC
List manage multiple llm providers entities.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results | |
| query | No | Filter |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are present, so the description carries the full burden. It only states 'List', implying a read-only operation, but does not explicitly disclose safety, pagination, response format, or any side effects. For a listing tool this is minimal disclosure, leaving key behavioral traits undocumented.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence, which is concise, but the structure is awkward ('List manage multiple...'). It is not front-loaded with the most critical information and could be clearer, but it is not verbose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a list tool with optional parameters and no output schema, the description should clarify what entities are returned and the response structure. It mentions 'llm providers entities' but does not elaborate on what that includes or how results are presented, making it incomplete for an agent to predict the tool's behavior.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%: both 'limit' and 'query' have descriptions ('Max results' and 'Filter'). The description adds no additional meaning beyond the schema, so the baseline of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description 'List manage multiple llm providers entities' has a clear verb 'List' and a resource 'llm providers entities', but the phrasing is awkward and the term 'entities' is vague. It does not explicitly differentiate from siblings like aigw_status, aigw_inspect, or aigw_compare, though the name implies a listing function. It is not a tautology but lacks specificity.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance on when to use this tool versus its siblings. No mention of conditions, alternatives, or exclusions. The agent must infer from the name that it lists entities, but no explicit context is provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
aigw_statusC
Show manage multiple llm providers configuration / health.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It fails to state whether the tool is read-only, what 'health' or 'configuration' outputs look like, or whether 'manage' implies side effects. The ambiguous verb 'Show manage' actively obscures the safety profile.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is appropriately short, but the phrasing is grammatically awkward ('Show manage') and the slash-separated 'configuration / health' reads as under-specified shorthand rather than clear prose. It is concise in length but not in clarity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Although the tool is simple with no parameters and no output schema, the description still fails to clarify what a status result contains, whether the operation is safe, or how it relates to the sibling list/inspect/compare tools. A complete one-line description could easily have resolved these ambiguities.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool has zero parameters and the empty input schema is fully covered, so there are no parameter gaps for the description to fill. The baseline of 4 applies because no parameter documentation is needed.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a resource ('multiple llm providers configuration / health') but uses the confusing compound verb 'Show manage,' making it unclear whether this is a read-only status display or a management/mutation action. It does not distinguish itself from siblings like aigw_list or aigw_inspect, and the meaning of 'status' is left vague.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is given about when to use this tool instead of aigw_list, aigw_inspect, or aigw_compare. The description does not state any conditions, exclusions, or alternatives, so an agent must infer usage solely from the tool name.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
4 tool updates
v1.0.0- First observed
aigw_compare - First observed
aigw_inspect - First observed
aigw_list - First observed
aigw_status
TDQS
Scored across 4 tools
The four tools are mostly distinct: status reports health/configuration, list enumerates entities, inspect drills into one artifact, and compare contrasts two items. There is mild potential overlap between status and inspect, but descriptions are clear enough for an agent to select the intended operation.
All tool names follow the same aigw_<verb> pattern using simple, consistent verbs. This creates a predictable convention across the entire tool set.
Four tools is a reasonable, focused count for a read-only gateway observability utility. It sits slightly low for a server claiming to 'manage' providers, but the count itself is not excessive or trivial.
The tool surface only supports reading and comparing gateway entities; there are no create, update, delete, or configuration-change operations. Given the 'manage' framing, this is a significant functional gap that would prevent agents from actually managing providers.
Maintenance
Related MCP Connectors
Manage ConfigDirector feature flags, remote configs, and targeting rules from AI assistants.
Provides capabilities that let LLM agents perform a range of infrastructure management tasks.
OpenAI-compatible BYOK LLM gateway: per-task routing, shadow evaluation, promotion gates.
Enterprise AI Control Plane: governance, guardrails, spend tracking, compliance & smart routing.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Azure AI Foundry services through a unified interface for model exploration and deployment, knowledge indexing and search, AI evaluation, and fine-tuning operations. Supports both GitHub token-based model testing and full Azure deployment workflows.3MIT
- AlicenseBqualityFmaintenanceEnables AI assistants to manage GoClaw AI gateway infrastructure through a comprehensive suite of 66 tools for managing agents, sessions, and configurations. It provides real-time gateway context and guided workflows with enterprise-grade security features like audit logging and secret scrubbing.6612MIT
- FlicenseNot gradedqualityDmaintenanceEnables querying and managing AI logs through tools like listing logs, retrieving jobs, and performing AI-powered chat queries. Also provides access to gateway security reports and guardrail testing.-
- AlicenseNot gradedqualityAmaintenanceUnified AI gateway that aggregates MCP tools from multiple servers and routes LLM requests with provider combos and fallback, all managed through a web UI.1MIT