OpenAI Tools MCP Server

Official9 toolsLive

by la-rebelion · HTML

Focused MCP server for OpenAI image/audio generation (v2.0.0). Wraps endpoints via HAPI CLI.

The ai.com.mcp/openai-tools MCP server is a focused Model Context Protocol (MCP) server for OpenAI image/audio generation (v2.0.0). It wraps OpenAI endpoints via HAPI CLI and exposes them as MCP tools. The server is described as lifting an OpenAPI catalog into MCP tools while keeping design and runtime separation.

🛠️ Key Features

Focused MCP server for OpenAI image/audio generation (v2.0.0)
Wraps endpoints via HAPI CLI
Converts OpenAPI catalogs into MCP tools automatically
Claims “no rewrites” of API logic (OpenAPI in, MCP tools out)
Tool count: 9

🚀 Use Cases

Use OpenAI image/audio generation through MCP tools
Turn API specifications into agent-ready MCP tooling

⚡ Developer Benefits

Separates OAS/Arazzo design from agents/LLMs runtime
Reuse existing API logic when exposing MCP tools

⚠️ Limitations

Source data does not describe supported output formats, authentication, or tool schema details

Captured live from the server via tools/list.

createImage

Creates an image given a prompt.

Parameters2

createImageBody	object	required
x-hapi-auth-state	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "createImageBody": {
      "type": "object",
      "properties": {
        "prompt": {
          "type": "string",
          "description": "A text description of the desired image(s). The maximum length is 1000 characters."
        },
        "n": {
          "type": "integer",
          "minimum": 1,
          "maximum": 10,
          "description": "The number of images to generate. Must be between 1 and 10."
        },
        "size": {
          "type": "string",
          "enum": [
            "256x256",
            "512x512",
            "1024x1024"
          ],
          "description": "The size of the generated images. Must be one of `256x256`, `512x512`, or `1024x1024`."
        },
        "response_format": {
          "type": "string",
          "enum": [
            "url",
            "b64_json"
          ],
          "description": "The format in which the generated images are returned. Must be one of `url` or `b64_json`."
        },
        "user": {
          "type": "string",
          "description": "A unique identifier representing your end-user, which can help OpenAI to monitor and detect abuse. [Learn more](/docs/guides/safety-best-practices/end-user-ids).\n"
        }
      },
      "required": [
        "prompt"
      ]
    },
    "x-hapi-auth-state": {
      "type": "string"
    }
  },
  "required": [
    "createImageBody"
  ]
}

createImageEdit

Creates an edited or extended image given an original image and a prompt.

Parameters2

createImageEditBody	object	required
x-hapi-auth-state	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "createImageEditBody": {
      "type": "object",
      "properties": {
        "image": {
          "type": "string",
          "format": "binary",
          "description": "The image to edit. Must be a valid PNG file, less than 4MB, and square. If mask is not provided, image must have transparency, which will be used as the mask."
        },
        "mask": {
          "type": "string",
          "format": "binary",
          "description": "An additional image whose fully transparent areas (e.g. where alpha is zero) indicate where `image` should be edited. Must be a valid PNG file, less than 4MB, and have the same dimensions as `image`."
        },
        "prompt": {
          "type": "string",
          "description": "A text description of the desired image(s). The maximum length is 1000 characters."
        },
        "n": {
          "type": "integer",
          "minimum": 1,
          "maximum": 10,
          "description": "The number of images to generate. Must be between 1 and 10."
        },
        "size": {
          "type": "string",
          "enum": [
            "256x256",
            "512x512",
            "1024x1024"
          ],
          "description": "The size of the generated images. Must be one of `256x256`, `512x512`, or `1024x1024`."
        },
        "response_format": {
          "type": "string",
          "enum": [
            "url",
            "b64_json"
          ],
          "description": "The format in which the generated images are returned. Must be one of `url` or `b64_json`."
        },
        "user": {
          "type": "string",
          "description": "A unique identifier representing your end-user, which can help OpenAI to monitor and detect abuse. [Learn more](/docs/guides/safety-best-practices/end-user-ids).\n"
        }
      },
      "required": [
        "prompt",
        "image"
      ]
    },
    "x-hapi-auth-state": {
      "type": "string"
    }
  },
  "required": [
    "createImageEditBody"
  ]
}

