idiolect-mcp 0.3.0 → 0.4.0

package/README.md

@@ -1,61 +1,55 @@
-# Idiolect Plugin
+# idiolect-mcp
 
-Write in **your** voice — everywhere your agent writes. Idiolect rewrites the prose
-an agent drafts on your behalf (commit messages, PR descriptions, docs, release
-notes, replies) into your own writing voice, and scores how close it got on a
-validated voice‑fidelity metric. Works in **Claude Code** and **Codex**.
+MCP server that makes any MCP-compatible AI (Claude Desktop, Claude Code, …)
+write in **your** voice, using your [Idiolect AI](https://idiolect.app) Voice Card.
 
 ## Setup
 
-1. **Get your API key** — sign in at <https://idiolect.lol/connect> and generate one.
-2. **Claude Code:**
-   ```
-   /plugin marketplace add 111mihir/idiolect-plugin
-   /plugin install idiolect@idiolect
-   ```
-   Then set your key in the environment Claude Code runs in:
-   ```
-   export IDIOLECT_API_KEY=idl_sk_your_key_here
-   ```
-3. **Codex:** register Idiolect as an MCP server — one command, no clone (it runs
-   via `npx`, writing an `[mcp_servers.idiolect]` entry to `~/.codex/config.toml`):
-   ```
-   codex mcp add idiolect \
-     --env IDIOLECT_API_KEY=idl_sk_your_key_here \
-     --env IDIOLECT_BASE=https://idiolect.lol \
-     -- npx -y idiolect-mcp
-   ```
-
-The plugin bundles a self‑contained MCP server (`server.mjs`) — no `npm install`
-needed.
-
-## Slash commands
-
-Commands are namespaced by the plugin:
-
-- `/idiolect:voice` — show a summary of your writing voice.
-- `/idiolect:rewrite <text>` — rewrite text into your voice (+ Voice Match).
-- `/idiolect:draft <brief>` — draft new content from a brief, in your voice.
-- `/idiolect:check <text>` — score any text against your voice.
-
-## The skill
-
-The **in‑your‑voice** skill triggers automatically whenever the agent drafts prose
-for you: it calls `get_my_voice`, rewrites the draft via `rewrite_in_voice`, and
-shows the Voice Match — so everything you "write" through the agent sounds like you.
-
-## Tools (MCP)
-
-| Tool | What it does |
-| --- | --- |
-| `get_my_voice` | Load your Voice Card (call before writing on your behalf). |
-| `rewrite_in_voice` | Rewrite text in your voice; returns Voice Match + before→after delta. |
-| `draft_in_voice` | Draft new prose in your voice from a brief. |
-| `score_voice` | Voice Match of any text against your own writing. |
-
-Pro is required for `rewrite_in_voice` / `draft_in_voice`. Your voice and corpus
-live in your Idiolect account; the key resolves to them server‑side.
-
----
-
-Built from the Idiolect monorepo. To regenerate `server.mjs`, run `plugin/build.sh`.
+### Account mode
+
+For account-resolved voice and Pro rewrite/draft tools, set `IDIOLECT_API_KEY`:
+
+```json
+{
+  "mcpServers": {
+    "idiolect": {
+      "command": "npx",
+      "args": ["-y", "idiolect-mcp"],
+      "env": { "IDIOLECT_API_KEY": "idiolect_..." }
+    }
+  }
+}
+```
+
+### Slug mode
+
+1. Get your voice at **https://idiolect.app** — note the slug in your result URL
+   (`idiolect.app/v/<slug>`).
+2. Add to your MCP config:
+
+```json
+{
+  "mcpServers": {
+    "idiolect": {
+      "command": "npx",
+      "args": ["-y", "idiolect-mcp"],
+      "env": { "IDIOLECT_SLUG": "your-slug" }
+    }
+  }
+}
+```
+
+## Tool
+
+- **`get_my_voice`** — returns your Voice Card. The model calls it before writing
+  on your behalf, then writes as you. Pass `slug` per-call or set `IDIOLECT_SLUG`.
+- **`score_voice`** — scores text against your voice. In account mode this uses
+  your API key; in slug mode it uses your local writing samples.
+- **`rewrite_in_voice`** — account mode only. Rewrites drafted prose in your
+  actual voice.
+- **`draft_in_voice`** — account mode only. Drafts from a brief in your voice.
+
+Set `IDIOLECT_BASE` to point at a self-hosted instance (defaults to
+`https://idiolect.app`).
+
+MIT licensed.

package/package.json

@@ -1,13 +1,39 @@
 {
   "name": "idiolect-mcp",
-  "version": "0.3.0",
-  "description": "MCP server that makes any MCP-compatible agent (Claude Code, Codex, Claude Desktop) write in YOUR voice — rewrites/drafts/scores prose against your Idiolect voice, on a validated fidelity metric.",
+  "version": "0.4.0",
+  "mcpName": "app.idiolect/idiolect-ai",
   "type": "module",
-  "bin": { "idiolect-mcp": "server.mjs" },
-  "files": ["server.mjs"],
-  "homepage": "https://idiolect.lol",
-  "repository": { "type": "git", "url": "git+https://github.com/111mihir/idiolect-plugin.git" },
-  "keywords": ["mcp", "model-context-protocol", "claude", "codex", "ai", "writing", "voice", "idiolect", "ghostwriting"],
-  "author": "Idiolect (https://idiolect.lol)",
-  "license": "MIT"
+  "bin": {
+    "idiolect-mcp": "server.mjs"
+  },
+  "description": "MCP server that gives any MCP-compatible AI (Claude, etc.) your Idiolect AI voice — make AI write as you. https://idiolect.app",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "ai",
+    "writing",
+    "voice",
+    "idiolect"
+  ],
+  "homepage": "https://idiolect.app",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/111mihir/idiolect.git",
+    "directory": "mcp"
+  },
+  "license": "MIT",
+  "files": [
+    "server.mjs",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4"
+  }
 }