teamflect-mcp-server 1.0.3

package/.env.example

@@ -0,0 +1,9 @@
+# Teamflect API Configuration
+TEAMFLECT_API_KEY=your-api-key-here
+
+# Transport Configuration
+# Options: 'stdio' (default) or 'http'
+TRANSPORT=stdio
+
+# HTTP Server Configuration (only used when TRANSPORT=http)
+PORT=3000

package/README.md

@@ -0,0 +1,177 @@
+# Teamflect MCP Server
+
+MCP (Model Context Protocol) server for Teamflect API integration. Provides tools to interact with Teamflect's performance management features including goals, feedback, recognitions, reviews, tasks, and user management.
+
+## Features
+
+- **Goals**: Get, create, update progress, and comment on goals
+- **Feedbacks**: Get feedbacks, send feedback requests (internal and external)
+- **Recognitions**: Get, search, and create recognitions
+- **Reviews**: Get reviews with filtering
+- **Tasks**: Get tasks and individual task details
+- **Users**: Get users, get user by email, update user attributes, and get available roles
+
+## Prerequisites
+
+- Node.js >= 18
+- Teamflect API key from https://admin.teamflect.com
+- MCP client (Claude Desktop or Cursor IDE)
+
+## Installation
+
+You can use it directly with `npx` (no installation needed) or install it globally.
+
+### Option 1: Use with npx (Recommended - No Installation)
+
+No installation required. Just use `npx` in your MCP client configuration (see Configuration section below).
+
+### Option 2: Install Globally
+
+```bash
+npm install -g teamflect-mcp-server
+```
+
+### Option 3: Install from Source
+
+For development or customization:
+
+```bash
+git clone <repository-url>
+cd teamflect-mcp-server
+npm install
+npm run build
+```
+
+## Configuration
+
+### 1. Get Your API Key
+
+Get your API key from https://admin.teamflect.com → Settings → API
+
+### 2. Configure MCP Client
+
+**Claude Desktop:** Edit `claude_desktop_config.json`
+- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Linux:** `~/.config/Claude/claude_desktop_config.json`
+
+**Cursor IDE:** Settings (Ctrl+,) → Search "MCP" → Edit settings.json
+
+**Recommended Configuration (using npm package):**
+```json
+{
+  "mcpServers": {
+    "teamflect": {
+      "command": "npx",
+      "args": ["-y", "teamflect-mcp-server"],
+      "env": {
+        "TEAMFLECT_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+**Alternative Configuration (source installation only):**
+```json
+{
+  "mcpServers": {
+    "teamflect": {
+      "command": "node",
+      "args": ["/absolute/path/to/teamflect-mcp-server/dist/index.js"],
+      "env": {
+        "TEAMFLECT_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+**Windows path format:** Use double backslashes `\\` in JSON: `"C:\\path\\to\\teamflect-mcp-server\\dist\\index.js"`
+
+### 3. Restart Your MCP Client
+
+After configuration, completely close and restart Claude Desktop or Cursor IDE.
+
+## Usage Examples
+
+- "Get all users from Teamflect"
+- "Get user john.doe@example.com"
+- "Get all goals"
+- "Create a new goal for Q1 2025"
+- "Get all feedbacks"
+- "Search for recognitions"
+
+## Available Tools
+
+### Goals
+- `teamflect_get_goals` - Get list of goals with filtering
+- `teamflect_get_goal` - Get a specific goal by ID
+- `teamflect_create_goal` - Create a new goal
+- `teamflect_update_goal_progress` - Update goal progress
+- `teamflect_comment_goal` - Add a comment to a goal
+
+### Feedbacks
+- `teamflect_get_feedbacks` - Get list of feedbacks
+- `teamflect_send_feedback_request` - Send internal feedback request
+- `teamflect_send_external_feedback_request` - Send external feedback request
+
+### Recognitions
+- `teamflect_get_recognition` - Get a specific recognition by ID
+- `teamflect_search_recognitions` - Search recognitions
+- `teamflect_create_recognition` - Create a new recognition
+
+### Reviews
+- `teamflect_get_reviews` - Get list of reviews with filtering
+
+### Tasks
+- `teamflect_get_tasks` - Get list of tasks
+- `teamflect_get_task` - Get a specific task by ID
+
+### Users
+- `teamflect_get_users` - Get list of users with filtering and pagination
+- `teamflect_get_user` - Get a specific user by email
+- `teamflect_update_user` - Update user attributes
+- `teamflect_get_roles` - Get available user roles
+
+## Troubleshooting
+
+**Server not starting:**
+- Check Node.js version: `node --version` (should be >= 18)
+- For source installation: Run `npm run build` and verify `dist/index.js` exists
+
+**Package not found:**
+- Verify package is published: `npm view teamflect-mcp-server`
+- Check npm registry: `npm config get registry` (should be https://registry.npmjs.org/)
+- Ensure you're connected to the internet
+
+**MCP client doesn't see server:**
+- Verify JSON syntax is valid (use https://jsonlint.com)
+- For source installation: Ensure `dist/index.js` exists (run `npm run build`)
+- Restart MCP client completely
+
+**Tools not working:**
+- Verify API key is correct and has necessary permissions
+- Test API directly: `curl https://api.teamflect.com/api/v1/user/getUsers -H "Authorization: Bearer YOUR_API_KEY"`
+
+## Environment Variables
+
+- `TEAMFLECT_API_KEY` (required): Your Teamflect API key
+- `TRANSPORT` (optional): `stdio` (default) or `http`
+- `PORT` (optional): Port for HTTP transport (default: 3000)
+
+## Development
+
+```bash
+npm run build    # Build the project
+npm run dev      # Run in development mode with watch
+npm start        # Run the server
+```
+
+## API Documentation
+
+https://api.teamflect.com/api/v1/
+
+## License
+
+MIT

package/dist/constants.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Constants for Teamflect MCP Server
+ */
+export declare const API_BASE_URL = "https://api.teamflect.com/api/v1";
+export declare const CHARACTER_LIMIT = 50000;
+export declare const DEFAULT_PAGE_SIZE = 200;
+export declare const MAX_PAGE_SIZE = 500;
+export declare const REQUEST_TIMEOUT = 30000;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,YAAY,qCAAqC,CAAC;AAC/D,eAAO,MAAM,eAAe,QAAQ,CAAC;AACrC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,aAAa,MAAM,CAAC;AACjC,eAAO,MAAM,eAAe,QAAQ,CAAC"}

package/dist/constants.js

@@ -0,0 +1,9 @@
+/**
+ * Constants for Teamflect MCP Server
+ */
+export const API_BASE_URL = "https://api.teamflect.com/api/v1";
+export const CHARACTER_LIMIT = 50000;
+export const DEFAULT_PAGE_SIZE = 200;
+export const MAX_PAGE_SIZE = 500;
+export const REQUEST_TIMEOUT = 30000; // 30 seconds
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,kCAAkC,CAAC;AAC/D,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AACrC,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AACrC,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AACjC,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,aAAa"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * Teamflect MCP Server
+ *
+ * This server provides tools to interact with Teamflect's performance management features
+ * including goals, feedback, recognitions, reviews, tasks, and user management.
+ */
+import "dotenv/config";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAGH,OAAO,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/**
+ * Teamflect MCP Server
+ *
+ * This server provides tools to interact with Teamflect's performance management features
+ * including goals, feedback, recognitions, reviews, tasks, and user management.
+ */
+// Load environment variables from .env file
+import "dotenv/config";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import express from "express";
+import { createApiClient } from "./services/apiClient.js";
+import { registerGoalTools } from "./tools/goals.js";
+import { registerFeedbackTools } from "./tools/feedbacks.js";
+import { registerRecognitionTools } from "./tools/recognitions.js";
+import { registerReviewTools } from "./tools/reviews.js";
+import { registerTaskTools } from "./tools/tasks.js";
+import { registerUserTools } from "./tools/users.js";
+// Create MCP server instance
+const server = new McpServer({
+    name: "teamflect-mcp-server",
+    version: "1.0.0",
+});
+// Initialize API client
+let apiClient;
+try {
+    apiClient = createApiClient();
+}
+catch (error) {
+    console.error("ERROR: Failed to initialize API client:", error.message);
+    process.exit(1);
+}
+// Register all tools (apiClient is guaranteed to be initialized here due to exit above)
+registerGoalTools(server, apiClient);
+registerFeedbackTools(server, apiClient);
+registerRecognitionTools(server, apiClient);
+registerReviewTools(server, apiClient);
+registerTaskTools(server, apiClient);
+registerUserTools(server, apiClient);
+/**
+ * Run server with stdio transport (for local integrations)
+ */
+async function runStdio() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Teamflect MCP server running via stdio");
+}
+/**
+ * Run server with streamable HTTP transport (for remote access)
+ */
+async function runHTTP() {
+    const app = express();
+    app.use(express.json());
+    app.post("/mcp", async (req, res) => {
+        // Create new transport for each request (stateless, prevents request ID collisions)
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: undefined,
+            enableJsonResponse: true,
+        });
+        res.on("close", () => transport.close());
+        await server.connect(transport);
+        await transport.handleRequest(req, res, req.body);
+    });
+    const port = parseInt(process.env.PORT || "3000", 10);
+    app.listen(port, () => {
+        console.error(`Teamflect MCP server running on http://localhost:${port}/mcp`);
+    });
+}
+// Choose transport based on environment variable
+const transport = process.env.TRANSPORT || "stdio";
+if (transport === "http") {
+    runHTTP().catch((error) => {
+        console.error("Server error:", error);
+        process.exit(1);
+    });
+}
+else {
+    runStdio().catch((error) => {
+        console.error("Server error:", error);
+        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":"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"}

package/dist/services/apiClient.d.ts

@@ -0,0 +1,29 @@
+/**
+ * HTTP client for Teamflect API
+ */
+export declare class TeamflectApiClient {
+    private client;
+    private apiKey;
+    constructor(apiKey: string);
+    /**
+     * GET request
+     */
+    get<T = any>(endpoint: string, params?: any): Promise<T>;
+    /**
+     * POST request
+     */
+    post<T = any>(endpoint: string, data?: any): Promise<T>;
+    /**
+     * PUT request
+     */
+    put<T = any>(endpoint: string, data?: any): Promise<T>;
+    /**
+     * DELETE request
+     */
+    delete<T = any>(endpoint: string): Promise<T>;
+}
+/**
+ * Create API client instance
+ */
+export declare function createApiClient(): TeamflectApiClient;
+//# sourceMappingURL=apiClient.d.ts.map

package/dist/services/apiClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiClient.d.ts","sourceRoot":"","sources":["../../src/services/apiClient.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IA+B1B;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAS9D;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAS7D;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAS5D;;OAEG;IACG,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAQpD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,kBAAkB,CAMpD"}

package/dist/services/apiClient.js

@@ -0,0 +1,92 @@
+import axios from "axios";
+import { API_BASE_URL, REQUEST_TIMEOUT } from "../constants.js";
+/**
+ * HTTP client for Teamflect API
+ */
+export class TeamflectApiClient {
+    client;
+    apiKey;
+    constructor(apiKey) {
+        if (!apiKey) {
+            throw new Error("TEAMFLECT_API_KEY environment variable is required");
+        }
+        this.apiKey = apiKey;
+        this.client = axios.create({
+            baseURL: API_BASE_URL,
+            timeout: REQUEST_TIMEOUT,
+            headers: {
+                "Content-Type": "application/json",
+                "Accept": "application/json",
+            },
+        });
+        // Add API key to all requests
+        this.client.interceptors.request.use((config) => {
+            config.headers["X-API-Key"] = this.apiKey;
+            return config;
+        });
+        // Handle errors globally
+        this.client.interceptors.response.use((response) => response, (error) => {
+            // Error will be handled by handleApiError in tool handlers
+            return Promise.reject(error);
+        });
+    }
+    /**
+     * GET request
+     */
+    async get(endpoint, params) {
+        try {
+            const response = await this.client.get(endpoint, { params });
+            return response.data;
+        }
+        catch (error) {
+            throw error;
+        }
+    }
+    /**
+     * POST request
+     */
+    async post(endpoint, data) {
+        try {
+            const response = await this.client.post(endpoint, data);
+            return response.data;
+        }
+        catch (error) {
+            throw error;
+        }
+    }
+    /**
+     * PUT request
+     */
+    async put(endpoint, data) {
+        try {
+            const response = await this.client.put(endpoint, data);
+            return response.data;
+        }
+        catch (error) {
+            throw error;
+        }
+    }
+    /**
+     * DELETE request
+     */
+    async delete(endpoint) {
+        try {
+            const response = await this.client.delete(endpoint);
+            return response.data;
+        }
+        catch (error) {
+            throw error;
+        }
+    }
+}
+/**
+ * Create API client instance
+ */
+export function createApiClient() {
+    const apiKey = process.env.TEAMFLECT_API_KEY;
+    if (!apiKey) {
+        throw new Error("TEAMFLECT_API_KEY environment variable is required");
+    }
+    return new TeamflectApiClient(apiKey);
+}
+//# sourceMappingURL=apiClient.js.map

package/dist/services/apiClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiClient.js","sourceRoot":"","sources":["../../src/services/apiClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAA2D,MAAM,OAAO,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGhE;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACrB,MAAM,CAAgB;IACtB,MAAM,CAAS;IAEvB,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YACzB,OAAO,EAAE,YAAY;YACrB,OAAO,EAAE,eAAe;YACxB,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,QAAQ,EAAE,kBAAkB;aAC7B;SACF,CAAC,CAAC;QAEH,8BAA8B;QAC9B,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YAC9C,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;YAC1C,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,yBAAyB;QACzB,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CACnC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,EACtB,CAAC,KAAK,EAAE,EAAE;YACR,2DAA2D;YAC3D,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC,CACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAU,QAAgB,EAAE,MAAY;QAC/C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAqB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAC/E,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAU,QAAgB,EAAE,IAAU;QAC9C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAqB,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC1E,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAU,QAAgB,EAAE,IAAU;QAC7C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAqB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YACzE,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAU,QAAgB;QACpC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAqB,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACtE,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC"}

package/dist/services/errorHandler.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Centralized error handling for API errors
+ */
+export declare function handleApiError(error: unknown): string;
+//# sourceMappingURL=errorHandler.d.ts.map

package/dist/services/errorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.d.ts","sourceRoot":"","sources":["../../src/services/errorHandler.ts"],"names":[],"mappings":"AA4CA;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAmDrD"}

package/dist/services/errorHandler.js

@@ -0,0 +1,93 @@
+import { AxiosError } from "axios";
+/**
+ * Safely extract error message from various error formats
+ */
+function extractErrorMessage(errorData) {
+    if (!errorData)
+        return "";
+    // If it's already a string, return it
+    if (typeof errorData === "string") {
+        return errorData;
+    }
+    // Try common error message fields
+    if (errorData.message) {
+        return typeof errorData.message === "string" ? errorData.message : JSON.stringify(errorData.message);
+    }
+    if (errorData.error) {
+        return typeof errorData.error === "string" ? errorData.error : JSON.stringify(errorData.error);
+    }
+    if (errorData.errors && Array.isArray(errorData.errors)) {
+        return errorData.errors.map((e) => typeof e === "string" ? e : JSON.stringify(e)).join(", ");
+    }
+    // If it's an object, try to stringify it nicely
+    if (typeof errorData === "object") {
+        try {
+            const str = JSON.stringify(errorData);
+            // If the stringified version is reasonable, use it
+            if (str.length < 200) {
+                return str;
+            }
+            // Otherwise, just return a generic message
+            return "Please check your input parameters.";
+        }
+        catch {
+            return "Please check your input parameters.";
+        }
+    }
+    return String(errorData);
+}
+/**
+ * Centralized error handling for API errors
+ */
+export function handleApiError(error) {
+    if (error instanceof AxiosError) {
+        if (error.response) {
+            const status = error.response.status;
+            const errorData = error.response.data;
+            const errorMessage = extractErrorMessage(errorData) || error.message;
+            switch (status) {
+                case 400:
+                    return `Error: Bad request. ${errorMessage || "Please check your input parameters."}`;
+                case 401:
+                    return "Error: Authentication failed. Please check your TEAMFLECT_API_KEY environment variable.";
+                case 403:
+                    return `Error: Permission denied. ${errorMessage || "You don't have access to this resource."}`;
+                case 404:
+                    return `Error: Resource not found. ${errorMessage || "Please check the ID or parameters are correct."}`;
+                case 429:
+                    const retryAfter = error.response.headers["retry-after"];
+                    const retryMsg = retryAfter
+                        ? ` Please retry after ${retryAfter} seconds.`
+                        : " Please wait before making more requests.";
+                    return `Error: Rate limit exceeded.${retryMsg}`;
+                case 500:
+                    return `Error: Internal server error. ${errorMessage || "Please try again later."}`;
+                default:
+                    return `Error: API request failed with status ${status}. ${errorMessage || ""}`;
+            }
+        }
+        else if (error.code === "ECONNABORTED") {
+            return "Error: Request timed out. Please try again.";
+        }
+        else if (error.code === "ENOTFOUND" || error.code === "ECONNREFUSED") {
+            return "Error: Could not connect to Teamflect API. Please check your internet connection.";
+        }
+        else if (error.message) {
+            // Handle other axios errors
+            if (error.message.includes("aborted")) {
+                return "Error: Request was aborted. This may be due to a timeout or cancellation.";
+            }
+            return `Error: ${error.message}`;
+        }
+    }
+    // Handle non-Axios errors
+    if (error instanceof Error) {
+        return `Error: ${error.message}`;
+    }
+    // Handle string errors
+    if (typeof error === "string") {
+        return `Error: ${error}`;
+    }
+    return `Error: Unexpected error occurred: ${String(error)}`;
+}
+//# sourceMappingURL=errorHandler.js.map

package/dist/services/errorHandler.js.map

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

package/dist/tools/feedbacks.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { TeamflectApiClient } from "../services/apiClient.js";
+/**
+ * Register feedback-related tools
+ */
+export declare function registerFeedbackTools(server: McpServer, apiClient: TeamflectApiClient): void;
+//# sourceMappingURL=feedbacks.d.ts.map

package/dist/tools/feedbacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedbacks.d.ts","sourceRoot":"","sources":["../../src/tools/feedbacks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAK9D;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,kBAAkB,GAAG,IAAI,CA8Y5F"}