@theyahia/megaplan-mcp 1.1.1 → 4.0.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 theYahia
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 theYahia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,19 +1,62 @@
 # @theyahia/megaplan-mcp
 
-MCP server for **Megaplan** project management. Provides tools for managing tasks and deals via API v3.
+MCP server for **Megaplan** project management. Tasks, deals, projects,
+employees, clients, and comments via Megaplan API v3.
 
-## Tools
+> **v4.0 is a breaking release** (and the first npm release of this overhaul —
+> it supersedes the older 8-tool `3.0.0`). Request/response shapes changed to
+> match the real v3 API, and `--http` now requires an auth token. See
+> [CHANGELOG.md](./CHANGELOG.md) and [Migrating from older versions](#migrating-from-older-versions).
+
+## Tools (18)
 
 | Tool | Description |
 |------|------------|
-| `get_tasks` | List tasks with filters by status, responsible, search |
-| `create_task` | Create a new task with name, description, deadline |
-| `get_deals` | List deals with filters by status, responsible, search |
+| `get_tasks` | List tasks; filter by status code(s), responsible, search |
+| `get_task` | Get one task by ID |
+| `create_task` | Create a task (name, description, responsible, deadline) |
+| `update_task` | Update a task (name, description, responsible, deadline, status) |
+| `get_deals` | List deals; filter by status code(s), responsible, search |
+| `get_deal` | Get one deal by ID |
+| `create_deal` | Create a deal (requires a program/pipeline ID) |
+| `update_deal` | Update a deal (name, responsible, amount, description, status) |
+| `get_projects` | List projects; filter by status code(s), search |
+| `get_project` | Get one project by ID |
+| `get_employees` | List employees; search + department filter |
+| `get_deal_programs` | List deal programs (pipelines) — find the `program_id` for `create_deal` |
+| `get_deal_program` | Get one deal program by ID |
+| `list_clients` | List clients (contractors): people (`human`) or orgs (`company`) |
+| `get_client` | Get one client by type + ID |
+| `get_current_user` | Authenticated user's employee record (**experimental**) |
+| `get_comments` | List comments on a task/deal/project |
+| `create_comment` | Add a comment to a task/deal/project |
+
+All list/get tools return a **compact summary** by default; pass `raw: true` for
+the unmodified API JSON. Lists are cursor-paginated: pass the returned
+`nextPageAfter` as `page_after` to get the next page.
+
+## Skills (Prompts)
+
+| Skill | Description |
+|-------|------------|
+| `my-tasks-today` | "Мои задачи на сегодня" — your tasks (scoped via `get_current_user`) |
+| `create-deal-wizard` | "Создай сделку" — guided deal creation (lists pipelines first) |
 
 ## Setup
 
-1. In Megaplan, go to **Settings > Integration > API**
-2. Generate an access token
+### Option A: Access Token
+
+1. In Megaplan, go to **Settings → Integration → API**.
+2. Generate an access token, and set it as `MEGAPLAN_TOKEN`.
+
+### Option B: Login + Password
+
+Set `MEGAPLAN_LOGIN` (email) + `MEGAPLAN_PASSWORD`. The server exchanges them for
+an access token (cached in memory, re-authenticated on expiry).
+
+`MEGAPLAN_DOMAIN` is your account host. A bare subdomain like `yourcompany` is
+expanded to `yourcompany.megaplan.ru`; a full host (`crm.example.com`) is used
+as-is.
 
 ## Usage with Claude Desktop
 
@@ -24,7 +67,7 @@ MCP server for **Megaplan** project management. Provides tools for managing task
       "command": "npx",
       "args": ["-y", "@theyahia/megaplan-mcp"],
       "env": {
-        "MEGAPLAN_DOMAIN": "yourcompany.megaplan.ru",
+        "MEGAPLAN_DOMAIN": "yourcompany",
         "MEGAPLAN_TOKEN": "your-access-token"
       }
     }
