From d93bcab0b68e70340a391e127bc4ce6e7233bf1d Mon Sep 17 00:00:00 2001
From: Danila Poyarkov <dev@dannote.net>
Date: Mon, 2 Mar 2026 14:28:56 +0300
Subject: [PATCH] Add install instructions for @open-pencil/mcp

---
 README.md                            |  9 ++++++---
 packages/docs/reference/mcp-tools.md | 26 +++++++++++++++++++++-----
 2 files changed, 27 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index b81f245c4..6b53da9d2 100644
--- a/README.md
+++ b/README.md
@@ -100,12 +100,15 @@ Connect AI coding tools to read and modify `.fig` files headlessly. [Full docs 
 
 **Stdio** (Claude Code, Cursor, Windsurf) — add to your MCP config:
 
+```sh
+bun add -g @open-pencil/mcp
+```
+
 ```json
 {
   "mcpServers": {
     "open-pencil": {
-      "command": "bun",
-      "args": ["packages/mcp/src/index.ts"]
+      "command": "openpencil-mcp"
     }
   }
 }
@@ -114,7 +117,7 @@ Connect AI coding tools to read and modify `.fig` files headlessly. [Full docs 
 **HTTP** (scripts, browser extensions, CI):
 
 ```sh
-bun packages/mcp/src/http.ts   # http://localhost:3100/mcp
+openpencil-mcp-http   # http://localhost:3100/mcp
 ```
 
 29 tools: create shapes, set fills/strokes/layout, find nodes, open/save `.fig` files, render JSX to design nodes.
diff --git a/packages/docs/reference/mcp-tools.md b/packages/docs/reference/mcp-tools.md
index d0a395d08..4331034dc 100644
--- a/packages/docs/reference/mcp-tools.md
+++ b/packages/docs/reference/mcp-tools.md
@@ -4,10 +4,28 @@ OpenPencil includes an MCP (Model Context Protocol) server that lets AI coding t
 
 Two transports: **stdio** for MCP clients, **HTTP** for everything else.
 
+## Install
+
+```sh
+bun add -g @open-pencil/mcp
+```
+
 ## Stdio (Claude Code, Cursor, etc.)
 
 Add to your MCP config (e.g. `~/.claude/settings.json` or `.cursor/mcp.json`):
 
+```json
+{
+  "mcpServers": {
+    "open-pencil": {
+      "command": "openpencil-mcp"
+    }
+  }
+}
+```
+
+Or run from source without installing:
+
 ::: code-group
 ```json [Bun]
 {
@@ -36,13 +54,11 @@ Add to your MCP config (e.g. `~/.claude/settings.json` or `.cursor/mcp.json`):
 For browser extensions, scripts, CI, or any HTTP client:
 
 ```sh
-# Bun
-bun packages/mcp/src/http.ts
-
-# Node.js
-npx tsx packages/mcp/src/http.ts
+openpencil-mcp-http
 ```
 
+Or from source: `bun packages/mcp/src/http.ts` / `npx tsx packages/mcp/src/http.ts`
+
 Starts on port 3100 (override with `PORT` env var). Endpoints:
 
 - `GET /health` — server status