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 chat completions.

This repository is a thin, open client-facing wrapper: connection docs, a ready-to-use config and a comparison prompt example. The server itself is a hosted service — no source code to run locally, nothing to install beyond your MCP client.

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 capability (vision / reasoning / tools / web_search / audio_in / audio_out / image_gen / transcription), price, context length.
`models_get_pricing`	Pricing for a specific model, in rubles.
`balance_get`	Current account balance.
`chat_complete`	LLM chat request — full parity with `POST /v1/chat/completions`.

Resources

URI	Content
`hubris://catalog/models`	Full model catalog as a single JSON document.
`hubris://docs/quickstart`	Quickstart page.

Prompts

compare-models {task} — ready-made prompt for comparing models for a given task.

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

hubris mcp