Hubris

Hubris는 루블로 청구되는 OpenAI 호환 LLM 게이트웨이로, OpenAI, Anthropic, Google, DeepSeek, Qwen 및 기타 업체의 500개 이상 모델에 대한 API 키 하나로 접근할 수 있습니다. 원격 MCP 서버를 통해 에이전트가 모델 카탈로그를 검색하고, 가격을 비교하고, 계정 잔액을 확인하고, 모든 모델에서 채팅 완성을 실행할 수 있습니다.

GitHub이 MCP 사용해 보기스폰서

호스팅형 MCP 서버

npx add-mcp 'https://api.hubris.pw/mcp'

Claude Code, Codex, Cursor 등에 설치됩니다

문서

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.

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.

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.

Run locally (stdio)

npm install && npm run build
HUBRIS_API_KEY=sk-gw-... node dist/index.js

Or with Docker:

docker build -t hubris-mcp .
docker run -i --rm -e HUBRIS_API_KEY=sk-gw-... hubris-mcp

In 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