# @tanstratum/mcpcli

**MCP (Model Context Protocol) codebase tools for AI agents** — same full CLI as [`zephex`](https://www.npmjs.com/package/zephex).

Install this package OR `zephex` — **both give you `mcpcli` and `zephex` commands** (same binary, all 10 MCP tools).

## Install once (pick either package)

```bash
npm install -g @tanstratum/mcpcli
# or
npm install -g zephex
```

**Both commands work after one install:**

```bash
mcpcli setup
zephex setup

mcpcli get-context
zephex get-context

mcpcli find-code "auth middleware"
zephex find-code "auth middleware"
```

Without global install:

```bash
npx @tanstratum/mcpcli setup
npx zephex get-context
```

## All 10 MCP tools

| MCP tool | Terminal (either command) |
|----------|---------------------------|
| `get_project_context` | `mcpcli get-context` · `zephex get-context` |
| `scope_task` | `mcpcli scope-task "…"` · `zephex scope-task "…"` |
| `read_code` | `mcpcli read-code …` · `zephex read-code …` |
| `find_code` | `mcpcli find-code "…"` · `zephex find-code "…"` |
| `explain_architecture` | `mcpcli architecture` · `zephex architecture` |
| `Zephex_dev_info` | `mcpcli docs` · `zephex docs` |
| `check_package` | `mcpcli check-package express` · `zephex check-package express` |
| `loop_guard` | `mcpcli loop-guard …` · `zephex loop-guard …` |
| `keep_thinking` | `mcpcli think` · `zephex think` |
| `audit_headers` | editor MCP only (after `mcpcli setup` or `zephex setup`) |

## Two npm packages, same engine

| npm package | Global commands after install |
|-------------|------------------------------|
| **`zephex`** | `zephex`, `mcpcli`, `zepx`, `zphx`, `mcpz`, `zepcli`, `zephx` |
| **`@tanstratum/mcpcli`** | `zephex`, `mcpcli` |

Same `cli.js`, same `tools/server.js`, same version. Use whichever name you prefer.

## How MCP works

1. **Terminal** — `mcpcli …` or `zephex …` → human-readable tool output.
2. **Editor MCP** — editor spawns the binary with piped stdin → `tools/server.js` stdio server (`tools/list`, `tools/call`).

## Account — connect, disconnect, reconnect (22+ editors)

Login: **https://zephex.dev/cli/auth** (not docs).

```bash
mcpcli init
mcpcli connect --cursor
mcpcli connect --claude-code
mcpcli disconnect --vscode
mcpcli reconnect --zed
mcpcli logout --all
mcpcli update --apply
mcpcli list
```

`mcpcli connect --help` · `mcpcli disconnect --help` · `mcpcli reconnect --help`

## Docs

- [CLI init](https://zephex.dev/docs/cli-init) · [CLI account](https://zephex.dev/docs/cli-account)
- [zephex.dev/docs/cli-terminal](https://zephex.dev/docs/cli-terminal)
- [zephex.dev](https://zephex.dev)
- **DOWNLOAD.md** in this npm package (install reference)