copper-pilot-cli 0.1.4__tar.gz → 0.1.6__tar.gz

copper_pilot_cli-0.1.6/.claude-plugin/marketplace.json

@@ -0,0 +1,17 @@
+{
+  "name": "copper-pilot-cli",
+  "owner": {
+    "name": "CopperPilot"
+  },
+  "metadata": {
+    "description": "CopperPilot Claude Code plugin: delegate electronics design to the hosted agent.",
+    "version": "0.1.5"
+  },
+  "plugins": [
+    {
+      "name": "copper-pilot",
+      "source": "./plugins/copper-pilot",
+      "description": "MCP conductor plus @copper-pilot and /copper-pilot-review."
+    }
+  ]
+}

{copper_pilot_cli-0.1.4 → copper_pilot_cli-0.1.6}/CONTRIBUTING.md

@@ -63,7 +63,8 @@ Never commit `~/.copper-pilot/.state/auth.json`, API keys, or private boards.
 3. Add or update tests. Coverage of new branches in `src/copper_pilot_cli`
    (except `_upstream/`) is expected.
 4. Update docs when behavior changes: [README.md](README.md),
-   [docs/cli.md](docs/cli.md), or [docs/development.md](docs/development.md).
+   [docs/cli.md](docs/cli.md), [docs/harness.md](docs/harness.md), or
+   [docs/development.md](docs/development.md).
 5. Run `make fmt && make lint && make test`.
 6. Open a pull request with the template. Fill in the test plan.
 
@@ -78,10 +79,14 @@ Keep this client a hosted-agent frontend. Do not add:
 - Model or provider pickers
 - Local model execution
 - Computer use
-- MCP or plugin controls
+- An MCP **host**, generic plugin runtime, or MCP **client** stack
 - LangSmith tracing or content telemetry
 - Sandbox runtimes
 
+A thin MCP **server** (`copper-pilot mcp`) and a Claude Code plugin that only
+wraps that server are in scope. They delegate to the hosted agent; they do not
+reimplement it.
+
 Upstream Textual presentation is vendored under
 `src/copper_pilot_cli/_upstream/` with provenance in [UPSTREAM.md](UPSTREAM.md)
 and [NOTICE](NOTICE). When porting upstream changes, follow that document;

{copper_pilot_cli-0.1.4 → copper_pilot_cli-0.1.6}/HISTORY.md

@@ -4,6 +4,26 @@ Changelog
 
 (unreleased)
 ------------
+- Merge pull request #6 from CopperPilot/feat/plugins. [Aditya]
+
+  feat: add MCP conductor and Claude Code plugin
+- Clarify server restrictions in PR template. [Aditya]
+
+  Updated checklist item to clarify server restrictions.
+- Feat: add MCP conductor and Claude Code plugin. [AdityaNG, Cursor]
+
+  Let Claude Code, Cursor, and Codex delegate electronics work to the hosted agent via copper-pilot mcp, a portable review skill, and an in-repo plugin.
+
+
+0.1.5 (2026-09-17)
+------------------
+- Release: version 0.1.5 🚀 [AdityaNG]
+- Fix(README.md) [AdityaNG]
+
+
+0.1.4 (2026-09-17)
+------------------
+- Release: version 0.1.4 🚀 [AdityaNG]
 - Fix(tests/test_release_gates.py) [AdityaNG]
 
 

