OpenAPI to MCP

Publish & download

Download or publish your generated MCP server after configuring tool rules.

4 sections

Once your tools are configured, you can get the generated MCP server as a downloadable ZIP or host it via the Agenetix Gateway.

Download as ZIP#

  1. Open the server detail page
  2. Click Download Server
  3. You get a ZIP containing:
    • package.json with MCP SDK and telemetry dependencies
    • src/index.ts with tool handlers built from your tool rules
    • .env.example with all required environment variables
    • tsconfig.json configured for Node.js ESM

The generated code uses your custom tool descriptions, instructions, and selection guidance — not just the raw OpenAPI text.

Host via Gateway worker#

For managed hosting behind the Agenetix auth edge:

  1. Configure hosting in the server's Runtime settings
  2. Choose Gateway Worker as the runtime mode
  3. The generated server runs as a worker behind your Gateway
  4. Agents and the SDK connect via the Gateway URL
MERMAID
flowchart LR
    SDK["Agent SDK"] --> GW["Gateway URL"]
    GW --> Worker["Generated worker"]
    Worker --> API["Your upstream API"]

Attach to an agent#

After publishing, attach the server to an Agent:

  1. Go to Agents > your agent
  2. Click Attach MCP Server
  3. Select the generated server
  4. Optionally configure which tools the agent can use

Republishing after changes#

When you edit tool rules or refresh the OpenAPI spec, the server detail page shows a Needs redeploy indicator. Click Publish to regenerate and redeploy with your latest changes.