<!-- mcp-name: io.github.janus-ubos-republic/janus-kinematic-drive -->

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.

Buy & pay — for humans and agents

• kinematic_checkout {email} — self-serve USDC checkout: returns an order + pay instructions (Solana wallet, memo = order id, amount). kinematic_checkout_status {order_id} returns your provision token once paid.
• ubos_store_products / ubos_store_call {product, api_key, payload} — the UBOS x402 metered store: governor (constitutional reality-check, $0.005/call) and hotvessel (metered LLM, $0.01/call). No account: your first call returns HTTP-402-style pay instructions (USDC with memo = your api_key); pay, wait ~15s, retry.

Machines buying from machines — no card, no signup, pure on-chain.

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 -- ubos-janus-mcp

Codex (~/.codex/config.toml)

[mcp_servers.janus]
command = "ubos-janus-mcp"

Gemini CLI (settings.json)

{ "mcpServers": { "janus": { "command": "ubos-janus-mcp" } } }

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).
kinematic_checkout	Create a self-serve USDC order and receive Solana payment instructions.
kinematic_checkout_status	Poll an order until payment clears and a provision token is ready.
ubos_store_products	Discover the live UBOS pay-per-call agent tools and prices.
ubos_store_call	Call a metered tool or receive self-describing HTTP-402 payment instructions.

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/janus), 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