{copper_pilot_cli-0.1.4 → copper_pilot_cli-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: copper-pilot-cli
-Version: 0.1.4
+Version: 0.1.6
 Summary: CopperPilot hosted agent for the terminal and LangChain
 Project-URL: Homepage, https://copperpilot.ai
 Project-URL: Repository, https://github.com/CopperPilot/copper-pilot-cli
@@ -26,6 +26,7 @@ Requires-Dist: langchain-core<2,>=1.6
 Requires-Dist: langgraph-checkpoint-sqlite<4,>=3.1
 Requires-Dist: langgraph<2,>=1.2
 Requires-Dist: markdownify<2,>=1.2
+Requires-Dist: mcp<2,>=1.21
 Requires-Dist: packaging<27,>=25
 Requires-Dist: pillow<13,>=12
 Requires-Dist: pydantic<3,>=2.12
@@ -62,9 +63,9 @@ Description-Content-Type: text/markdown
 </div>
 
 <div align="center">
-  <a href="https://github.com/CopperPilot/copper-pilot-cli/blob/main/LICENSE"><img src="https://img.shields.io/pypi/l/copper-pilot-cli" alt="License"></a>
-  <a href="https://pypi.org/project/copper-pilot-cli/"><img src="https://img.shields.io/pypi/v/copper-pilot-cli" alt="PyPI version"></a>
-  <a href="https://pypi.org/project/copper-pilot-cli/"><img src="https://img.shields.io/pypi/pyversions/copper-pilot-cli" alt="Python"></a>
+  <a href="https://github.com/CopperPilot/copper-pilot-cli/blob/main/LICENSE"><img src="https://img.shields.io/pypi/l/copper-pilot-cli.svg" alt="License"></a>
+  <a href="https://pypi.org/project/copper-pilot-cli/"><img src="https://img.shields.io/pypi/v/copper-pilot-cli.svg" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/copper-pilot-cli/"><img src="https://img.shields.io/pypi/pyversions/copper-pilot-cli.svg" alt="Python"></a>
   <a href="https://github.com/CopperPilot/copper-pilot-cli/actions/workflows/ci.yml"><img src="https://github.com/CopperPilot/copper-pilot-cli/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
 </div>
 
@@ -111,6 +112,27 @@ Both `copper-pilot` and `copper-pilot-cli` run the same program.
 `copper-pilot --help` lists flags; [docs/cli.md](docs/cli.md) is the full
 command reference.
 
+## Use from Claude Code, Cursor, or Codex
+
+CopperPilot stays the electronics agent. Copy
+[`skills/copper-pilot-review/SKILL.md`](skills/copper-pilot-review/SKILL.md) into
+your harness, or expose the same agent over MCP:
+
+```console
+claude mcp add copper-pilot -- copper-pilot mcp
+```
+
+Claude Code can also install the in-repo plugin:
+
+```text
+/plugin marketplace add CopperPilot/copper-pilot-cli
+/plugin install copper-pilot
+```
+
+That plugin starts `copper-pilot mcp` and adds `@copper-pilot` plus
+`/copper-pilot-review`. Setup for Cursor, Codex, and approvals:
+[docs/harness.md](docs/harness.md).
+
 ## Configuration
 
 - Production API: `https://copperpilot.ai`
@@ -162,8 +184,9 @@ Filesystem, search, edit, and shell execution use Deep Agents' native
 normalizes hosted tool names, approval decisions, and result envelopes.
 
 Computer use, model/provider selection, local model execution, LangSmith
-tracing, content telemetry, MCP/plugin controls, and server implementation code
-are not part of this package.
+tracing, content telemetry, MCP **host**/plugin-runtime controls, and server
+implementation code are not part of this package. A thin MCP **server**
+(`copper-pilot mcp`) that delegates to the hosted agent is.
 
 See [UPSTREAM.md](UPSTREAM.md) and [NOTICE](NOTICE) for the retained Textual
 client attribution.

{copper_pilot_cli-0.1.4 → copper_pilot_cli-0.1.6}/README.md

@@ -13,9 +13,9 @@
 </div>
 
 <div align="center">
-  <a href="https://github.com/CopperPilot/copper-pilot-cli/blob/main/LICENSE"><img src="https://img.shields.io/pypi/l/copper-pilot-cli" alt="License"></a>
-  <a href="https://pypi.org/project/copper-pilot-cli/"><img src="https://img.shields.io/pypi/v/copper-pilot-cli" alt="PyPI version"></a>
-  <a href="https://pypi.org/project/copper-pilot-cli/"><img src="https://img.shields.io/pypi/pyversions/copper-pilot-cli" alt="Python"></a>
+  <a href="https://github.com/CopperPilot/copper-pilot-cli/blob/main/LICENSE"><img src="https://img.shields.io/pypi/l/copper-pilot-cli.svg" alt="License"></a>
+  <a href="https://pypi.org/project/copper-pilot-cli/"><img src="https://img.shields.io/pypi/v/copper-pilot-cli.svg" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/copper-pilot-cli/"><img src="https://img.shields.io/pypi/pyversions/copper-pilot-cli.svg" alt="Python"></a>
   <a href="https://github.com/CopperPilot/copper-pilot-cli/actions/workflows/ci.yml"><img src="https://github.com/CopperPilot/copper-pilot-cli/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
 </div>
 
@@ -62,6 +62,27 @@ Both `copper-pilot` and `copper-pilot-cli` run the same program.
 `copper-pilot --help` lists flags; [docs/cli.md](docs/cli.md) is the full
 command reference.
 
+## Use from Claude Code, Cursor, or Codex
+
+CopperPilot stays the electronics agent. Copy
+[`skills/copper-pilot-review/SKILL.md`](skills/copper-pilot-review/SKILL.md) into
+your harness, or expose the same agent over MCP:
+
+```console
+claude mcp add copper-pilot -- copper-pilot mcp
+```
+
+Claude Code can also install the in-repo plugin:
+
+```text
+/plugin marketplace add CopperPilot/copper-pilot-cli
+/plugin install copper-pilot
+```
+
+That plugin starts `copper-pilot mcp` and adds `@copper-pilot` plus
+`/copper-pilot-review`. Setup for Cursor, Codex, and approvals:
+[docs/harness.md](docs/harness.md).
+
 ## Configuration
 
 - Production API: `https://copperpilot.ai`
@@ -113,8 +134,9 @@ Filesystem, search, edit, and shell execution use Deep Agents' native
 normalizes hosted tool names, approval decisions, and result envelopes.
 
 Computer use, model/provider selection, local model execution, LangSmith
-tracing, content telemetry, MCP/plugin controls, and server implementation code
-are not part of this package.
+tracing, content telemetry, MCP **host**/plugin-runtime controls, and server
+implementation code are not part of this package. A thin MCP **server**
+(`copper-pilot mcp`) that delegates to the hosted agent is.
 
 See [UPSTREAM.md](UPSTREAM.md) and [NOTICE](NOTICE) for the retained Textual
 client attribution.

copper_pilot_cli-0.1.6/VERSION

@@ -0,0 +1 @@
+0.1.6

{copper_pilot_cli-0.1.4 → copper_pilot_cli-0.1.6}/docs/cli.md

@@ -6,6 +6,7 @@
 copper-pilot --help
 copper-pilot auth --help
 copper-pilot threads --help
+copper-pilot mcp --help
 ```
 
 Python 3.12 or newer is required. Install with `pip install copper-pilot-cli`.
@@ -43,6 +44,30 @@ copper-pilot ./my-board --mode plan -m "Propose a power tree"
 ```
 
 Headless mode is also used when `--message` is set and stdout is not a TTY.
+With `--json --no-stream`, the document includes `thread_id` so a later run can
+pass `--resume`.
+
+## MCP
+
+```console
+copper-pilot mcp
+```
+
+Serves a stdio MCP conductor for Claude Code, Cursor, Codex, and other MCP
+hosts. Uses the stored device-login credential. Does not open a browser. Do not
+write to stdout; the protocol owns it.
+
+| Tool | Role |
+|------|------|
+| `status` | Login state and discovered schematic/PCB paths. No hosted call. |
+| `ask` | `--mode ask`. Auto approval. Optional `thread_id`. |
+| `plan` | `--mode plan`. Auto approval. |
+| `run` | `--mode agent`. `approval` is `auto` (default) or `yolo`. |
+| `resume` | Continue `thread_id`. Same approval as `run`. |
+| `threads_list` | List threads for this workspace (`limit`, `all_workspaces`). |
+
+Workspace is the tool argument, else `CLAUDE_PROJECT_DIR`, else the process
+current directory. Manual approval is TUI-only. See [harness.md](harness.md).
 
 ## Auth
 

{copper_pilot_cli-0.1.4 → copper_pilot_cli-0.1.6}/docs/development.md

@@ -10,6 +10,9 @@ src/copper_pilot_cli/   Python package
 tests/                  pytest suite
 examples/               Runnable examples
 docs/                   User and developer docs
+skills/                 Portable Agent Skill for other harnesses
+plugins/                Claude Code plugin (not in the PyPI wheel)
+.claude-plugin/         Plugin marketplace manifest
 .github/                CI, issue forms, pull request template
 ```
 

copper_pilot_cli-0.1.6/docs/harness.md

@@ -0,0 +1,108 @@
+# Use CopperPilot from Claude Code, Cursor, or Codex
+
+CopperPilot stays the electronics agent. The outer tool (Claude Code, Cursor,
+Codex, or a script) only **delegates**. Do not hand-edit KiCad files while a
+CopperPilot run is in flight.
+
+Install the CLI and log in once from a terminal:
+
+```console
+pip install copper-pilot-cli
+copper-pilot auth login
+```
+
+## Option 1: shell out to the CLI
+
+Copy [`skills/copper-pilot-review/SKILL.md`](../skills/copper-pilot-review/SKILL.md)
+into the skill location your harness reads:
+
+| Harness | Skill location |
+|---------|----------------|
+| Claude Code | `~/.claude/skills/copper-pilot-review/SKILL.md` or the project's `.claude/skills/` |
+| Cursor | `.cursor/skills/copper-pilot-review/SKILL.md` or project rules that point at the file |
+| Codex | `AGENTS.md` or the project's skill directory, depending on your Codex setup |
+
+Then ask the outer agent to review the board. It should run:
+
+```console
+copper-pilot -n -m "Review this board" --json --no-stream --mode ask
+```
+
+`--json --no-stream` prints one JSON document. `thread_id` is included so the
+next turn can pass `--resume THREAD_ID`.
+
+Use `--mode plan` for a plan, `--mode agent -y` for Auto local writes, and
+`--yolo` only when the user asked to skip local approval.
+
+## Option 2: MCP conductor (`copper-pilot mcp`)
+
+The same process as the CLI, same stored credential. Stdio JSON-RPC; do not
+write logs to stdout.
+
+### Claude Code
+
+```console
+claude mcp add copper-pilot -- copper-pilot mcp
+```
+
+Or install the in-repo plugin (starts the same server automatically):
+
+```text
+/plugin marketplace add CopperPilot/copper-pilot-cli
+/plugin install copper-pilot
+```
+
+Local checkout:
+
+```console
+claude --plugin-dir plugins/copper-pilot
+```
+
+The plugin also registers `@copper-pilot` and `/copper-pilot-review`.
+
+### Cursor
+
+Add a stdio server in `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "copper-pilot": {
+      "command": "copper-pilot",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+### Codex and other MCP hosts
+
+Point the host at `copper-pilot mcp` on stdio. Tools:
+
+| Tool | Role |
+|------|------|
+| `status` | Login state and discovered schematic/PCB paths |
+| `ask` | Read-oriented specialist (`--mode ask`) |
+| `plan` | Plan without applying (`--mode plan`) |
+| `run` | Mutating agent turn (`--mode agent`) |
+| `resume` | Continue `thread_id` (`mode` defaults to `agent`; pass `mode="ask"` to keep it read-only) |
+| `threads_list` | List threads for this workspace |
+
+Workspace is the tool `workspace` argument, else `CLAUDE_PROJECT_DIR`, else the
+process current directory.
+
+## Approval
+
+| Mode | Where | Behavior |
+|------|-------|----------|
+| Manual | Interactive CLI / TUI only | Prompt before gated writes and shell |
+| Auto | Harness default (`-y`, MCP `approval=auto`) | Routine writes and known-safe shell |
+| YOLO | Explicit `--yolo` or MCP `approval=yolo` | All local side effects. Never saved |
+
+MCP cannot show the TUI, so Manual is not available there. `ask` and `plan`
+always use Auto. `run` and `resume` default to Auto.
+
+Missing credentials: MCP tools return `login_required` and tell the user to run
+`copper-pilot auth login`. The server does not open a browser.
+
+See [docs/cli.md](cli.md) for the full command reference.

copper_pilot_cli-0.1.6/plugins/copper-pilot/.claude-plugin/plugin.json

@@ -0,0 +1,12 @@
+{
+  "name": "copper-pilot",
+  "displayName": "CopperPilot",
+  "description": "Delegate electronics design tasks to the CopperPilot hosted agent.",
+  "version": "0.1.5",
+  "author": {
+    "name": "CopperPilot"
+  },
+  "homepage": "https://copperpilot.ai",
+  "repository": "https://github.com/CopperPilot/copper-pilot-cli",
+  "license": "MIT"
+}

copper_pilot_cli-0.1.6/plugins/copper-pilot/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "copper-pilot": {
+      "command": "copper-pilot",
+      "args": ["mcp"]
+    }
+  }
+}