@@ -32,12 +75,93 @@ MCP server for **Megaplan** project management. Provides tools for managing task
 }
 ```
 
+Or with login/password — replace `MEGAPLAN_TOKEN` with `MEGAPLAN_LOGIN` +
+`MEGAPLAN_PASSWORD`.
+
+## Finding IDs
+
+Several tools take IDs. Here's how to discover them via the server itself:
+
+- **`responsible_id`, `filter_responsible_id`** → `get_employees` (each item has an `id`).
+- **`filter_department_id`** → IDs appear on employees' `department` (or your Megaplan UI).
+- **`program_id`** (required by `create_deal`) → `get_deal_programs`.
+- **`contact_id`** (for `create_deal`) → `list_clients` with `type: "human"` or `"company"`; pass the matching `contact_type`.
+- **status codes** (`filter_status`) are account-specific enum codes (e.g. `filter_any`), not display names. Find them in your Megaplan UI / account API schema.
+
+## Streamable HTTP transport
+
+For remote/cloud deployments, run with `--http`. **Auth is mandatory** — the
+server holds your Megaplan credentials, so it refuses to start without
+`MCP_HTTP_TOKEN` and binds to loopback by default.
+
+```bash
+MEGAPLAN_DOMAIN=yourcompany \
+MEGAPLAN_TOKEN=xxx \
+MCP_HTTP_TOKEN=$(openssl rand -hex 32) \
+npx @theyahia/megaplan-mcp --http
+# → http://127.0.0.1:3000/mcp  (send: Authorization: Bearer $MCP_HTTP_TOKEN)
+# Health: http://127.0.0.1:3000/health
+```
+
+To expose beyond loopback, set `HOST=0.0.0.0` **and** add the public host:port to
+`MCP_HTTP_ALLOWED_HOSTS` (DNS-rebinding protection is on). Only do this behind
+your own network controls.
+
 ## Environment Variables
 
 | Variable | Required | Description |
 |----------|----------|-------------|
-| `MEGAPLAN_DOMAIN` | Yes | Your Megaplan domain (e.g. `yourcompany.megaplan.ru`) |
-| `MEGAPLAN_TOKEN` | Yes | Bearer access token |
+| `MEGAPLAN_DOMAIN` | Yes | Account host (`yourcompany` → `yourcompany.megaplan.ru`, or a full host) |
+| `MEGAPLAN_TOKEN` | One of | Bearer access token |
+| `MEGAPLAN_LOGIN` | One of | Login email (if no token) |
+| `MEGAPLAN_PASSWORD` | One of | Password (if no token) |
+| `MEGAPLAN_DEBUG` | No | `1` to log full upstream error bodies |
+| `PORT` | No | HTTP port for `--http` mode (default: 3000) |
+| `MCP_HTTP_TOKEN` | `--http` | Bearer token required to call `/mcp` (server refuses to start without it) |
+| `HOST` | No | Bind address for `--http` (default `127.0.0.1`) |
+| `MCP_HTTP_ALLOWED_HOSTS` | No | Comma-separated allowed `Host` values (default loopback:port) |
+| `MCP_HTTP_BODY_LIMIT` | No | Max request body size (default `1mb`) |
+| `MCP_HTTP_MAX_SESSIONS` | No | Max concurrent sessions (default `100`) |
+| `MCP_HTTP_SESSION_TTL_MS` | No | Idle session eviction TTL (default 30 min) |
+
+## Migrating from older versions
+
+Applies to the previously published 8-tool builds (`1.x`–`3.0.0`):
+
+- `get_*` list tools: `offset` → `page_after` (cursor); `filter_status` now takes
+  status **code(s)**, not names like `active`.
+- Output is a compact summary by default — pass `raw: true` for the old raw JSON.
+- `create_comment`: the text field is now `content` (was `text`).
+- `--http`: set `MCP_HTTP_TOKEN`; the default bind is now `127.0.0.1`.
+
+## Verification status
+
+Most behaviour is confirmed against the official v3 RAML and real v3 client
+libraries. A few items are best-effort from docs and marked `TODO(live-verify)`
+in the source (and `experimental` here), pending a test against a live account:
+auth body encoding, the free-text search param name, the `get_current_user`
+endpoint, and the task/deal status-change field shape. Errors are surfaced
+clearly (set `MEGAPLAN_DEBUG=1` for full detail) so any mismatch is diagnosable.
+
+## Referral
+
+Get **20-50% recurring** commission by referring Megaplan:
+
+- [Megaplan Partner Program](https://megaplan.ru/partners/)
+- Sign up as a partner, get your referral link.
+- Every client you bring = recurring revenue share.
+
+## Development
+
+```bash
+npm install
+npm run build        # tsc -> dist/
+npm run typecheck    # tsc --noEmit (src + tests)
+npm run lint         # eslint
+npm test             # vitest
+npm run dev          # stdio mode with tsx
+npm run start:http   # HTTP mode (needs MCP_HTTP_TOKEN)
+```
 
 ## License
 

package/dist/client.d.ts

@@ -1,2 +1,4 @@
-export declare function megaplanGet(path: string, params?: Record<string, string>): Promise<unknown>;
+/** Test helper: reset cached auth state between cases. */
+export declare function __resetAuth(): void;
+export declare function megaplanGet(path: string, params?: Record<string, unknown>): Promise<unknown>;
 export declare function megaplanPost(path: string, body: unknown): Promise<unknown>;

package/dist/client.js

@@ -1,20 +1,109 @@
 const TIMEOUT = 15_000;
 const MAX_RETRIES = 3;
-function getBaseUrl() {
-    const domain = process.env.MEGAPLAN_DOMAIN;
-    if (!domain)
+// Show full upstream response bodies in logs/errors only when explicitly enabled.
+// Deliberately scoped to MEGAPLAN_DEBUG so a generic DEBUG=* doesn't log bodies.
+const DEBUG = Boolean(process.env.MEGAPLAN_DEBUG);
+let cachedToken = null;
+// Single in-flight auth, shared by concurrent callers (avoids a thundering herd
+// of password grants on cold start / after a 401 invalidation).
+let authPromise = null;
+/** Test helper: reset cached auth state between cases. */
+export function __resetAuth() {
+    cachedToken = null;
+    authPromise = null;
+}
+function isStaticToken() {
+    return Boolean(process.env.MEGAPLAN_TOKEN);
+}
+function getDomain() {
+    const raw = process.env.MEGAPLAN_DOMAIN;
+    if (!raw)
         throw new Error("MEGAPLAN_DOMAIN is not set");
-    const clean = domain.replace(/^https?:\/\//, "").replace(/\/$/, "");
-    return `https://${clean}/api/v3`;
+    let domain = raw.replace(/^https?:\/\//i, "").replace(/\/+$/, "").trim();
+    // Config-time SSRF guard: a bare host[:port] only — no path, credentials, or spaces.
+    if (!/^[a-zA-Z0-9.\-]+(:[0-9]+)?$/.test(domain)) {
+        throw new Error(`MEGAPLAN_DOMAIN is invalid: "${raw}". Provide a bare host like "yourcompany" or "yourcompany.megaplan.ru".`);
+    }
+    // A bare subdomain ("yourcompany") is expanded to "yourcompany.megaplan.ru".
+    if (!domain.includes("."))
+        domain = `${domain}.megaplan.ru`;
+    return domain;
+}
+function getBaseUrl() {
+    return `https://${getDomain()}/api/v3`;
 }