createImageVariation

Creates a variation of a given image.

Parameters2

createImageVariationBody	object	required
x-hapi-auth-state	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "createImageVariationBody": {
      "type": "object",
      "properties": {
        "image": {
          "type": "string",
          "format": "binary",
          "description": "The image to use as the basis for the variation(s). Must be a valid PNG file, less than 4MB, and square."
        },
        "n": {
          "type": "integer",
          "minimum": 1,
          "maximum": 10,
          "description": "The number of images to generate. Must be between 1 and 10."
        },
        "size": {
          "type": "string",
          "enum": [
            "256x256",
            "512x512",
            "1024x1024"
          ],
          "description": "The size of the generated images. Must be one of `256x256`, `512x512`, or `1024x1024`."
        },
        "response_format": {
          "type": "string",
          "enum": [
            "url",
            "b64_json"
          ],
          "description": "The format in which the generated images are returned. Must be one of `url` or `b64_json`."
        },
        "user": {
          "type": "string",
          "description": "A unique identifier representing your end-user, which can help OpenAI to monitor and detect abuse. [Learn more](/docs/guides/safety-best-practices/end-user-ids).\n"
        }
      },
      "required": [
        "image"
      ]
    },
    "x-hapi-auth-state": {
      "type": "string"
    }
  },
  "required": [
    "createImageVariationBody"
  ]
}

createTranscription

Transcribes audio into the input language.

Parameters2

createTranscriptionBody	object	required
x-hapi-auth-state	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "createTranscriptionBody": {
      "type": "object",
      "properties": {
        "file": {
          "type": "string",
          "format": "binary",
          "description": "The audio file object (not file name) to transcribe, in one of these formats: mp3, mp4, mpeg, mpga, m4a, wav, or webm.\n"
        },
        "model": {
          "type": "string",
          "description": "ID of the model to use. Only `whisper-1` is currently available.\n"
        },
        "prompt": {
          "type": "string",
          "description": "An optional text to guide the model's style or continue a previous audio segment. The [prompt](/docs/guides/speech-to-text/prompting) should match the audio language.\n"
        },
        "response_format": {
          "type": "string",
          "description": "The format of the transcript output, in one of these options: json, text, srt, verbose_json, or vtt.\n"
        },
        "temperature": {
          "type": "number",
          "description": "The sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use [log probability](https://en.wikipedia.org/wiki/Log_probability) to automatically increase the temperature until certain thresholds are hit.\n"
        },
        "language": {
          "type": "string",
          "description": "The language of the input audio. Supplying the input language in [ISO-639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format will improve accuracy and latency.\n"
        }
      },
      "required": [
        "file",
        "model"
      ],
      "additionalProperties": false
    },
    "x-hapi-auth-state": {
      "type": "string"
    }
  },
  "required": [
    "createTranscriptionBody"
  ]
}

createTranslation

Translates audio into English.

Parameters2

createTranslationBody	object	required
x-hapi-auth-state	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "createTranslationBody": {
      "type": "object",
      "properties": {
        "file": {
          "type": "string",
          "format": "binary",
          "description": "The audio file object (not file name) translate, in one of these formats: mp3, mp4, mpeg, mpga, m4a, wav, or webm.\n"
        },
        "model": {
          "type": "string",
          "description": "ID of the model to use. Only `whisper-1` is currently available.\n"
        },
        "prompt": {
          "type": "string",
          "description": "An optional text to guide the model's style or continue a previous audio segment. The [prompt](/docs/guides/speech-to-text/prompting) should be in English.\n"
        },
        "response_format": {
          "type": "string",
          "description": "The format of the transcript output, in one of these options: json, text, srt, verbose_json, or vtt.\n"
        },
        "temperature": {
          "type": "number",
          "description": "The sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use [log probability](https://en.wikipedia.org/wiki/Log_probability) to automatically increase the temperature until certain thresholds are hit.\n"
        }
      },
      "required": [
        "file",
        "model"
      ],
      "additionalProperties": false
    },
    "x-hapi-auth-state": {
      "type": "string"
    }
  },
  "required": [
    "createTranslationBody"
  ]
}

