OpenAI Agents MCP Server

A Model Context Protocol (MCP) server that exposes OpenAI agents through the MCP protocol.

Features

This server exposes both individual agents and a multi-agent orchestrator using the OpenAI Agents SDK:

Individual Specialized Agents

Web Search Agent: A specialized agent for searching the web for real-time information
File Search Agent: A specialized agent for searching and analyzing files in OpenAI's vector store
Computer Action Agent: A specialized agent for performing actions on your computer safely

Multi-Agent Orchestrator

Orchestrator Agent: A powerful agent that can coordinate between the specialized agents, choosing the right one(s) for each task

Each agent is accessed through the MCP protocol, making them available to any MCP client, including the Claude desktop app.

Installation

Prerequisites

Python 3.11 or higher
uv package manager (recommended)
OpenAI API key

Installing via Smithery

To install openai-agents-mcp-server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @lroolle/openai-agents-mcp-server --client claude

Claude Desktop

"mcpServers": {
  "openai-agents-mcp-server": {
    "command": "uvx",
    "args": ["openai-agents-mcp-server"],
    "env": {
        "OPENAI_API_KEY": "your-api-key-here"
    }
  }
}

Implementation Details

Tool Requirements

WebSearchTool: No required parameters, but can accept optional location context
FileSearchTool: Requires vector_store_ids (IDs from your OpenAI vector stores)
ComputerTool: Requires an AsyncComputer implementation (currently simulated)

Customization

You can customize this server by:

Implementing a full AsyncComputer interface to enable real computer interactions
Adding additional specialized agents for other OpenAI tools
Enhancing the orchestrator agent to handle more complex workflows

Configuration

You can configure the server using environment variables:

OPENAI_API_KEY: Your OpenAI API key (required)
MCP_TRANSPORT: Transport protocol to use (default: "stdio", can be "sse")

Development

Setup development environment

# Clone the repository
git clone https://github.com/lroolle/openai-agents-mcp-server.git
cd openai-agents-mcp-server

# Create a virtual environment
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
uv sync --dev

Testing with MCP Inspector

You can test the server using the MCP Inspector:

# In one terminal, run the server with SSE transport
export OPENAI_API_KEY=your-api-key
export MCP_TRANSPORT=sse

uv run mcp dev src/agents_mcp_server/server.py

Then open a web browser and navigate to http://localhost:5173.

License

MIT

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A Model Context Protocol server that enables Claude users to access specialized OpenAI agents (web search, file search, computer actions) and a multi-agent orchestrator through the MCP protocol.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP OpenAI Server
mzxrai
-
security
A
license
-
quality
A Model Context Protocol (MCP) server that lets you seamlessly use OpenAI's models right from Claude.
Last updated -
1
24
28
JavaScript
MIT License
MCP Simple OpenAI Assistant
andybrandt
-
security
A
license
-
quality
A simple MCP server for interacting with OpenAI assistants. This server allows other tools (like Claude Desktop) to create and interact with OpenAI assistants through the Model Context Protocol.
Last updated -
31
Python
MIT License
Open-Ledger-MCP-Serverofficial
openledger
-
security
A
license
-
quality
A Model Context Protocol (MCP) server implementation for the OpenLedger API. This server provides structured context to AI models according to the MCP specification.
Last updated -
8
TypeScript
Apache 2.0
OpenAI MCP Server
arthurcolle
-
security
F
license
-
quality
A Model Context Protocol server implementation that enables connection between OpenAI APIs and MCP clients for coding assistance with features like CLI interaction, web API integration, and tool-based architecture.
Last updated -
28
Python

View all related MCP servers

OpenAI Agents MCP Server