UberLLM MCP server
Commit Nov 13, 2026Access a marketplace of AI models for chat, image, video, music, and speech through a single OpenAI- or Anthropic-compatible API.
Also known as PSA-Team-source/uberllm
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Nov 13, 2026
- License
- MIT
What is UberLLM MCP?
UberLLM accesses a marketplace of AI models for chat, image, video, music, and speech through a single OpenAI- or Anthropic-compatible API.
Summary generated from the project's README
About UberLLM MCP server
UberLLM provides a unified API marketplace that grants access to a wide variety of AI models, including chat, image, video, music, and speech. Developers can interact with these diverse models through a single interface that is compatible with both OpenAI and Anthropic protocols. This setup allows you to use one API key to reach multiple third-party inference providers, with costs reflecting the original provider's pricing and no additional service fees on requests.
The service operates as a hosted MCP server, meaning there is no local infrastructure to maintain. It is designed for integration into coding agents and IDEs such as Claude Code, Codex, Gemini CLI, Cursor, and Cline. Users can manage their access via a prepaid account system where requests are only billed if they succeed. The server provides specific tools like list_models, generate_image, and start_video to facilitate complex multimodal workflows directly through your preferred AI client.
What you can do with it
- 1Access multimodal model catalogsA developer can query the available models and their current pricing to select the right tool for a task.
- 2Integrate with existing AI SDKsDevelopers can swap their standard OpenAI or Anthropic clients for UberLLM by changing the base URL.
Written from the project's README. Every use case is checked against a quote from it.
How to install UberLLM MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall UberLLM MCP in Claude Code
$ claude mcp add --transport http uberllm https://api.uberllm.dev/mcpInstall UberLLM MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"uberllm": {
"url": "https://api.uberllm.dev/mcp"
}
}
}Install UberLLM MCP in VS Code
.vscode/mcp.json
{
"servers": {
"uberllm": {
"type": "http",
"url": "https://api.uberllm.dev/mcp"
}
}
}Install UberLLM MCP in VS Code CLI
$ code --add-mcp '{"name":"uberllm","type":"http","url":"https://api.uberllm.dev/mcp"}'Install UberLLM MCP in Codex
$ codex mcp add uberllm --url https://api.uberllm.dev/mcpInstall UberLLM MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.uberllm] url = "https://api.uberllm.dev/mcp"
Install UberLLM MCP in Gemini CLI
$ gemini mcp add -s user --transport http uberllm https://api.uberllm.dev/mcpInstall UberLLM MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"uberllm": {
"url": "https://api.uberllm.dev/mcp",
"type": "http"
}
}
}Configuration
ANTHROPIC_BASE_URLCLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERYUBERLLM_API_KEYUBERLLM_AUTH
| Name | Description | |
|---|---|---|
| ANTHROPIC_BASE_URL | — | |
| CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY | — | |
| UBERLLM_API_KEY | — | |
| UBERLLM_AUTH | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablepsa-team-source/uberllm is public and reachablegithub.com/psa-team-source/uberllm ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-13github.com/psa-team-source/uberllm ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 151 msPass
README
View on GitHubUberLLM
UberLLM is an API marketplace for AI models: chat, image, video, music and speech. You call one OpenAI- and Anthropic-compatible API with one key. Each request is served by a third-party inference provider for that model, and costs what that provider charged for it.
- No UberLLM fee on requests. Adding credit by card costs 5.5% + $0.50.
- Prepaid. Accounts start at $0; a request that fails is not billed.
- Base URL:
https://api.uberllm.dev/v1(OpenAI) orhttps://api.uberllm.dev(Anthropic). - Models and live prices: https://uberllm.dev/models
- Docs: https://uberllm.dev/docs
This repository holds the public tooling: plugins for Claude Code and Codex, a
Gemini CLI extension,
the uberllm agent skill, the Claude Code installer with its checksums, and
copy-paste setup for SDKs and MCP clients.
Get a key
Sign in at https://uberllm.dev with your email (a code is sent, no password),
add credit, and create a key in Dashboard → Keys. Keys start with ull_.
Install in your coding agent
This repository is a Claude Code plugin, a Codex plugin, a Gemini CLI extension
and an Agent Skill.
Each one adds UberLLM's hosted MCP server (https://api.uberllm.dev/mcp,
Streamable HTTP) and/or the uberllm skill, which knows how to set UberLLM up,
pick a model and make images and videos. Nothing to build or run locally: the
server is hosted, and it authenticates with your key as
Authorization: Bearer ull_....
MCP tools: list_models, get_model, quote, generate_image, edit_image,
start_video, get_job, wait_job, balance. A tool call is billed exactly
like the same API request. Full reference: https://uberllm.dev/docs/mcp
Claude Code plugin (MCP server + skill). Inside Claude Code:
/plugin marketplace add PSA-Team-source/uberllm
/plugin install uberllm@uberllm
Claude Code asks for your API key when the plugin is enabled and keeps it in
your system's credential store. Set or change it later with
claude plugin configure uberllm.
Codex plugin (MCP server + skill):
codex plugin marketplace add PSA-Team-source/uberllm
codex plugin add uberllm@uberllm
export UBERLLM_API_KEY=ull_... # the MCP server reads the key from here
Gemini CLI extension (MCP server + skill):
gemini extensions install https://github.com/PSA-Team-source/uberllm
Gemini CLI asks for your API key on install and keeps it in your system
keychain (change it with gemini extensions config uberllm). If you skip it,
export UBERLLM_API_KEY=ull_... before starting gemini works too.
Skill only (Claude Code, Codex, Cursor, OpenCode and other agents that read Agent Skills), via skills.sh:
npx skills add PSA-Team-source/uberllm
MCP server only, Claude Code:
claude mcp add --transport http uberllm https://api.uberllm.dev/mcp --header "Authorization: Bearer ull_..."
Cursor (~/.cursor/mcp.json) and other clients that take a URL:
{
"mcpServers": {
"uberllm": {
"url": "https://api.uberllm.dev/mcp",
"headers": { "Authorization": "Bearer ull_..." }
}
}
}
Cline (MCP Servers → Configure MCP Servers, which opens
cline_mcp_settings.json). Set "type": "streamableHttp": without a type,
Cline connects over SSE and the server does not answer that way. Step-by-step
instructions for Cline and other agents: llms-install.md.
{
"mcpServers": {
"uberllm": {
"type": "streamableHttp",
"url": "https://api.uberllm.dev/mcp",
"headers": { "Authorization": "Bearer ull_..." },
"disabled": false
}
}
}
VS Code (.vscode/mcp.json; VS Code asks for the key once and stores it):
{
"inputs": [
{ "type": "promptString", "id": "uberllm-key", "description": "UberLLM API key (ull_...)", "password": true }
],
"servers": {
"uberllm": {
"type": "http",
"url": "https://api.uberllm.dev/mcp",
"headers": { "Authorization": "Bearer ${input:uberllm-key}" }
}
}
}
Claude Desktop (Settings → Developer → Edit Config), through
mcp-remote:
{
"mcpServers": {
"uberllm": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.uberllm.dev/mcp", "--header", "Authorization:${UBERLLM_AUTH}"],
"env": { "UBERLLM_AUTH": "Bearer ull_..." }
}
}
}
The server is listed in the official MCP Registry
as dev.uberllm/mcp (server.json).
OpenAI SDK
from openai import OpenAI
client = OpenAI(base_url="https://api.uberllm.dev/v1", api_key="ull_...")
r = client.chat.completions.create(
model="deepseek/deepseek-v4-flash",
messages=[{"role": "user", "content": "Say hello in five words."}],
)
print(r.choices[0].message.content)
Anthropic SDK
from anthropic import Anthropic
client = Anthropic(base_url="https://api.uberllm.dev", api_key="ull_...")
m = client.messages.create(
model="anthropic/claude-haiku-4.5",
max_tokens=100,
messages=[{"role": "user", "content": "Say hello in five words."}],
)
print(m.content[0].text)
Any chat model in the catalog works on both APIs. Model ids are the ids on https://uberllm.dev/models.
Vercel AI SDK
import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
import { generateText } from "ai";
const uberllm = createOpenAICompatible({
name: "uberllm",
apiKey: process.env.UBERLLM_API_KEY,
baseURL: "https://api.uberllm.dev/v1",
includeUsage: true,
});
const { text } = await generateText({
model: uberllm("deepseek/deepseek-v4-flash"),
prompt: "Say hello in five words.",
});
Streaming, tool calls and images: https://uberllm.dev/docs/ai-sdk
Claude Code
By hand (3 steps)
-
Create a key in Dashboard → Keys.
-
Save it to a file only you can read:
mkdir -p ~/.uberllm && chmod 700 ~/.uberllm printf '%s\n' 'ull_your_key' > ~/.uberllm/key && chmod 600 ~/.uberllm/key -
Add this to
~/.claude/settings.json(every project) or<project>/.claude/settings.local.json(one project):{ "apiKeyHelper": "cat ~/.uberllm/key", "env": { "ANTHROPIC_BASE_URL": "https://api.uberllm.dev", "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1" } }
With the installer
install/claude-code.sh (macOS, Linux) and
install/claude-code.ps1 (Windows) are byte-for-byte
the files served at https://uberllm.dev/install/. They sign you in through
the browser, save the key to a mode-600 file, merge ANTHROPIC_BASE_URL and an
apiKeyHelper into your Claude Code settings (backing the file up first), and
make one test request. --uninstall reverts it.
Read it, check it, then run it:
curl -fsSL https://uberllm.dev/install/claude-code.sh -o claude-code.sh
shasum -a 256 claude-code.sh # compare with install/SHA256SUMS
less claude-code.sh
sh claude-code.sh # add --project for this project only
| File | SHA-256 |
|---|---|
claude-code.sh |
f5aa1c4610992d8f4ecc1b1cd777bc731c5fad9da6a38cac46989834b194d66c |
claude-code.ps1 |
60d631b48e60a2e3f17e5eee19136d47a255f143627986e86b6ceb379858a3b9 |
If the file you downloaded does not match the sum above, do not run it, and tell us at support@uberllm.dev.
Details: https://uberllm.dev/docs/claude-code
Support
support@uberllm.dev · Privacy · Terms
License
MIT
UberLLM MCP questions
How do I add UberLLM MCP to Claude Code?
Run claude mcp add --transport http uberllm https://api.uberllm.dev/mcp in your terminal. Add --scope user to make it available in every project.
How do I add UberLLM MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Is the service prepaid?
Yes, accounts are prepaid starting at $0, and you are not billed if a request fails.