OpenAI MCP Server
Provides tools to manage OpenAI API keys and spending through the OpenAI API
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@OpenAI MCP Server show my current API usage for this month"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
OpenAI MCP Server
A Model Context Protocol server that provides tools to manage OpenAI API keys & spending.
This server can access the OpenAI API and may represent a security risk. Exercise caution when using this MCP server to ensure this does not expose any sensitive data.
Available Tools
TODO: Add tool info here
Related MCP server: OpenAI MCP Server
Installation
Using uv (recommended)
When using uv no specific installation is needed. We will use uvx to directly run mcp-server-openai.
Using PIP
Alternatively you can install mcp-server-openai via pip:
pip install mcp-server-openaiAfter installation, you can run it as a script using:
python -m mcp_server_openaiConfiguration
Configure for Claude.app
Add to your Claude settings:
{
"mcpServers": {
"openai": {
"command": "uvx",
"args": ["mcp-server-openai"],
"env": {
"OPENAI_ADMIN_API_KEY": "your_openai_admin_api_key"
}
}
}
}{
"mcpServers": {
"openai": {
"command": "docker",
"args": ["run", "-i", "--rm", "mcp/openai"],
"env": {
"OPENAI_ADMIN_API_KEY": "your_openai_admin_api_key"
}
}
}
}{
"mcpServers": {
"openai": {
"command": "python",
"args": ["-m", "mcp_server_openai"],
"env": {
"OPENAI_ADMIN_API_KEY": "your_openai_admin_api_key"
}
}
}
}Debugging
You can use the MCP inspector to debug the server. For uvx installations:
npx @modelcontextprotocol/inspector uvx mcp-server-openaiOr if you've installed the package in a specific directory or are developing on it:
cd path/to/servers/src/openai
npx @modelcontextprotocol/inspector uv run mcp-server-openaiContributing
We encourage contributions to help expand and improve mcp-server-openai. Whether you want to add new tools, enhance existing functionality, or improve documentation, your input is valuable.
Pull requests are welcome! Feel free to contribute new ideas, bug fixes, or enhancements to make mcp-server-openai even more powerful and useful.
License
mcp-server-openai is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
Available Tools
2 toolsget_costsB
Fetches OpenAI costs for the specified period.
Inputs: start_time (required), end_time, group_by, project_ids. Returns: result
get_projectsB
Fetches OpenAI projects for the current organization.
Inputs: include_archived. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: get_costs retrieves financial data for a specified period, while get_projects fetches organizational project information. There is no overlap in functionality, making it easy for an agent to select the correct tool based on the task.
Both tools follow a consistent verb_noun pattern (get_costs and get_projects), using the same verb 'get' and snake_case formatting. This uniformity makes the tool set predictable and easy to understand.
With only two tools, the server feels thin and under-scoped for an OpenAI MCP server, which might be expected to handle more operations like managing models, generating completions, or listing usage. The limited count suggests incomplete coverage of the domain.
The tool set is severely incomplete for an OpenAI server, lacking core operations such as creating or managing projects, generating text or images, or accessing model details. This will likely cause agent failures when attempting common OpenAI-related tasks.
Maintenance
Related MCP Connectors
OpenAI organization usage and cost reporting through an admin API key connected by the user.
Run an OpenCheap LLM API account: model prices, spend-capped keys, budgets, usage and gateways.
Manage a ScaledThought account: API keys, budgets, usage and prepaid top-ups. Needs an API key.
Manage API keys, identities, permissions, rate-limit overrides and verification analytics.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides intelligent OpenAI API token management with automatic switching between model tiers when usage limits are reached. It enables users to track daily token consumption, estimate costs before making calls, and manage project-specific usage data.MIT
- AlicenseNot gradedqualityDmaintenanceProvides tools to interact with OpenAI API including chat completions, embeddings, content moderation, and file management through natural language.MIT
- AlicenseAqualityCmaintenanceExposes the OpenAI Admin API as MCP tools, enabling management of organization members, projects, service accounts, API keys, rate limits, usage, costs, and audit logs through natural language.31Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables read-only OpenAI organization usage and cost reporting via an admin API key, with tools to list connected billing accounts, retrieve normalized usage, and calculate costs for a date range.MIT