@blackenedd18/planio-connector 2026.623.3 → 2026.702.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blackenedd18/planio-connector",
-  "version": "2026.623.3",
+  "version": "2026.702.0",
   "description": "MCP server exposing Planio/Redmine operations (users, issues, projects, hours, time entries) over stdio",
   "type": "module",
   "main": "src/index.js",

package/src/modules/help/index.js

@@ -0,0 +1,79 @@
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { logDebug, logError } from '../../shared/logger.js';
+
+const WIKI_FORMATTING_HELP_URL =
+  'https://redmine.ameria.de/help/en/wiki_syntax_detailed_textile.html';
+
+export const TOOLS = [
+  {
+    name: 'get_wiki_formatting_help',
+    description:
+      'Returns the HTML help page describing Textile/wiki formatting syntax used in issue notes and descriptions.',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+      additionalProperties: false,
+    },
+  },
+];
+
+function logToolStart(name, args) {
+  logDebug('[help.dispatch] Handling tool', {
+    toolName: name,
+    argumentKeys: Object.keys(args || {}),
+  });
+}
+
+async function fetchWikiFormattingHelp() {
+  logDebug('[help.fetchWikiFormattingHelp] Fetching help page', {
+    url: WIKI_FORMATTING_HELP_URL,
+  });
+
+  const response = await fetch(WIKI_FORMATTING_HELP_URL);
+
+  if (!response.ok) {
+    throw new McpError(
+      ErrorCode.InternalError,
+      `Failed to fetch wiki formatting help page (${response.status}). Verify the help page is reachable at ${WIKI_FORMATTING_HELP_URL}.`
+    );
+  }
+
+  const html = await response.text();
+
+  logDebug('[help.fetchWikiFormattingHelp] Help page fetched', {
+    status: response.status,
+    contentLength: html.length,
+  });
+
+  return html;
+}
+
+export async function dispatch(name, args = {}) {
+  try {
+    switch (name) {
+      case 'get_wiki_formatting_help': {
+        logToolStart(name, args);
+        const html = await fetchWikiFormattingHelp();
+        return {
+          content: [{ type: 'text', text: html }],
+        };
+      }
+      default:
+        return null;
+    }
+  } catch (error) {
+    logError('[help.dispatch] Tool execution failed', {
+      toolName: name,
+      message: error?.message,
+    });
+
+    if (error instanceof McpError) {
+      throw error;
+    }
+
+    throw new McpError(
+      ErrorCode.InternalError,
+      `Wiki formatting help request failed: ${error?.message || 'Unknown error'}`
+    );
+  }
+}

package/src/modules/issues/index.js

@@ -141,6 +141,21 @@ export const TOOLS = [
       additionalProperties: false,
     },
   },
+  {
+    name: 'add_note_to_issue_by_id',
+    description:
+      'Add a note (comment) to an existing issue by its ID via PUT /issues/{issue_id}.json. Set private_notes to true to add a private note.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        issue_id: { type: 'number' },
+        notes: { type: 'string', description: 'The comment text to add to the issue.' },
+        private_notes: { type: 'boolean', description: 'Optional. Mark the note as private.' },
+      },
+      required: ['issue_id', 'notes'],
+      additionalProperties: false,
+    },
+  },
 ];
 
 function logToolStart(name, args) {
@@ -268,6 +283,16 @@ export async function dispatch(name, args = {}) {
         };
         return makeRequest('POST', 'issues', undefined, payload);
       }
+      case 'add_note_to_issue_by_id': {
+        logToolStart(name, args);
+        ensureRequiredNumber(args, 'issue_id');
+        ensureRequiredString(args, 'notes');
+        const payload = { notes: args.notes };
+        if (args.private_notes !== undefined && args.private_notes !== null) {
+          payload.private_notes = args.private_notes;
+        }
+        return makeRequest('PUT', `issues/${args.issue_id}`, undefined, payload);
+      }
       default:
         return null;
     }

package/src/server.js

@@ -15,10 +15,11 @@ import * as issues from './modules/issues/index.js';
 import * as projects from './modules/projects/index.js';
 import * as hours from './modules/hours/index.js';
 import * as timeEntries from './modules/time-entries/index.js';
+import * as help from './modules/help/index.js';
 
 const { version: SERVER_VERSION } = createRequire(import.meta.url)('../package.json');
 const SERVER_NAME = 'planio-connector-mcp';
-const MODULES = [users, issues, projects, hours, timeEntries];
+const MODULES = [users, issues, projects, hours, timeEntries, help];
 
 export class RedmineServer {
   constructor() {