copper_pilot_cli-0.1.6/plugins/copper-pilot/agents/copper-pilot.md

@@ -0,0 +1,17 @@
+---
+name: copper-pilot
+description: Delegate schematic, PCB, ERC, DRC, and electronics design tasks to the CopperPilot hosted agent. Use when the user asks to review a board, inspect a net or reference, check ERC/DRC, or change KiCad files.
+disallowedTools: Write, Edit
+tools: Read, mcp__plugin_copper-pilot_copper-pilot__status, mcp__plugin_copper-pilot_copper-pilot__ask, mcp__plugin_copper-pilot_copper-pilot__plan, mcp__plugin_copper-pilot_copper-pilot__run, mcp__plugin_copper-pilot_copper-pilot__resume, mcp__plugin_copper-pilot_copper-pilot__threads_list
+---
+
+You are CopperPilot's specialist inside Claude Code. You do not invent ERC, DRC, stackup, or footprint judgments. You delegate to the CopperPilot MCP tools.
+
+Rules:
+
+- Call `status` first if login or workspace paths are unknown.
+- Prefer `ask` unless the user asked for a schematic or PCB change. Use `plan` for a plan, `run` to apply a change, `resume` with a prior `thread_id`. `resume` defaults to agent mode (mutating); pass `mode="ask"` to continue a read-only conversation without escalating write access.
+- Pass `approval=yolo` only when the user explicitly asked to skip local approval. Default is Auto.
+- Do not Edit or Write KiCad files. Leave schematic and PCB side effects to CopperPilot.
+- If a tool returns `login_required`, tell the user to run `copper-pilot auth login` in a terminal.
+- Return a short specialist memo plus `thread_id`. Firmware, git, and docs stay with the parent agent.

