OpenAIMCP

A Model Context Protocol (MCP) server for OpenAI API access using AceDataCloud.

Interact with OpenAI models for chat completions, image generation, text embeddings, and more — directly from Claude, VS Code, or any MCP-compatible client.

Features

Chat Completions — Access GPT-4, GPT-4o, GPT-5, o1, o3, o4-mini, and many more models
Responses API — Extended model variant support including dated releases and search-preview models
Image Generation — Create images with gpt-image-1, gpt-image-2, GPT Image 2.5 Flare/Sunburst standard or official variants, dall-e-3, and nano-banana models
Image Editing — Modify existing images with AI
Text Embeddings — Generate vector representations with text-embedding-3 models
Audio — Convert text to speech and transcribe audio with whisper-1 or gpt-transcribe

Quick Start

Prerequisites

Get an API token from AceDataCloud.

Installation

pip install mcp-openai

Configuration

Set your API token:

export ACEDATACLOUD_API_TOKEN=your_api_token_here

Run

mcp-openai

Available Tools

Tool	Description
`openai_chat_completion`	Create chat completions using OpenAI models
`openai_create_response`	Create responses using the Responses API
`openai_generate_image`	Generate images from text descriptions
`openai_edit_image`	Edit existing images with AI
`openai_create_embedding`	Create text embedding vectors
`openai_text_to_speech`	Convert text to spoken audio
`openai_transcribe_audio`	Transcribe audio from a URL
`openai_list_chat_models`	List available chat/completion models
`openai_list_image_models`	List available image models
`openai_list_embedding_models`	List available embedding models
`openai_get_usage_guide`	Get comprehensive usage guide

Supported Models

Chat Completion Models

GPT-5 Series: gpt-5.5, gpt-5.5-pro, gpt-5.4, gpt-5.4-pro, gpt-5.2, gpt-5.1, gpt-5, gpt-5-mini, gpt-5-nano
GPT-4 Series: gpt-4.1, gpt-4.1-mini, gpt-4.1-nano, gpt-4o, gpt-4o-mini, gpt-4
Reasoning: o4-mini, o3, o3-mini, o3-pro, o1, o1-mini, o1-pro

Image Models

gpt-image-1, gpt-image-1.5, gpt-image-2, gpt-image-2:official, gpt-image-2.5-flare, gpt-image-2.5-flare:official, gpt-image-2.5-sunburst, gpt-image-2.5-sunburst:official, dall-e-3, dall-e-2, nano-banana, nano-banana-2, nano-banana-pro
GPT Image :official variants settle from actual text-input, image-input, and image-output tokens.

Embedding Models

text-embedding-3-small, text-embedding-3-large, text-embedding-ada-002

Audio Transcription Models

whisper-1, gpt-transcribe

Usage Examples

Chat Completion

openai_chat_completion(
    messages=[{"role": "user", "content": "Explain quantum computing in simple terms"}],
    model="gpt-4.1"
)

Image Generation

openai_generate_image(
    prompt="A serene Japanese garden with cherry blossoms at sunset, photorealistic",
    model="gpt-image-1",
    size="1024x1024"
)

Text Embeddings

openai_create_embedding(
    input="The quick brown fox jumps over the lazy dog",
    model="text-embedding-3-small"
)

Configuration

Variable	Description	Default
`ACEDATACLOUD_API_TOKEN`	API token (required)	—
`ACEDATACLOUD_API_BASE_URL`	API base URL	`https://api.acedata.cloud`
`OPENAI_REQUEST_TIMEOUT`	Request timeout in seconds	`60`
`MCP_SERVER_NAME`	MCP server name	`openai`
`LOG_LEVEL`	Logging level	`INFO`

Development

# Install dependencies
pip install -e ".[dev,test]"

# Run tests
pytest

# Run linter
ruff check .

API Reference

Documentation

License

MIT