{
  "markdown": "# @modusop/mcp-server\n\nStdio→HTTP proxy for **[Modus Brain](https://brain.modusop.app)** — gives any MCP-aware AI client (Claude Desktop, Cursor, Cline, Continue.dev, etc.) access to your ModusOp organisation's knowledge base.\n\n## What it does\n\nThis package is a thin proxy. It speaks the MCP stdio transport on one end and forwards every JSON-RPC request to Modus Brain's HTTP MCP endpoint on the other.\n\n**All tool implementations live in Modus Brain itself** — when ModusOp ships a new Brain tool, every install of this package picks it up automatically on the next request. No re-publish, no version bump, no user action needed.\n\nIf your AI client speaks remote HTTP MCP natively, you don't need this package at all — point it directly at `https://brain.modusop.app/mcp`. This package exists for clients that only speak stdio.\n\n## Setup\n\n### 1. Get a Brain token\n\nSign in at [brain.modusop.app](https://brain.modusop.app), generate a token labelled for the device or person who'll use it, copy the plaintext value (you only see it once).\n\n### 2. Add to your AI client's MCP config\n\n**Claude Desktop** — `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"modusop-brain\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modusop/mcp-server\"],\n      \"env\": {\n        \"MODUSOP_API_TOKEN\": \"mo_brain_...\"\n      }\n    }\n  }\n}\n```\n\n**Cursor / Cline / Continue.dev** — `.cursor/mcp.json` (or the equivalent):\n\n```json\n{\n  \"mcpServers\": {\n    \"modusop-brain\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modusop/mcp-server\"],\n      \"env\": {\n        \"MODUSOP_API_TOKEN\": \"mo_brain_...\"\n      }\n    }\n  }\n}\n```\n\n### 3. Restart your client\n\nQuit and reopen. The Modus Brain tools should appear in the MCP indicator within a few seconds.\n\n## Env vars\n\n| Variable | Required | Default | Notes |\n|---|---|---|---|\n| `MODUSOP_API_TOKEN` | yes | — | Brain token from brain.modusop.app |\n| `MODUSOP_BRAIN_URL` | no | `https://brain.modusop.app/mcp` | Override only for local Brain development |\n\n## Available tools\n\nWhatever Brain exposes — `tools/list` reflects the current set. As of v1.0.0:\n\n- `whoami` — identify the user + org this token is scoped to\n- `search_knowledge` — semantic search over the org KB\n- `get_chunk` — deep-dive on a specific search result\n- `list_recent` — recently indexed KB items\n- `get_client_brief` — synthesised client one-pager\n- `add_observation` — append a note\n- `add_decision` — record context + decision + rationale\n- `link_observation` — typed link between two chunks\n- `request_delete` — admin-gated removal\n\n## Migrating from 0.x\n\nVersions 0.x of this package implemented tools in-package and talked to ModusOp's older `/api/mcp` endpoint with an MO API token from `/settings/api-tokens`. v1.0.0 retires that path:\n\n- Generate a new **Brain** token at [brain.modusop.app](https://brain.modusop.app), not an MO API token\n- Replace the value of `MODUSOP_API_TOKEN` with the new token\n- No other config change needed — same `command`, same `args`, same env var name\n\nOld tools (`search_projects`, `search_clients`, `get_client_context`, `start_timer`, etc.) are no longer present in this package's catalogue. They've been retired in favour of Brain's tools, which cover the same surface plus knowledge-base search and append-writes. If you need the old tool set, pin to `@modusop/mcp-server@0.2.5` — it still works but won't receive updates.\n\n## Local development\n\n```bash\ngit clone https://github.com/jwwd-repos/modusop-mcp.git\ncd modusop-mcp\nnpm install\nMODUSOP_API_TOKEN=... npm run dev\n```\n\nThe proxy reads JSON-RPC on stdin and writes responses on stdout, so test it manually with:\n\n```bash\necho '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"whoami\"}}' \\\n  | MODUSOP_API_TOKEN=... npm run dev\n```\n\n## Licence\n\nSee `LICENSE.md`.\n",
  "bytes": 3898,
  "sha": "32db39f52c7e4a57bd3b5be4a012f4da42511e11b45d8f29f0b8e7bac941ebf0",
  "repo_slug": "jwwd-repos/modusop-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_jwwd_repos_modusop_mcp_54a84307/readme"
}