Janus — UBOS Kinematic Drive concierge (MCP server)
Talk to Janus, the UBOS concierge, right inside your coding agent — to get a private Kinematic Drive: a deterministic memory engine that gives your agent sub-millisecond, exact recall over your own private code & docs, with no LLM in the retrieval path — so it cannot hallucinate. Each drive runs isolated on its own box; your data never leaves it.
⚡ Try the live test first — no install
Open https://welcome-to-ubos.com and type a symbol (ThreadPoolExecutor, urlencode, JSONDecoder). You'll watch the real engine find the exact source in ~1ms, deterministically — that's the engine your agent gets, pointed at your own repo.
Why it's different
- Deterministic — your files become typed "gear teeth"; a query meshes into them over exact candidates only. Same query → same result, every time. Zero hallucination.
- Private — one isolated drive per client, on its own box. Your data never touches a cloud LLM or any shared store.
- Fast — a read-only mmap index + a tiny native scorer.
| Metric | Value |
|---|---|
| Recall latency | ~1ms p50 (~1.7ms p95) |
| Accuracy | MRR@10 0.977 · hit@10 100% |
| Hallucinations | 0 — exact meshing only |
Install
pip install ubos-janus-mcp
Claude Code
claude mcp add janus -e JANUS_URL=https://api.welcome-to-ubos.com -- ubos-janus-mcp
Codex (~/.codex/config.toml)
[mcp_servers.janus]
command = "ubos-janus-mcp"
env = { JANUS_URL = "https://api.welcome-to-ubos.com" }
Gemini CLI (settings.json)
{ "mcpServers": { "janus": { "command": "ubos-janus-mcp", "env": { "JANUS_URL": "https://api.welcome-to-ubos.com" } } } }
Works with Claude Code, Codex, Gemini CLI, Cline, Cursor — anything that speaks MCP.
Tools
| Tool | What it does |
|---|---|
janus_ask | Ask Janus anything about getting/using a Kinematic Drive (grounded + live). |
kinematic_pricing | Current price (live source of truth). |
kinematic_status | Is a drive up and running? |
kinematic_provision | Request a private Kinematic Drive (managed onboarding). |
How it works
This MCP server is a thin client: it proxies your agent's calls to the Janus concierge at JANUS_URL (default https://api.welcome-to-ubos.com), which answers grounded on a live knowledge drive — the product, fronting the product. Your private data is never sent here; this is the storefront. Once you have a drive, you connect to it with the separate colony-gear MCP server.
Links
- Live page + test: https://welcome-to-ubos.com
- PyPI: https://pypi.org/project/ubos-janus-mcp/
- Source: https://github.com/janus-ubos-republic/janus-kinematic-drive
— UBOS Republic · constitutional infrastructure for AI agents