listModels

Lists the currently available models, and provides basic information about each one such as the owner and availability.

Parameters1

x-hapi-auth-state

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "x-hapi-auth-state": {
      "type": "string"
    }
  }
}

retrieveModel

Retrieves a model instance, providing basic information about the model such as the owner and permissioning.

Parameters2

model	string	required
x-hapi-auth-state	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "model": {
      "type": "string"
    },
    "x-hapi-auth-state": {
      "type": "string"
    }
  },
  "required": [
    "model"
  ]
}

deleteModel

Delete a fine-tuned model. You must have the Owner role in your organization.

Parameters2

model	string	required
x-hapi-auth-state	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "model": {
      "type": "string"
    },
    "x-hapi-auth-state": {
      "type": "string"
    }
  },
  "required": [
    "model"
  ]
}

createModeration

Classifies if text violates OpenAI's Content Policy

Parameters2

createModerationBody	object	required
x-hapi-auth-state	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "createModerationBody": {
      "type": "object",
      "properties": {
        "input": {
          "type": "string",
          "description": "The input text to classify"
        },
        "model": {
          "type": "string",
          "description": "Two content moderations models are available: `text-moderation-stable` and `text-moderation-latest`.\n\nThe default is `text-moderation-latest` which will be automatically upgraded over time. This ensures you are always using our most accurate model. If you use `text-moderation-stable`, we will provide advanced notice before updating the model. Accuracy of `text-moderation-stable` may be slightly lower than for `text-moderation-latest`.\n"
        }
      },
      "required": [
        "input"
      ]
    },
    "x-hapi-auth-state": {
      "type": "string"
    }
  },
  "required": [
    "createModerationBody"
  ]
}

README.md6 KBView on GitHub

HAPI MCP – Headless API for Model Context Protocol

Stop rewriting systems for AI. Instantly turn your APIs into MCP servers.

HAPI MCP lifts your OpenAPI catalog into MCP tools automatically, keeping design (OAS/Arazzo) and runtime (agents/LLMs) cleanly separated. Your existing APIs become AI-ready tools—no new business logic, no sidecar servers, no rework.

Key Features

No rewrites: Reuse 100% of your API logic. OpenAPI in, MCP tools out. No parallel codebase or shadow services.
Faster time-to-value: Turn specs into agent-ready tools in minutes. Update the spec, ship new tools instantly.
Reduced risk: Permissions, auth, rate limits, auditability are inherited from your APIs—governance without bolt-ons.
Scales with you: runMCP delivers serverless-like elasticity with long-running when needed. Cold-start fast, stay warm for throughput.
Deterministic orchestration: OrcA plans and executes multi-tool tasks predictably—no brittle prompt chaining.
Vendor-neutral: Works with any MCP client: ChatGPT, Claude, QBot, chatMCP. OAS + MCP + Arazzo stay portable.

How It Works

Pick your API spec
- OpenAPI, Swagger, REST—HAPI CLI works with any API specification format.
- Supports OpenAPI 3.0+, REST APIs, OAuth 2.0 Dynamic Client Registration.
Run a single command
- One simple CLI command transforms your API into a usable MCP Server.
- No complex setup, zero configuration, works anywhere, cross-platform.
Use instantly
- Your API is now ready as a tool, AI agent, or testing interface.
- MCP server ready, AI agent compatible, testing interface, developer experience friendly.

