Metadata-Version: 2.5
Name: parapetai-mcp
Version: 0.1.2
Summary: MCP server for Claude Code (and other MCP clients): device-code login to a Parapet control plane, provisioning agents, and pulling the exact quickstart config a codebase needs -- ships with a packaged SKILL.md.
Author: Parapet
License-Expression: MIT
License-File: LICENSE
Keywords: agent,cedar,claude-code,governance,mcp
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: httpx<1.0,>=0.28
Requires-Dist: mcp<2.0,>=1.24
Provides-Extra: dev
Requires-Dist: mypy; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest>=8.3; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Description-Content-Type: text/markdown

# parapetai-mcp

MCP server for Claude Code (and other MCP clients) that talks to a Parapet
control plane: device-code login in your browser, then provision governed
agents and pull the exact quickstart config a codebase needs — without
hand-editing env vars.

```
pipx install parapetai-mcp
parapetai-mcp init         # installs SKILL.md into .claude/skills/parapet/
claude mcp add parapet -e PARAPETAI_CONTROL_PLANE_URL=https://app.parapet.run -- parapetai-mcp serve
```

`pipx`, not `pip` — this is a CLI tool (a `[project.scripts]` entry point), not a
library anything imports, and most Python installs on macOS/Linux now ship as
PEP 668 "externally managed" (Homebrew's Python does), which makes a bare
`pip install parapetai-mcp` fail rather than risk corrupting packages the
system relies on. `pipx` installs CLI tools into their own isolated venv and
puts the entry point on `PATH` — no venv to activate, no `--break-system-packages`
flag needed. No `pipx` available? `python3 -m pip install --user pipx &&
pipx ensurepath` (or `brew install pipx` on macOS), then re-run the command
above. `uv tool install parapetai-mcp` is an equivalent one-liner if `uv` is
already on the machine.

Then in Claude Code: "add Parapet to this project."

## Tools

| Tool | What it does |
|---|---|
| `parapet_login` | Device-code login — open the printed URL, approve in your browser |
| `parapet_whoami` | Who you're authenticated as, and which agents already exist |
| `parapet_provision_agent` | Provision a new governed agent (`agent_id` + one-time `secret`) |
| `parapet_get_quickstart` | The install command / env var names this deployment expects |
| `parapet_list_agents` | Read-only agent listing |

This server never edits your project's files — it only talks to the
control plane. The packaged `SKILL.md` tells Claude Code how to use these
tools and where to write the resulting config.

Point at a different control plane (e.g. a local `make dev` instance) with
`PARAPETAI_CONTROL_PLANE_URL` (default `https://app.parapet.run`, the hosted
control plane).
