EmpirioLabs AI MCP server
Remote Model Context Protocol server for EmpirioLabs AI. Run 180+ AI models, image, video and speech generation, web search, batch jobs, GPU Cloud and hosted agents as tools with your EmpirioLabs account. It is a remote server, so there is nothing to install.
| Server URL | https://mcp.empiriolabs.ai/mcp (Streamable HTTP) |
| Authentication | OAuth 2.1 (sign in with your EmpirioLabs account) or an EmpirioLabs API key as a bearer token |
| Registry name | ai.empiriolabs/mcp in the official MCP Registry, version 1.2.0 |
| Documentation | https://docs.empiriolabs.ai/mcp |
| Support | [email protected] |
Every model and feature EmpirioLabs adds is available here as it launches, at the same final prices and limits as the API. Connections use your prepaid credits, and you can disconnect any app under Settings in the dashboard.
Connect
Claude (web, desktop, mobile)
- Open Settings, then Connectors, and choose Add custom connector.
- Enter
https://mcp.empiriolabs.ai/mcpas the URL. Leave the OAuth client fields empty. - Click Connect, sign in to EmpirioLabs, review the request, and choose Allow access.
Claude Code:
claude mcp add --transport http empiriolabs https://mcp.empiriolabs.ai/mcp
Run /mcp inside Claude Code to complete the sign-in the first time. The repository is also a Claude Code plugin (.claude-plugin/plugin.json), so it can be installed from a plugin marketplace.
ChatGPT
- Open Settings, then Plugins, and turn on Developer mode.
- Choose Create app, enter
https://mcp.empiriolabs.ai/mcpas the server URL with OAuth authentication, and create it. - Finish the sign-in and choose Allow access. The server also provides the
searchandfetchtools ChatGPT uses for connectors, so it works in chat and in deep research.
Cursor, VS Code, Windsurf, Cline and other editors
Remote servers are configured with a URL. Sign in through OAuth when the editor prompts, or add an API key header:
{
"mcpServers": {
"empiriolabs": {
"url": "https://mcp.empiriolabs.ai/mcp",
"headers": {
"Authorization": "Bearer sk-empiriolabs-your_key_here"
}
}
}
}
VS Code reads the same shape from .vscode/mcp.json with a servers key and "type": "http". Codex CLI: codex mcp add empiriolabs --url https://mcp.empiriolabs.ai/mcp. Gemini CLI and Windsurf accept the JSON block above in their MCP settings. Cline: see llms-install.md.
Any HTTP client
The server speaks JSON-RPC over POST https://mcp.empiriolabs.ai/mcp. Send Authorization: Bearer <API key or OAuth access token> and Accept: application/json, text/event-stream on every request.
curl "https://mcp.empiriolabs.ai/mcp" \
-H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
-H "Accept: application/json, text/event-stream" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_models","arguments":{"modality":"image","limit":5}}}'
Tools
78 tools in 10 toolsets. The complete reference with every parameter is on the documentation page.
| Toolset | What it covers |
|---|---|
| Models | Browse the model catalog, prices, capabilities, and parameters |
| Text | Run chat, embeddings, reranking, and AI text detection (uses credits) |
| Search | Run web search, grounded answers, and research (uses credits) |
| Media | Generate and edit images, video, audio, speech, transcription, and 3D (uses credits) |
| Jobs | Check, wait for, and cancel generation jobs |
| Agents | Run and manage agent tasks (uses credits) |
| Account | Read usage history and the current balance |
| Batch | Upload batch files and manage batch jobs (uses credits) |
| GPU Cloud | Deploy and manage GPU instances, clusters, and volumes (billable) |
| Hosted Agents | Create and manage hosted agents (billable) |
Profiles
Profiles expose a subset of toolsets at a shorter URL:
| URL | Toolsets |
|---|---|
https://mcp.empiriolabs.ai/mcp |
all |
https://mcp.empiriolabs.ai/mcp/inference |
models, text, search, jobs, account |
https://mcp.empiriolabs.ai/mcp/media |
models, media, jobs, account |
https://mcp.empiriolabs.ai/mcp/cloud |
models, account, gpu, hosted_agents |
https://mcp.empiriolabs.ai/mcp/no-media |
models, text, search, jobs, agents, account, batch, gpu, hosted_agents |
Combine toolsets with +, for example https://mcp.empiriolabs.ai/mcp/models+text+jobs.
Prompts
Ready-made requests that chain several tools; clients that support MCP prompts list them next to the tools.
| Prompt | What it does | Arguments |
|---|---|---|
choose_model |
Compare EmpirioLabs models for a task and recommend one, with a cheaper fallback and final prices. | task, modality (optional), priority (optional) |
research_with_citations |
Answer a question from live web research and cite every source. | question, depth (optional) |
generate_media |
Create an image, video, audio track or 3D asset from a description and return the finished files. | description, kind (optional), model (optional) |
deploy_gpu_workload |
Rent a GPU on EmpirioLabs GPU Cloud, start a workload on it and report the endpoints and hourly cost. | workload, gpu (optional), max_hourly_price (optional) |
spend_report |
Summarise the account balance, recent usage and everything that is still running and billing. | period (optional) |
Access and privacy
- Read-only tools (catalog, jobs, usage) use no credits. Tools that run models, searches, agent tasks, batches or infrastructure use the prepaid credits of the connected account.
- OAuth connections are listed under Settings > Connected applications in the dashboard, where Disconnect ends access right away.
- Privacy policy and terms of service.
About this repository
This repository holds the public listing material for the hosted server: the registry server.json, the LobeHub and Claude plugin manifests, the icons, and the install notes. Every file that describes the tool surface is generated from the server's own definition, so it always matches what https://mcp.empiriolabs.ai/mcp serves. The server itself is operated by EmpirioLabs.ai LLC.