huly-mcp-sdk 0.2.1

package/.env.example

@@ -0,0 +1,16 @@
+# ─── Required ────────────────────────────────────────────────────────────────
+HULY_WORKSPACE=your-workspace-slug   # e.g. "myteam" from huly.app/myteam
+
+# ─── Authentication (choose ONE option) ──────────────────────────────────────
+
+# Option A — Token auth (recommended for SSO / Google / GitHub accounts)
+# Run the interactive setup wizard to get a token via email OTP:
+#   npm run setup
+# HULY_TOKEN=your-token-here
+
+# Option B — Email + password auth (only works if you set a password on huly.app)
+# HULY_EMAIL=your-email@example.com
+# HULY_PASSWORD=your-password
+
+# ─── Optional ────────────────────────────────────────────────────────────────
+# HULY_ACCOUNTS_URL=https://account.huly.app   # default shown; change for self-hosted

package/README.md

@@ -0,0 +1,189 @@
+# huly-mcp-sdk
+
+> The most complete MCP server for [Huly](https://huly.app) — the open-source project management platform.
+
+Connects **Claude Desktop** (and any [MCP](https://modelcontextprotocol.io)-compatible client) directly to your Huly workspace. Manage issues, labels, relations, milestones, documents, and more — all via natural language.
+
+---
+
+## Tools (20 total)
+
+| Category | Tool | Description |
+|----------|------|-------------|
+| **Projects** | `list_projects` | List all projects in the workspace |
+| | `get_project` | Get project details + available statuses |
+| **Issues** | `list_issues` | List issues with optional status/priority/assignee filters |
+| | `get_issue` | Get full details of an issue (e.g. `PROJ-42`) |
+| | `create_issue` | Create a new issue |
+| | `update_issue` | Update title, status, priority, assignee, or due date |
+| | `delete_issue` | Permanently delete an issue by identifier |
+| **Comments** | `add_comment` | Add a comment to an issue |
+| **Labels** | `list_labels` | List all labels in the workspace with color + usage count |
+| | `create_label` | Create a new label with an optional hex color |
+| | `add_label` | Add a label to an issue (auto-creates the label if it doesn't exist) |
+| | `remove_label` | Remove a label from an issue |
+| **Relations** | `add_relation` | Mark two issues as related (bidirectional) |
+| | `add_blocked_by` | Mark an issue as blocked by another issue |
+| | `set_parent` | Set or clear the parent epic of an issue |
+| **Members** | `list_members` | List workspace members |
+| **Milestones** | `list_milestones` | List milestones for a project |
+| **Documents** | `list_teamspaces` | List document teamspaces |
+| | `list_documents` | List documents in a teamspace |
+| **Search** | `search_issues` | Full-text search across all issues |
+
+---
+
+## Requirements
+
+- Node.js >= 20
+- A Huly account — [huly.app](https://huly.app) (cloud) or self-hosted
+
+---
+
+## Quick Start
+
+### 1. Install
+
+```bash
+git clone https://github.com/varaprasadreddy9676/huly-mcp.git
+cd huly-mcp
+npm install
+npm run build
+```
+
+### 2. Authenticate
+
+Run the interactive setup wizard — it sends a one-time code to your email (works for Google/GitHub SSO accounts too):
+
+```bash
+npm run setup
+```
+
+The wizard will ask for your email address and workspace slug, send a 6-digit OTP to your inbox, and write a `.env` file automatically.
+
+**Your workspace slug** is the part of your Huly URL after the domain: `huly.app/`**`myteam`** → slug is `myteam`.
+
+> If you prefer, you can write `.env` manually — see [Manual Auth](#manual-auth) below.
+
+### 3. Configure Claude Desktop
+
+Add this to your Claude Desktop config:
+
+- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "huly": {
+      "command": "node",
+      "args": ["/absolute/path/to/huly-mcp/dist/index.js"],
+      "env": {
+        "HULY_TOKEN": "paste-token-from-.env-here",
+        "HULY_WORKSPACE": "your-workspace-slug"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop after saving.
+
+---
+
+## Example Prompts
+
+**Issues:**
+- *"List all in-progress issues in the PROJ project"*
+- *"Create a high-priority issue in PROJ titled 'Fix login timeout'"*
+- *"Update PROJ-42 status to Done and assign it to Sarah"*
+- *"Search for issues related to authentication"*
+- *"Add a comment to PROJ-15 saying the fix is deployed"*
+
+**Labels:**
+- *"List all labels in my workspace"*
+- *"Add the label 'bug' to PROJ-42"*
+- *"Create a label called 'backend' with color #3b82f6"*
+- *"Remove the 'wontfix' label from PROJ-10"*
+
+**Relations:**
+- *"Mark PROJ-55 as blocked by PROJ-12"*
+- *"Mark PROJ-30 and PROJ-31 as related"*
+- *"Set PROJ-42 as a subtask of PROJ-5"*
+
+**Other:**
+- *"List all projects and their member counts"*
+- *"Show milestones for the PROJ project"*
+- *"List all documents in the Engineering teamspace"*
+
+---
+
+## Bulk CSV Import
+
+Import many issues at once from a CSV file — useful for migrating from other tools:
+
+```bash
+node scripts/import-csv.js tasks.csv PROJ
+```
+
+**CSV format:**
+
+```csv
+title,priority,status,dueDate
+Fix login bug,High,In Progress,2025-04-01
+Add dark mode,Medium,,
+Improve performance,Urgent,,2025-05-01
+```
+
+Required column: `title`. Optional: `priority` (Urgent/High/Medium/Low), `status` (must match a status name in the project), `dueDate` (YYYY-MM-DD).
+
+Auth is read from your `.env` file automatically.
+
+---
+
+## Manual Auth
+
+If you prefer to set up `.env` by hand, create a `.env` file in the project root:
+
+**Option A — Token (recommended for all account types):**
+
+```bash
+HULY_WORKSPACE=your-workspace-slug
+HULY_TOKEN=your-token-here
+```
+
+To get a token without the setup wizard:
+1. Go to [huly.app](https://huly.app) → open browser DevTools → Application → Local Storage → `https://huly.app` → copy the `token` value.
+
+> Tokens expire after some time. If you get an auth error, run `npm run setup` again or refresh the token from DevTools.
+
+**Option B — Email + password:**
+
+Only works if you have a password set on your account (Profile → Security → Change password).
+
+```bash
+HULY_EMAIL=your@email.com
+HULY_PASSWORD=yourpassword
+HULY_WORKSPACE=your-workspace-slug
+```
+
+**Self-hosted Huly:**
+
+```bash
+HULY_ACCOUNTS_URL=https://your-huly-instance.com/account
+```
+
+---
+
+## Architecture
+
+- **Single long-lived WebSocket connection** — connects once per process via `@hcengineering/server-client`, not per tool call (model load takes 1–3 s, so this keeps tools fast)
+- **Lazy init** — connects on the first tool call so auth errors surface clearly in Claude
+- **Dual auth** — OTP token (works for Google/GitHub SSO) or email + password
+- **Stdio transport** — standard MCP transport compatible with Claude Desktop and any MCP client
+
+---
+
+## License
+
+[Eclipse Public License 2.0](https://www.eclipse.org/legal/epl-2.0/)

package/dist/connection.d.ts

@@ -0,0 +1,5 @@
+import { type AccountClient } from '@hcengineering/account-client';
+import { TxOperations } from '@hcengineering/core';
+export declare function getConnection(): Promise<TxOperations>;
+export declare function getAccountClient(): Promise<AccountClient>;
+export declare function closeConnection(): Promise<void>;

package/dist/connection.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConnection = getConnection;
+exports.getAccountClient = getAccountClient;
+exports.closeConnection = closeConnection;
+const account_client_1 = require("@hcengineering/account-client");
+const core_1 = require("@hcengineering/core");
+const server_client_1 = require("@hcengineering/server-client");
+let state = null;
+let connectPromise = null;
+async function getConnection() {
+    if (state !== null)
+        return state.txClient;
+    if (connectPromise !== null)
+        return (await connectPromise).txClient;
+    connectPromise = connect();
+    state = await connectPromise;
+    connectPromise = null;
+    return state.txClient;
+}
+async function getAccountClient() {
+    if (state !== null)
+        return state.accountClient;
+    await getConnection();
+    return state.accountClient;
+}
+async function connect() {
+    const email = process.env.HULY_EMAIL;
+    const password = process.env.HULY_PASSWORD;
+    const workspaceUrl = process.env.HULY_WORKSPACE;
+    const hulyToken = process.env.HULY_TOKEN;
+    const accountsUrl = process.env.HULY_ACCOUNTS_URL ?? 'https://account.huly.app';
+    if (workspaceUrl == null) {
+        throw new Error('Missing required env var: HULY_WORKSPACE');
+    }
+    let socialId;
+    let endpoint;
+    let wsToken;
+    if (hulyToken != null) {
+        // Token-based auth — for SSO accounts (Google/GitHub login on huly.app)
+        // Get the token from your browser: huly.app → DevTools → Application →
+        // Local Storage → huly.app → look for the key "token"
+        const authedClient = (0, account_client_1.getClient)(accountsUrl, hulyToken);
+        const info = await authedClient.getLoginInfoByToken();
+        if (info == null) {
+            throw new Error('HULY_TOKEN is invalid or expired. Please get a fresh token from huly.app DevTools.');
+        }
+        if ('endpoint' in info && info.endpoint != null) {
+            // It's a WorkspaceLoginInfo — already has endpoint + workspace token
+            if (info.socialId == null) {
+                throw new Error('Token auth: no socialId in token. Try a workspace-scoped token.');
+            }
+            socialId = info.socialId;
+            endpoint = info.endpoint;
+            wsToken = info.token;
+        }
+        else if ('token' in info && info.token != null) {
+            // It's a plain LoginInfo (account-level token) — still need selectWorkspace
+            if (info.socialId == null) {
+                throw new Error('Token auth: no socialId returned.');
+            }
+            socialId = info.socialId;
+            const wsInfo = await authedClient.selectWorkspace(workspaceUrl, 'external');
+            if (wsInfo.endpoint == null || wsInfo.token == null) {
+                throw new Error(`Workspace '${workspaceUrl}' not found or not accessible.`);
+            }
+            endpoint = wsInfo.endpoint;
+            wsToken = wsInfo.token;
+        }
+        else {
+            throw new Error('Token auth: unexpected response from getLoginInfoByToken. Token may be incomplete.');
+        }
+    }
+    else {
+        // Email + password auth — for accounts with a password set on huly.app
+        if (email == null || password == null) {
+            throw new Error('Missing credentials. Provide HULY_TOKEN (for SSO accounts) or both HULY_EMAIL and HULY_PASSWORD.');
+        }
+        // Step 1: login → get account token + socialId
+        const unauthClient = (0, account_client_1.getClient)(accountsUrl);
+        const loginInfo = await unauthClient.login(email, password);
+        if (loginInfo.token == null) {
+            throw new Error('Login failed: no token returned. Check credentials.');
+        }
+        if (loginInfo.socialId == null) {
+            throw new Error('Login failed: no socialId returned.');
+        }
+        // Step 2: select workspace → get WS endpoint + workspace token
+        const authedAccountClient = (0, account_client_1.getClient)(accountsUrl, loginInfo.token);
+        const wsInfo = await authedAccountClient.selectWorkspace(workspaceUrl, 'external');
+        if (wsInfo.endpoint == null || wsInfo.token == null) {
+            throw new Error(`Workspace '${workspaceUrl}' not found or not accessible.`);
+        }
+        socialId = loginInfo.socialId;
+        endpoint = wsInfo.endpoint;
+        wsToken = wsInfo.token;
+    }
+    // Step 3: open WebSocket connection
+    const rawConnection = await (0, server_client_1.createClient)(endpoint, wsToken);
+    const txClient = new core_1.TxOperations(rawConnection, socialId);
+    // Build workspace-scoped account client for member lookups
+    const accountClient = (0, account_client_1.getClient)(accountsUrl, wsToken);
+    return { txClient, rawConnection, accountClient };
+}
+async function closeConnection() {
+    if (state !== null) {
+        await state.rawConnection.close();
+        state = null;
+    }
+}
+//# sourceMappingURL=connection.js.map

package/dist/connection.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const server_1 = require("./server");
+const connection_1 = require("./connection");
+async function main() {
+    const server = (0, server_1.createServer)();
+    const transport = new stdio_js_1.StdioServerTransport();
+    process.on('SIGINT', async () => {
+        await (0, connection_1.closeConnection)();
+        process.exit(0);
+    });
+    process.on('SIGTERM', async () => {
+        await (0, connection_1.closeConnection)();
+        process.exit(0);
+    });
+    await server.connect(transport);
+    // Process stays alive — connection maintained until shutdown
+}
+main().catch((err) => {
+    console.error('Fatal error starting huly-mcp:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,wEAAgF;AAChF,qCAAuC;AACvC,6CAA8C;AAE9C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAA,qBAAY,GAAE,CAAA;IAC7B,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAA;IAE5C,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC9B,MAAM,IAAA,4BAAe,GAAE,CAAA;QACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC,CAAC,CAAA;IACF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;QAC/B,MAAM,IAAA,4BAAe,GAAE,CAAA;QACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC,CAAC,CAAA;IAEF,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IAC/B,6DAA6D;AAC/D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,GAAG,CAAC,CAAA;IACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/schemas.d.ts

@@ -0,0 +1,177 @@
+import { z } from 'zod';
+export declare const GetProjectSchema: z.ZodObject<{
+    identifier: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    identifier: string;
+}, {
+    identifier: string;
+}>;
+export declare const ListIssuesSchema: z.ZodObject<{
+    projectIdentifier: z.ZodString;
+    status: z.ZodOptional<z.ZodString>;
+    priority: z.ZodOptional<z.ZodEnum<["NoPriority", "Urgent", "High", "Medium", "Low"]>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    projectIdentifier: string;
+    limit: number;
+    status?: string | undefined;
+    priority?: "Medium" | "NoPriority" | "Urgent" | "High" | "Low" | undefined;
+}, {
+    projectIdentifier: string;
+    status?: string | undefined;
+    priority?: "Medium" | "NoPriority" | "Urgent" | "High" | "Low" | undefined;
+    limit?: number | undefined;
+}>;
+export declare const GetIssueSchema: z.ZodObject<{
+    identifier: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    identifier: string;
+}, {
+    identifier: string;
+}>;
+export declare const CreateIssueSchema: z.ZodObject<{
+    projectIdentifier: z.ZodString;
+    title: z.ZodString;
+    priority: z.ZodDefault<z.ZodEnum<["NoPriority", "Urgent", "High", "Medium", "Low"]>>;
+    statusName: z.ZodOptional<z.ZodString>;
+    dueDate: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    projectIdentifier: string;
+    priority: "Medium" | "NoPriority" | "Urgent" | "High" | "Low";
+    statusName?: string | undefined;
+    dueDate?: string | undefined;
+}, {
+    title: string;
+    projectIdentifier: string;
+    priority?: "Medium" | "NoPriority" | "Urgent" | "High" | "Low" | undefined;
+    statusName?: string | undefined;
+    dueDate?: string | undefined;
+}>;
+export declare const DeleteIssueSchema: z.ZodObject<{
+    identifier: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    identifier: string;
+}, {
+    identifier: string;
+}>;
+export declare const UpdateIssueSchema: z.ZodObject<{
+    identifier: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    statusName: z.ZodOptional<z.ZodString>;
+    priority: z.ZodOptional<z.ZodEnum<["NoPriority", "Urgent", "High", "Medium", "Low"]>>;
+    dueDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    identifier: string;
+    title?: string | undefined;
+    priority?: "Medium" | "NoPriority" | "Urgent" | "High" | "Low" | undefined;
+    statusName?: string | undefined;
+    dueDate?: string | null | undefined;
+}, {
+    identifier: string;
+    title?: string | undefined;
+    priority?: "Medium" | "NoPriority" | "Urgent" | "High" | "Low" | undefined;
+    statusName?: string | undefined;
+    dueDate?: string | null | undefined;
+}>;
+export declare const AddCommentSchema: z.ZodObject<{
+    identifier: z.ZodString;
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    identifier: string;
+}, {
+    message: string;
+    identifier: string;
+}>;
+export declare const ListMilestonesSchema: z.ZodObject<{
+    projectIdentifier: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    projectIdentifier: string;
+}, {
+    projectIdentifier: string;
+}>;
+export declare const ListDocumentsSchema: z.ZodObject<{
+    teamspaceId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    teamspaceId: string;
+}, {
+    teamspaceId: string;
+}>;
+export declare const SearchIssuesSchema: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    query: string;
+}, {
+    query: string;
+    limit?: number | undefined;
+}>;
+export declare const ListLabelsSchema: z.ZodObject<{
+    projectIdentifier: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    projectIdentifier?: string | undefined;
+}, {
+    projectIdentifier?: string | undefined;
+}>;
+export declare const CreateLabelSchema: z.ZodObject<{
+    title: z.ZodString;
+    color: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    color?: string | undefined;
+}, {
+    title: string;
+    color?: string | undefined;
+}>;
+export declare const AddLabelSchema: z.ZodObject<{
+    identifier: z.ZodString;
+    labelName: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    identifier: string;
+    labelName: string;
+}, {
+    identifier: string;
+    labelName: string;
+}>;
+export declare const RemoveLabelSchema: z.ZodObject<{
+    identifier: z.ZodString;
+    labelName: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    identifier: string;
+    labelName: string;
+}, {
+    identifier: string;
+    labelName: string;
+}>;
+export declare const AddRelationSchema: z.ZodObject<{
+    identifier: z.ZodString;
+    relatedTo: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    identifier: string;
+    relatedTo: string;
+}, {
+    identifier: string;
+    relatedTo: string;
+}>;
+export declare const AddBlockedBySchema: z.ZodObject<{
+    identifier: z.ZodString;
+    blockedBy: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    identifier: string;
+    blockedBy: string;
+}, {
+    identifier: string;
+    blockedBy: string;
+}>;
+export declare const SetParentSchema: z.ZodObject<{
+    identifier: z.ZodString;
+    parentIdentifier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    identifier: string;
+    parentIdentifier?: string | null | undefined;
+}, {
+    identifier: string;
+    parentIdentifier?: string | null | undefined;
+}>;

package/dist/schemas.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SetParentSchema = exports.AddBlockedBySchema = exports.AddRelationSchema = exports.RemoveLabelSchema = exports.AddLabelSchema = exports.CreateLabelSchema = exports.ListLabelsSchema = exports.SearchIssuesSchema = exports.ListDocumentsSchema = exports.ListMilestonesSchema = exports.AddCommentSchema = exports.UpdateIssueSchema = exports.DeleteIssueSchema = exports.CreateIssueSchema = exports.GetIssueSchema = exports.ListIssuesSchema = exports.GetProjectSchema = void 0;
+const zod_1 = require("zod");
+const PriorityEnum = zod_1.z.enum(['NoPriority', 'Urgent', 'High', 'Medium', 'Low']);
+exports.GetProjectSchema = zod_1.z.object({
+    identifier: zod_1.z.string().describe('Project identifier, e.g. "PROJ"')
+});
+exports.ListIssuesSchema = zod_1.z.object({
+    projectIdentifier: zod_1.z.string().describe('Project identifier, e.g. "PROJ"'),
+    status: zod_1.z.string().optional().describe('Filter by status name, e.g. "In Progress"'),
+    priority: PriorityEnum.optional().describe('Filter by priority'),
+    limit: zod_1.z.number().int().min(1).max(250).default(50).describe('Max issues to return')
+});
+exports.GetIssueSchema = zod_1.z.object({
+    identifier: zod_1.z.string().describe('Issue identifier, e.g. "PROJ-123"')
+});
+exports.CreateIssueSchema = zod_1.z.object({
+    projectIdentifier: zod_1.z.string().describe('Project identifier, e.g. "PROJ"'),
+    title: zod_1.z.string().min(1).describe('Issue title'),
+    priority: PriorityEnum.default('NoPriority').describe('Issue priority'),
+    statusName: zod_1.z.string().optional().describe('Status name (defaults to project default)'),
+    dueDate: zod_1.z.string().optional().describe('Due date as ISO 8601 string, e.g. "2026-04-01"')
+});
+exports.DeleteIssueSchema = zod_1.z.object({
+    identifier: zod_1.z.string().describe('Issue identifier to delete, e.g. "PROJ-123"')
+});
+exports.UpdateIssueSchema = zod_1.z.object({
+    identifier: zod_1.z.string().describe('Issue identifier, e.g. "PROJ-123"'),
+    title: zod_1.z.string().optional().describe('New title'),
+    statusName: zod_1.z.string().optional().describe('New status name'),
+    priority: PriorityEnum.optional().describe('New priority'),
+    dueDate: zod_1.z.string().nullable().optional().describe('New due date (ISO 8601) or null to clear')
+});
+exports.AddCommentSchema = zod_1.z.object({
+    identifier: zod_1.z.string().describe('Issue identifier, e.g. "PROJ-123"'),
+    message: zod_1.z.string().min(1).describe('Comment text')
+});
+exports.ListMilestonesSchema = zod_1.z.object({
+    projectIdentifier: zod_1.z.string().describe('Project identifier, e.g. "PROJ"')
+});
+exports.ListDocumentsSchema = zod_1.z.object({
+    teamspaceId: zod_1.z.string().describe('Teamspace _id from list_teamspaces')
+});
+exports.SearchIssuesSchema = zod_1.z.object({
+    query: zod_1.z.string().min(1).describe('Search query'),
+    limit: zod_1.z.number().int().min(1).max(50).default(20).describe('Max results')
+});
+// ── Labels ────────────────────────────────────────────────────────────────────
+exports.ListLabelsSchema = zod_1.z.object({
+    projectIdentifier: zod_1.z.string().optional().describe('Optional project filter (currently returns all workspace labels)')
+});
+exports.CreateLabelSchema = zod_1.z.object({
+    title: zod_1.z.string().min(1).describe('Label name'),
+    color: zod_1.z.string().optional().describe('Hex color, e.g. "#FF6B6B" (optional)')
+});
+exports.AddLabelSchema = zod_1.z.object({
+    identifier: zod_1.z.string().describe('Issue identifier, e.g. "PROJ-123"'),
+    labelName: zod_1.z.string().min(1).describe('Label name to add (auto-created if it does not exist)')
+});
+exports.RemoveLabelSchema = zod_1.z.object({
+    identifier: zod_1.z.string().describe('Issue identifier, e.g. "PROJ-123"'),
+    labelName: zod_1.z.string().min(1).describe('Label name to remove')
+});
+// ── Relations ─────────────────────────────────────────────────────────────────
+exports.AddRelationSchema = zod_1.z.object({
+    identifier: zod_1.z.string().describe('Issue identifier, e.g. "PROJ-123"'),
+    relatedTo: zod_1.z.string().describe('Related issue identifier, e.g. "PROJ-456"')
+});
+exports.AddBlockedBySchema = zod_1.z.object({
+    identifier: zod_1.z.string().describe('Issue that is blocked, e.g. "PROJ-123"'),
+    blockedBy: zod_1.z.string().describe('Issue that blocks it, e.g. "PROJ-100"')
+});
+exports.SetParentSchema = zod_1.z.object({
+    identifier: zod_1.z.string().describe('Child issue identifier, e.g. "PROJ-123"'),
+    parentIdentifier: zod_1.z.string().nullable().optional().describe('Parent issue identifier, or null to clear parent')
+});
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createServer(): McpServer;