-function getToken() {
-    const token = process.env.MEGAPLAN_TOKEN;
+async function authenticate() {
+    const login = process.env.MEGAPLAN_LOGIN;
+    const password = process.env.MEGAPLAN_PASSWORD;
+    if (!login || !password) {
+        throw new Error("Either MEGAPLAN_TOKEN or (MEGAPLAN_LOGIN + MEGAPLAN_PASSWORD) must be set");
+    }
+    // The v3 access_token endpoint expects form fields, not a JSON body. We send
+    // application/x-www-form-urlencoded (the OAuth2 password-grant standard).
+    // TODO(live-verify): if an account rejects urlencoded, switch to multipart
+    // FormData (the form the official curl example shows) or JSON.
+    const body = new URLSearchParams({
+        username: login,
+        password,
+        grant_type: "password",
+    });
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), TIMEOUT);
+    let response;
+    try {
+        response = await fetch(`https://${getDomain()}/api/v3/auth/access_token`, {
+            method: "POST",
+            headers: { Accept: "application/json" },
+            body,
+            signal: controller.signal,
+        });
+    }
+    catch (error) {
+        if (error instanceof DOMException && error.name === "AbortError") {
+            throw new Error("Megaplan auth timed out");
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    if (!response.ok) {
+        const text = await safeText(response);
+        throw new Error(`Megaplan auth failed (${response.status})${errorDetail(text)}`);
+    }
+    const data = (await response.json());
+    const token = data.access_token ?? data.data?.access_token;
     if (!token)
-        throw new Error("MEGAPLAN_TOKEN is not set");
+        throw new Error("Megaplan auth: no access_token in response");
     return token;
 }
+async function getToken() {
+    const envToken = process.env.MEGAPLAN_TOKEN;
+    if (envToken)
+        return envToken;
+    if (cachedToken)
+        return cachedToken;
+    if (authPromise)
+        return authPromise;
+    authPromise = authenticate()
+        .then((token) => {
+        cachedToken = token;
+        return token;
+    })
+        .finally(() => {
+        authPromise = null;
+    });
+    return authPromise;
+}
 export async function megaplanGet(path, params) {
-    const query = params ? `?${new URLSearchParams(params).toString()}` : "";
+    // v3 collection endpoints take a single JSON object (limit, filter, pageAfter,
+    // …) URL-encoded into the query string — not flat query params.
+    // TODO(live-verify): some accounts accept the raw `?{json}` form; percent-
+    // encoding is the safe default.
+    let query = "";
+    if (params && Object.keys(params).length > 0) {
+        query = `?${encodeURIComponent(JSON.stringify(params))}`;
+    }
     return megaplanRequest("GET", `${path}${query}`);
 }
 export async function megaplanPost(path, body) {
@@ -22,40 +111,135 @@ export async function megaplanPost(path, body) {
 }
 async function megaplanRequest(method, path, body) {
     for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {
+        const token = await getToken();
         const controller = new AbortController();
         const timer = setTimeout(() => controller.abort(), TIMEOUT);
+        let response;
         try {
-            const response = await fetch(`${getBaseUrl()}${path}`, {
+            response = await fetch(`${getBaseUrl()}${path}`, {
                 method,
                 headers: {
-                    "Authorization": `Bearer ${getToken()}`,
+                    Authorization: `Bearer ${token}`,
                     "Content-Type": "application/json",
-                    "Accept": "application/json",
+                    Accept: "application/json",
                 },
-                body: body ? JSON.stringify(body) : undefined,
+                body: body !== undefined ? JSON.stringify(body) : undefined,
                 signal: controller.signal,
             });
+        }
+        catch (error) {
             clearTimeout(timer);
-            if (response.ok)
-                return response.json();
-            if ((response.status === 429 || response.status >= 500) && attempt < MAX_RETRIES) {
-                const delay = Math.min(1000 * 2 ** (attempt - 1), 8000);
-                console.error(`[megaplan-mcp] ${response.status}, retry in ${delay}ms (${attempt}/${MAX_RETRIES})`);
-                await new Promise(r => setTimeout(r, delay));
+            if (isRetriableNetworkError(error) && attempt < MAX_RETRIES) {
+                if (DEBUG)
+                    console.error(`[megaplan-mcp] network error, retry (${attempt}/${MAX_RETRIES})`);
+                await sleep(backoff(attempt));
                 continue;
             }
-            const text = await response.text();
-            throw new Error(`Megaplan HTTP ${response.status}: ${text}`);
+            throw normalizeNetworkError(error);
         }
-        catch (error) {
-            clearTimeout(timer);
-            if (error instanceof DOMException && error.name === "AbortError" && attempt < MAX_RETRIES) {
-                console.error(`[megaplan-mcp] Timeout, retry (${attempt}/${MAX_RETRIES})`);
+        clearTimeout(timer);
+        if (response.status === 401) {
+            if (isStaticToken()) {
+                throw new Error("Megaplan HTTP 401: access token rejected (check MEGAPLAN_TOKEN).");
+            }
+            // login/password mode: invalidate only the token we actually used, then retry.
+            // We deliberately do NOT null authPromise here: leaving it intact lets
+            // concurrent 401s (e.g. a token expiring under load) share getToken's single
+            // in-flight re-auth instead of each kicking off its own auth request. The
+            // `=== token` guard avoids wiping a fresh token a peer already obtained.
+            if (cachedToken === token) {
+                cachedToken = null;
+            }
+            if (attempt < MAX_RETRIES) {
+                if (DEBUG)
+                    console.error(`[megaplan-mcp] 401, re-authenticating (${attempt}/${MAX_RETRIES})`);
                 continue;
             }
-            throw error;
+            const text = await safeText(response);
+            throw new Error(`Megaplan HTTP 401${errorDetail(text)}`);
         }
+        if (response.ok)
+            return parseBody(response);
+        if ((response.status === 429 || response.status >= 500) && attempt < MAX_RETRIES) {
+            const delay = retryAfterDelay(response, attempt);
+            if (DEBUG) {
+                console.error(`[megaplan-mcp] ${response.status}, retry in ${delay}ms (${attempt}/${MAX_RETRIES})`);
+            }
+            await sleep(delay);
+            continue;
+        }
+        const text = await safeText(response);
+        throw new Error(`Megaplan HTTP ${response.status}${errorDetail(text)}`);
     }
     throw new Error("Megaplan: all retries exhausted");
 }
+// ── helpers ──
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+function backoff(attempt) {
+    return Math.min(1000 * 2 ** (attempt - 1), 8000);
+}
+function retryAfterDelay(response, attempt) {
+    const header = response.headers.get("retry-after");
+    if (header) {
+        const seconds = Number(header);
+        if (Number.isFinite(seconds))
+            return clampDelay(seconds * 1000);
+        const date = Date.parse(header);
+        if (!Number.isNaN(date))
+            return clampDelay(date - Date.now());
+    }
+    return backoff(attempt);
+}
+function clampDelay(ms) {
+    return Math.min(Math.max(ms, 0), 60_000);
+}
+function isRetriableNetworkError(error) {
+    // AbortError = our timeout fired; TypeError = undici "fetch failed"
+    // (ECONNRESET/ENOTFOUND/ECONNREFUSED/TLS hiccups).
+    if (error instanceof DOMException && error.name === "AbortError")
+        return true;
+    if (error instanceof TypeError)
+        return true;
+    return false;
+}
+function normalizeNetworkError(error) {
+    if (error instanceof DOMException && error.name === "AbortError") {
+        return new Error("Megaplan request timed out");
+    }
+    if (error instanceof Error)
+        return error;
+    return new Error(String(error));
+}
+async function parseBody(response) {
+    if (response.status === 204)
+        return null;
+    const text = await response.text();
+    if (!text)
+        return null;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new Error(`Megaplan: expected JSON but got a non-JSON response (${response.status})${errorDetail(text)}`);
+    }
+}
+async function safeText(response) {
+    try {
+        return await response.text();
+    }
+    catch {
+        return "";
+    }
+}
+/** A short, sanitized snippet of an upstream error body for the thrown message. */
+function errorDetail(text) {
+    if (!text)
+        return "";
+    if (DEBUG)
+        return `: ${text}`;
+    const snippet = text.replace(/\s+/g, " ").trim().slice(0, 200);
+    return snippet ? `: ${snippet}` : "";
+}
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/format.d.ts

@@ -0,0 +1,12 @@
+import type { MegaplanTask, MegaplanDeal, MegaplanProject, MegaplanEmployee, MegaplanComment, MegaplanProgram, MegaplanClient } from "./types.js";
+export declare function formatTask(e: unknown): MegaplanTask;
+export declare function formatDeal(e: unknown): MegaplanDeal;
+export declare function formatProject(e: unknown): MegaplanProject;
+export declare function formatEmployee(e: unknown): MegaplanEmployee;
+export declare function formatComment(e: unknown): MegaplanComment;
+export declare function formatProgram(e: unknown): MegaplanProgram;
+export declare function formatClient(e: unknown): MegaplanClient;
+/** Unwrap a v3 `{meta, data}` list envelope into a compact summary string. */
+export declare function formatList<T>(result: unknown, formatter: (e: unknown) => T, raw?: boolean): string;
+/** Unwrap a v3 `{data: {...}}` single-entity envelope and format it. */
+export declare function formatEntity<T>(result: unknown, formatter: (e: unknown) => T, raw?: boolean): string;