About OpenMayhem
OpenMayhem is a bridge for MCP clients to access the hosted service’s live catalog and model operations. It supports explicit cost limits for paid executions while keeping billing on the OpenMayhem service.
Key features
- 01Live model catalog and capability lookup
- 02Request estimates and token counts
- 03Balance checks and job management
- 04Owned-artifact lookup
- 05Explicit maximum cost for paid runs
Use cases
- 01Check available models and their limits
- 02Estimate a request before running it
- 03Track or cancel model jobs
- 04Run models with a set cost ceiling
MCP support
The local stdio bridge forwards MCP messages to the hosted OpenMayhem service; clients can also connect to its Streamable HTTP endpoint. It exposes model discovery, estimates, balance checks, job operations, artifact lookup, and paid model execution.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mcp.openmayhem.ai/mcpclaude mcp add --transport http ai-openmayhem-openmayhem https://mcp.openmayhem.ai/mcp{"mcpServers":{"ai-openmayhem-openmayhem":{"type":"http","url":"https://mcp.openmayhem.ai/mcp"}}}Open in Cursor{"servers":{"ai-openmayhem-openmayhem":{"type":"http","url":"https://mcp.openmayhem.ai/mcp"}}}Open in VS Code{"mcpServers":{"ai-openmayhem-openmayhem":{"type":"http","url":"https://mcp.openmayhem.ai/mcp"}}}{"mcpServers":{"ai-openmayhem-openmayhem":{"serverUrl":"https://mcp.openmayhem.ai/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://mcp.openmayhem.ai/mcpAuth requiredTools
Details
From the project READMEOpenMayhem MCP
OpenMayhem's local stdio bridge forwards MCP messages to the hosted OpenMayhem service. It does not bundle a stale catalog: list_models and get_model read the live catalog, availability, capabilities, limits, routes, and prices from OpenMayhem. Account balance and payment logic remain on the hosted service, and the bridge contains no provider data or credentials.
Install
Download openmayhem-mcp-v1.0.0.mcpb from the v1.0.0 release and install it in an MCPB-compatible client. The client asks for a restricted OpenMayhem API key and stores it as a sensitive setting.
Clients that support remote Streamable HTTP can connect directly:
URL: https://mcp.openmayhem.ai/mcp
Header: X-OpenMayhem-API-Key: your restricted OpenMayhem API key
Create and revoke API keys at openmayhem.ai. Complete setup, tool, payment, and client instructions are at openmayhem.ai/docs/mcp.
Billing
Model discovery, request estimation, token counting, balance checks, job reads, cancellation, and owned-artifact lookup do not spend model credit. Model execution is paid. Every paid tool requires a current estimate and an explicit maximum cost.
The bridge does not calculate charges or handle payment information. Requests use the existing OpenMayhem account, balance, reservation, receipt, and settlement paths.
Requirements
- Node.js 22 or newer
- A restricted OpenMayhem API key
- HTTPS access to
mcp.openmayhem.ai
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.