copper_pilot_cli-0.1.6/plugins/copper-pilot/skills/copper-pilot-review/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: copper-pilot-review
+description: Review a schematic or PCB with CopperPilot. Use when the user asks to review a board, check ERC/DRC, inspect a net or reference, or get electronics feedback.
+allowed-tools: Read mcp__plugin_copper-pilot_copper-pilot__status mcp__plugin_copper-pilot_copper-pilot__ask mcp__plugin_copper-pilot_copper-pilot__plan mcp__plugin_copper-pilot_copper-pilot__run mcp__plugin_copper-pilot_copper-pilot__resume mcp__plugin_copper-pilot_copper-pilot__threads_list
+context: fork
+agent: copper-pilot
+background: false
+---
+
+# CopperPilot review
+
+Delegate this request to CopperPilot. Do not invent electrical findings from KiCad source text.
+
+Request:
+
+$ARGUMENTS
+
+If `$ARGUMENTS` is empty, use the user's latest message.
+
+Steps:
+
+1. Call `status` if login or schematic/PCB paths are unknown.
+2. Prefer `ask` unless the user asked for a schematic or PCB change. Use `plan` for a plan and `run` only when they asked to apply a change.
+3. Do not Edit or Write KiCad files.
+4. If a tool returns `login_required`, tell the user to run `copper-pilot auth login`.
+5. Summarize the specialist memo and quote `thread_id` so the parent can `resume`.

