Metadata-Version: 2.4
Name: ubos-janus-mcp
Version: 0.1.0
Summary: Janus — the UBOS Kin Drive concierge. An MCP server that lets your coding agent ask about, price, check, and request a private Kin 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-kindrive
Author: UBOS Republic
License: MIT
License-File: LICENSE
Keywords: claude-code,codex,coding-agent,gemini-cli,kin-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
Description-Content-Type: text/markdown

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

# Janus — UBOS Kin Drive concierge (MCP server)

Talk to **Janus**, the UBOS concierge, right inside your coding agent. Ask about, price, check, and request a **private Kin Drive** — a *deterministic* memory engine that gives your agent ~17ms recall over your own private codebase, with **no LLM in the retrieval path, so it cannot hallucinate**. Each drive runs isolated on its own box; your data never leaves it.

Works with **Claude Code, Codex, Gemini CLI, Cline, Cursor** — anything that speaks MCP.

## Install

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

### Register with Claude Code
```bash
claude mcp add janus -e JANUS_URL=https://api.welcome-to-ubos.com -- ubos-janus-mcp
```

### Codex (`~/.codex/config.toml`)
```toml
[mcp_servers.janus]
command = "ubos-janus-mcp"
env = { JANUS_URL = "https://api.welcome-to-ubos.com" }
```

### Gemini CLI (`settings.json`)
```json
{ "mcpServers": { "janus": { "command": "ubos-janus-mcp", "env": { "JANUS_URL": "https://api.welcome-to-ubos.com" } } } }
```

## Tools

| Tool | What it does |
|------|--------------|
| `janus_ask` | Ask Janus anything about getting/using a Kin Drive (grounded + live). |
| `kindrive_pricing` | Current price (live source of truth). |
| `kindrive_status` | Is a drive up and running? |
| `kindrive_provision` | Request a private Kin 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.

— UBOS Republic · constitutional infrastructure for AI agents · <https://welcome-to-ubos.com>
