Self-hosted MCP — Gommo platform (preview)

Coming to Gommo platform

Self-hosted MCP wraps your gateway URL. Most users should use Gommo remote MCP. Official agent tooling will ship on Gommo.

→ Gommo platform roadmap

The optional Gommo Developer MCP server is a stdio MCP server that wraps your deployed self-host (/gateway/*). Use it only when IDE agents must call your API URL instead of Gommo remote MCP.

npm alias

Published on npm as @ai-gateway/mcp-server. The Cursor config key "ai-gateway" below is a legacy label — you may rename the key; keep args as shown.

Most Cursor users should use Gommo MCP — simpler, no npx, no GATEWAY_URL.

When to use this

Use self-hosted MCP	Use Gommo MCP instead
Merchant white-label: IDE must hit api.yourdomain.com	Default for Gommo platform users
You need gateway middleware (logging, custom routing)	Personal / standard IDE workflow
Testing gateway MCP integration in development	Day-to-day Cursor usage

Setup

Published package

{
  "mcpServers": {
    "ai-gateway": {
      "command": "npx",
      "args": ["-y", "@ai-gateway/mcp-server"],
      "env": {
        "GATEWAY_URL": "https://api.yourdomain.com",
        "GATEWAY_ACCESS_TOKEN": "<from /app/token/>"
      }
    }
  }
}

Local dev: set GATEWAY_URL to http://localhost:3001 and run npm run dev.

Monorepo

npm run mcp:build

{
  "mcpServers": {
    "ai-gateway": {
      "command": "node",
      "args": ["C:/path/to/ai-gateway/packages/mcp-server/dist/index.js"],
      "env": {
        "GATEWAY_URL": "http://localhost:3001",
        "GATEWAY_ACCESS_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Environment variables

Variable	Default	Description
GATEWAY_URL	http://localhost:3001	Your gateway base URL
GATEWAY_ACCESS_TOKEN	(required)	User token from /app/token/
GATEWAY_DOMAIN	<registration-domain>	Domain for /ai/me

Next

→ Gommo MCP · MCP tools · packages/mcp-server README