Visual Pipeline

code

API Spec (swagger.json) → HAPI CLI → Usable Tool (AI-ready) ← MCP Clients

code

[ OpenAPI / Swagger ]       [ HAPI CLI ]        [ MCP Server ]
       (Your API)         →   (Transform)   →   (Usable Tool)
                                                 ↑          ↑
                                                 |          |
                                          [ ChatGPT ]  [ runMCP ]
                                          [ Claude  ]  [ OrcA   ]
                                          [ QBot    ]  [ chatMCP]
                                          [ Agents  ]

Who Wins With HAPI

Executives: Ship AI initiatives without ballooning cost. Keep teams focused on outcomes, not rewrites and integration sprawl.
Architects & PMs: Design with OpenAPI/Arazzo, run with MCP. Clear contracts, policy inheritance, and versioned workflows keep risk low.
Engineers & Ops: Deploy once. HAPI Server + runMCP scale tools; QBot/chatMCP give fast feedback; OrcA keeps executions deterministic.

Your Stack, Already Wired

HAPI Server: Turns OpenAPI into MCP tools automatically—contracts stay in sync with your source of truth.
runMCP: Autoscaling execution and testing for MCP tools; cold-start fast, stay warm when workflows run long.
QBot: CLI TUI for power users to interact with MCP tools directly from terminal or scripts.
chatMCP: Conversational client that speaks MCP natively for support, ops, and internal assistants.
OrcA: Deterministic planning and orchestration for multi-tool tasks; no brittle prompt spaghetti.
Agents: Build agentic systems from standard APIs—no custom glue. Connect MCP clients across platforms.

Demos

Playlist with demos
New HAPI MCP YT Channel with demos API-First and MCP

Documentation

FAQ

Do we need to rewrite our services?
No. HAPI MCP lifts your existing OpenAPI specs directly into MCP tools. Your auth, validation, and business rules remain unchanged.
Is this just another MCP server?
It’s the Headless API model: your API becomes the runtime. HAPI Server reflects it as MCP; runMCP scales it; OrcA orchestrates it. No duplicate logic.
Which clients can consume the tools?
Any MCP client: ChatGPT, Claude, QBot, chatMCP, bespoke orchestrators—vendor-neutral by design.
How do we keep control and compliance?
Your API remains the single source of truth. Policies, RBAC, rate limits, and audit logs flow through automatically; no shadow logic.
What about security and privacy?
Scoped credentials, per-tool permissions, and auditable calls are inherited from your API layer. HAPI adds guardrails and observability for regulated environments.
How fast can we get started?
You can transform your first API into an MCP tool in less than five minutes. The HAPI CLI makes it quick and painless.

Get Started

Install HAPI CLI from latest release: https://github.com/la-rebelion/hapimcp/releases
Transform your OpenAPI spec into an MCP server with a single command:
bash
```
hapi serve path/to/your/swagger.json --headless
```
Start using your MCP tools with any compatible client!
Explore the documentation for advanced usage and best practices.

Contributing

Contributions are welcome! Open a discussion or submit a pull request on GitHub: https://github.com/la-rebelion/hapimcp

License

HAPI MCP is licensed under the MIT License. See LICENSE for details.

Install

Tools (9)

createImagecreateImageEditcreateImageVariationcreateTranscriptioncreateTranslationlistModelsretrieveModeldeleteModel

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://openai-tools.run.mcp.com.ai/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "openai-tools": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://openai-tools.run.mcp.com.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

createImage

createImageEdit

createImageVariation

createTranscription

createTranslation

listModels

retrieveModel

deleteModel

createModeration

HAPI MCP – Headless API for Model Context Protocol

Key Features

How It Works

Visual Pipeline

Who Wins With HAPI

Your Stack, Already Wired

Demos

Documentation

FAQ

Get Started

Contributing

License

Install

Remote endpoint

Related servers