Hubris
OpenAI-compatible LLM gateway for Russia: 500+ models, ruble pricing, balance, chat.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http hubris 'https://api.hubris.pw/mcp'{
"mcpServers": {
"hubris": {
"type": "http",
"url": "https://api.hubris.pw/mcp"
}
}
}hubris-mcpclaude mcp add hubris -e 'HUBRIS_API_KEY=<your hubris_api_key>' -- npx -y hubris-mcp@0.1.1{
"mcpServers": {
"hubris": {
"command": "npx",
"args": [
"-y",
"hubris-mcp@0.1.1"
],
"env": {
"HUBRIS_API_KEY": "<your hubris_api_key>"
}
}
}
}Environment variables
HUBRIS_API_KEYrequired secret API key from https://hubris.pw/keys
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Hubris MCP
Model Context Protocol server for Hubris — an OpenAI-compatible LLM gateway with billing in rubles. Connect Claude Desktop, Claude Code, Cline, Cursor or any other MCP client to a single hosted server and get access to the model catalog, account balance and spending, and every kind of model in it: text, embeddings, rerankers, decision models, images, speech, transcription, video and YouTube transcripts.
There are two ways in: connect your client straight to the hosted endpoint, or run the stdio server in this repository, which declares the same tools locally and forwards calls to that endpoint. The second is what you want for clients that speak stdio only, and for sandboxes that build from a Dockerfile.
Listing the tools needs no credential; only calling one does. With HUBRIS_API_KEY set, the stdio server takes the tool list live from the hosted endpoint, so it never lags behind new tools; without a key it serves the list bundled with the package.
- Endpoint:
https://api.hubris.pw/mcp - Transport: Streamable HTTP
- Auth: Bearer API key (
sk-gw-..., create one at hubris.pw/keys) - Full docs: hubris.pw/docs/integrations/mcp
Tools
| Tool | Description |
|---|---|
models_list | Full catalog of active models, cursor-paginated. |
models_search | Filter by the tool that runs the model (tool), capability, price, context length. |
models_get_pricing | Pricing for a specific model, in rubles; voices for speech models, durations and resolutions for video models. |
balance_get | Current account balance. |
usage_get | Spending over a period: requests, tokens, rubles. |
chat_complete | LLM chat request — same as POST /v1/chat/completions. |
embeddings_create | Embedding vectors — POST /v1/embeddings. |
rerank | Order documents by relevance to a query — POST /v1/rerank. |
decisions_ask | Yes/no, choice and scale answers with probabilities — POST /v1/decisions. |
image_generate | Draw an image, returned as image content — POST /v1/images/generations. |
speech_create | Text to speech, returned as audio content — POST /v1/audio/speech. |
transcription_create | Speech to text from base64 audio — POST /v1/audio/transcriptions. |
video_create | Start a video generation — POST /v1/videos. |
video_get | Status of a video task; download links once it is ready — GET /v1/videos/{id}. |
youtube_transcribe | Transcript or summary of a YouTube video — POST /v1/video/transcriptions. |
Resources
| URI | Content |
|---|---|
hubris://catalog/models | Full model catalog as a single JSON document. |
hubris://docs/quickstart | Quickstart page. |
hubris://videos/{id}/content | A finished video, linked from video_get (hosted endpoint only). |
Prompts
compare-models {task}— ready-made prompt for comparing models for a given task.
Run locally (stdio)
npm install && npm run build
HUBRIS_API_KEY=sk-gw-... node dist/index.jsOr with Docker:
docker build -t hubris-mcp .
docker run -i --rm -e HUBRIS_API_KEY=sk-gw-... hubris-mcpIn an MCP client config:
{
"mcpServers": {
"hubris": {
"command": "node",
"args": ["/path/to/hubris-mcp/dist/index.js"],
"env": { "HUBRIS_API_KEY": "sk-gw-..." }
}
}
}HUBRIS_MCP_URL overrides the endpoint if you need to point it elsewhere.
Connect
Claude Code
claude mcp add --transport http hubris https://api.hubris.pw/mcp \
--header "Authorization: Bearer sk-gw-..."Claude Desktop
Claude Desktop only speaks stdio, so remote HTTP servers go through the mcp-remote shim. Add to claude_desktop_config.json:
{
"mcpServers": {
"hubris": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.hubris.pw/mcp",
"--transport",
"http-only",
"--header",
"Authorization:${AUTH_TOKEN}"
],
"env": {
"AUTH_TOKEN": "Bearer sk-gw-..."
}
}
}
}Cline / Cursor / other clients
Any MCP client with Streamable HTTP transport support:
| Field | Value |
|---|---|
| Transport | Streamable HTTP |
| URL | https://api.hubris.pw/mcp |
| Auth header | Authorization: Bearer sk-gw-... |
Full connection guide (with client-specific caveats): hubris.pw/docs/integrations/mcp.
Security
The Bearer key grants access to your account balance. We recommend creating a dedicated key for MCP at hubris.pw/keys so it can be revoked independently of other integrations.
About Hubris
Hubris is an OpenAI-compatible LLM gateway for the Russian market — one API key, one ruble-denominated balance, 400+ models. hubris.pw
Frequently asked questions
What is Hubris?
OpenAI-compatible LLM gateway for Russia: 500+ models, ruble pricing, balance, chat.
How do I install Hubris?
It runs as a remote server. In Claude Code: claude mcp add --transport http hubris 'https://api.hubris.pw/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Hubris need an API key?
Yes. It expects HUBRIS_API_KEY, which you set in its configuration.
Is Hubris open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Hubris?
It is published by Aimagine-life. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.