{copper_pilot_cli-0.1.4 → copper_pilot_cli-0.1.6}/pyproject.toml

@@ -28,6 +28,7 @@ dependencies = [
   "langgraph>=1.2,<2",
   "langgraph-checkpoint-sqlite>=3.1,<4",
   "markdownify>=1.2,<2",
+  "mcp>=1.21,<2",
   "packaging>=25,<27",
   "pillow>=12,<13",
   "pydantic>=2.12,<3",
@@ -85,6 +86,9 @@ include = [
   "/SUPPORT.md",
   "/pyproject.toml",
   "/examples",
+  "/skills",
+  "/plugins",
+  "/.claude-plugin",
 ]
 exclude = [
   "/examples/**/.copperpilot/tmp",

copper_pilot_cli-0.1.6/skills/copper-pilot-review/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: copper-pilot-review
+description: Review a schematic or PCB with CopperPilot via the CLI. Use when the user asks to review a board, check ERC/DRC, inspect a net or reference, or get electronics feedback from CopperPilot.
+license: MIT
+compatibility: Requires copper-pilot-cli on PATH and a CopperPilot login (`copper-pilot auth login`).
+---
+
+# CopperPilot review (CLI)
+
+You are the conductor. CopperPilot is the electronics agent. Do not invent ERC, DRC, stackup, or footprint judgments from KiCad source text when CopperPilot is available.
+
+## Setup
+
+1. The workspace is the project directory (the folder that contains `.kicad_pro` / `.kicad_sch` / `.kicad_pcb`, or the current working directory).
+2. If a command fails with a login error, tell the user to run `copper-pilot auth login` in a terminal and stop.
+
+## How to call CopperPilot
+
+Read-only review (default):
+
+```console
+copper-pilot -n -m "$ARGUMENTS" --json --no-stream --mode ask
+```
+
+If `$ARGUMENTS` is empty, use the user's latest request as the message.
+
+Propose a plan without applying it:
+
+```console
+copper-pilot -n -m "$ARGUMENTS" --json --no-stream --mode plan
+```
+
+Apply a change the user asked for (Auto: routine writes only):
+
+```console
+copper-pilot -n -m "$ARGUMENTS" --json --no-stream --mode agent -y
+```
+
+The JSON document includes `thread_id`. To continue the same chat:
+
+```console
+copper-pilot -n -m "$ARGUMENTS" --json --no-stream --resume THREAD_ID
+```
+
+## Rules
+
+- Do not Edit or Write KiCad files yourself while a CopperPilot run is in flight.
+- Prefer `--mode ask` unless the user asked for a schematic or PCB change.
+- Do not pass `--yolo` unless the user explicitly asked to skip local approval.
+- Summarize CopperPilot's `messages[0].content` for the user. Quote `thread_id` so they can resume.
+- You may still read firmware, docs, and git yourself. Leave schematic and PCB side effects to CopperPilot.

{copper_pilot_cli-0.1.4 → copper_pilot_cli-0.1.6}/src/copper_pilot_cli/copper_main.py

@@ -44,7 +44,7 @@ def parser() -> argparse.ArgumentParser:
         prog="copper-pilot",
         description="CopperPilot hosted agent in the terminal.",
         epilog="Subcommands: copper-pilot auth [login|logout|status]; "
-        "copper-pilot threads list|delete.",
+        "copper-pilot threads list|delete; copper-pilot mcp.",
     )
     result.add_argument(
         "workspace",
@@ -100,15 +100,18 @@ def parser() -> argparse.ArgumentParser:
 
 
 def command_parser(command: str) -> argparse.ArgumentParser:
+    descriptions = {
+        "auth": "Device login for the hosted CopperPilot agent.",
+        "threads": "List or delete CopperPilot chat threads.",
+        "mcp": "Run a stdio MCP server that delegates to the hosted agent.",
+    }
     result = argparse.ArgumentParser(
         prog=f"copper-pilot {command}",
-        description=(
-            "Device login for the hosted CopperPilot agent."
-            if command == "auth"
-            else "List or delete CopperPilot chat threads."
-        ),
+        description=descriptions.get(command, ""),
     )
     result.set_defaults(workspace=".", message=None, command=command)
+    if command == "mcp":
+        return result
     if command == "auth":
         result.add_argument(
             "action",
@@ -265,6 +268,7 @@ async def _headless(
                     {
                         "messages": [{"role": "assistant", "content": assistant_content}],
                         "events": events,
+                        "thread_id": thread_id,
                     }
                 )
             )
@@ -330,9 +334,17 @@ def cli_main() -> None:
     argv = sys.argv[1:]
     args = (
         command_parser(argv[0]).parse_args(argv[1:])
-        if argv and argv[0] in {"auth", "threads"}
+        if argv and argv[0] in {"auth", "threads", "mcp"}
         else parser().parse_args(argv)
     )
+    if args.command == "mcp":
+        from copper_pilot_cli.copper_mcp import run_mcp
+
+        try:
+            run_mcp()
+        except KeyboardInterrupt:
+            raise SystemExit(130) from None
+        return
     try:
         raise SystemExit(asyncio.run(async_main(args)))
     except (AuthenticationError, FileNotFoundError, NotADirectoryError, ValueError) as exc: