Metadata-Version: 2.4
Name: ubos-janus-mcp
Version: 0.1.3
Summary: Janus — the UBOS Kinematic Drive concierge. An MCP server that lets your coding agent ask about, price, check, and request a private Kinematic Drive (a deterministic memory engine for AI coding agents).
Project-URL: Homepage, https://welcome-to-ubos.com
Project-URL: Repository, https://github.com/janus-ubos-republic/janus-kinematic-drive
Author: UBOS Republic
License: MIT
License-File: LICENSE
Keywords: claude-code,codex,coding-agent,gemini-cli,kinematic-drive,mcp,memory,model-context-protocol,ubos
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Requires-Dist: certifi>=2024.2.2
Description-Content-Type: text/markdown

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

# Janus — UBOS Kinematic Drive concierge (MCP server)

[![PyPI](https://img.shields.io/pypi/v/ubos-janus-mcp.svg)](https://pypi.org/project/ubos-janus-mcp/)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE)
[![MCP Registry](https://img.shields.io/badge/MCP-Registry-7c4dff.svg)](https://registry.modelcontextprotocol.io)

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 (v0.1.3)

- `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

```bash
pip install ubos-janus-mcp
```

### Claude Code
```bash
claude mcp add janus -- ubos-janus-mcp
```

### Codex (`~/.codex/config.toml`)
```toml
[mcp_servers.janus]
command = "ubos-janus-mcp"

```

### Gemini CLI (`settings.json`)
```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
