@dpesch/mantisbt-mcp-server 1.5.9 → 1.6.1

package/dist/tools/config.js

@@ -25,6 +25,49 @@ function resolveCanonicalName(id, name, canonicalMap) {
     const canonical = canonicalMap[id];
     return canonical !== undefined && canonical !== name ? canonical : undefined;
 }
+export async function fetchIssueEnums(client) {
+    const params = {};
+    ISSUE_ENUM_OPTIONS.forEach((opt, i) => {
+        params[`option[${i}]`] = opt;
+    });
+    const result = await client.get('config', params);
+    const configs = result.configs ?? [];
+    const keyMap = {
+        severity_enum_string: 'severity',
+        status_enum_string: 'status',
+        priority_enum_string: 'priority',
+        resolution_enum_string: 'resolution',
+        reproducibility_enum_string: 'reproducibility',
+    };
+    const enums = {};
+    for (const { option, value } of configs) {
+        const key = keyMap[option];
+        if (!key)
+            continue;
+        const canonicalMap = MANTIS_CANONICAL_ENUM_NAMES[key] ?? {};
+        if (typeof value === 'string') {
+            enums[key] = parseEnumString(value).map(({ id, name }) => {
+                const entry = { id, name };
+                const canonical_name = resolveCanonicalName(id, name, canonicalMap);
+                if (canonical_name !== undefined)
+                    entry.canonical_name = canonical_name;
+                return entry;
+            });
+        }
+        else if (Array.isArray(value)) {
+            enums[key] = value.map(({ id, name, label }) => {
+                const entry = { id, name };
+                if (label && label !== name)
+                    entry.label = label;
+                const canonical_name = resolveCanonicalName(id, name, canonicalMap);
+                if (canonical_name !== undefined)
+                    entry.canonical_name = canonical_name;
+                return entry;
+            });
+        }
+    }
+    return enums;
+}
 export function registerConfigTools(server, client, cache) {
     // ---------------------------------------------------------------------------
     // get_config
@@ -116,46 +159,7 @@ to use for API calls — regardless of language.`,
         },
     }, async () => {
         try {
-            const params = {};
-            ISSUE_ENUM_OPTIONS.forEach((opt, i) => {
-                params[`option[${i}]`] = opt;
-            });
-            const result = await client.get('config', params);
-            const configs = result.configs ?? [];
-            const keyMap = {
-                severity_enum_string: 'severity',
-                status_enum_string: 'status',
-                priority_enum_string: 'priority',
-                resolution_enum_string: 'resolution',
-                reproducibility_enum_string: 'reproducibility',
-            };
-            const enums = {};
-            for (const { option, value } of configs) {
-                const key = keyMap[option];
-                if (!key)
-                    continue;
-                const canonicalMap = MANTIS_CANONICAL_ENUM_NAMES[key] ?? {};
-                if (typeof value === 'string') {
-                    enums[key] = parseEnumString(value).map(({ id, name }) => {
-                        const entry = { id, name };
-                        const canonical_name = resolveCanonicalName(id, name, canonicalMap);
-                        if (canonical_name !== undefined)
-                            entry.canonical_name = canonical_name;
-                        return entry;
-                    });
-                }
-                else if (Array.isArray(value)) {
-                    enums[key] = value.map(({ id, name, label }) => {
-                        const entry = { id, name };
-                        if (label && label !== name)
-                            entry.label = label;
-                        const canonical_name = resolveCanonicalName(id, name, canonicalMap);
-                        if (canonical_name !== undefined)
-                            entry.canonical_name = canonical_name;
-                        return entry;
-                    });
-                }
-            }
+            const enums = await fetchIssueEnums(client);
             return {
                 content: [{ type: 'text', text: JSON.stringify(enums, null, 2) }],
             };

package/docs/cookbook.de.md

@@ -50,6 +50,15 @@ Tool-orientierte Rezepte für den MantisBT MCP Server — jedes Rezept zeigt gen
   - [MCP-Server-Version abrufen](#mcp-server-version-abrufen)
   - [MantisBT-Version abrufen](#mantisbt-version-abrufen)
   - [Aktuellen Benutzer abrufen](#aktuellen-benutzer-abrufen)
+- [Ressourcen](#ressourcen)
+  - [Eigenes Benutzerprofil lesen](#eigenes-benutzerprofil-lesen)
+  - [Alle Projekte lesen](#alle-projekte-lesen)
+  - [Issue-Enum-Werte lesen](#issue-enum-werte-lesen)
+- [Prompts](#prompts)
+  - [Bug-Report erstellen](#bug-report-erstellen)
+  - [Feature-Request erstellen](#feature-request-erstellen)
+  - [Issue zusammenfassen](#issue-zusammenfassen)
+  - [Projekt-Status-Report](#projekt-status-report)
 - [Destruktive Operationen](#destruktive-operationen)
   - [Issue löschen](#issue-löschen)
 
@@ -1416,6 +1425,215 @@ Gibt das Profil des Benutzers zurück, der dem konfigurierten API-Key zugeordnet
 
 ---
 
+## Ressourcen
+
+MCP-Ressourcen sind URI-adressierbare, schreibgeschützte Daten. Clients, die Ressourcen unterstützen, können sie direkt per URI abrufen — kein Tool-Aufruf nötig. Hinweis: Ressourcen werden von MCP-Clients weniger breit unterstützt als Tools; bitte die Dokumentation des jeweiligen Clients prüfen.
+
+> **Hinweis:** Ressourcen sind schreibgeschützt. Schreiboperationen sind über das Ressourcen-Primitiv nicht möglich — für Änderungen das entsprechende Tool verwenden (`create_issue`, `update_issue` usw.).
+
+### Eigenes Benutzerprofil lesen
+
+Gibt das Profil des authentifizierten API-Benutzers zurück.
+
+**Ressource-URI:** `mantis://me`
+
+**Abrufverhalten:** Immer live — ruft bei jedem Zugriff `GET /users/me` auf.
+
+**Response:**
+
+```json
+{
+  "id": 4,
+  "name": "jsmith",
+  "real_name": "John Smith",
+  "email": "jsmith@example.com",
+  "access_level": { "id": 55, "name": "developer" }
+}
+```
+
+> **Tipp:** Das Tool `get_current_user` liefert dieselben Daten für Clients ohne Ressourcen-Unterstützung.
+
+---
+
+### Alle Projekte lesen
+
+Gibt alle MantisBT-Projekte zurück, auf die der konfigurierte API-Key Zugriff hat.
+
+**Ressource-URI:** `mantis://projects`
+
+**Abrufverhalten:** Wird aus dem MetadataCache bedient (Standard-TTL 24 h). Fällt auf einen Live-API-Aufruf zurück, wenn der Cache leer ist. `sync_metadata` aufrufen, um eine Aktualisierung zu erzwingen.
+
+**Response:**
+
+```json
+[
+  { "id": 3, "name": "Webshop", "status": { "id": 10, "name": "development" }, "enabled": true },
+  { "id": 5, "name": "Backend API", "status": { "id": 10, "name": "development" }, "enabled": true }
+]
+```
+
+> **Tipp:** Das Tool `list_projects` liefert dieselben Daten für Clients ohne Ressourcen-Unterstützung.
+
+---
+
+### Issue-Enum-Werte lesen
+
+Gibt gültige ID/Name-Paare für alle Issue-Enum-Felder zurück (Severity, Priority, Status, Resolution, Reproducibility). Vor `create_issue` oder `update_issue` verwenden, um kanonische englische Namen nachzuschlagen.
+
+**Ressource-URI:** `mantis://enums`
+
+**Abrufverhalten:** Immer live — ruft bei jedem Zugriff den MantisBT-Config-Endpoint auf.
+
+**Response:**
+
+```json
+{
+  "priorities": [
+    { "id": 10, "name": "none" },
+    { "id": 20, "name": "low" },
+    { "id": 30, "name": "normal" },
+    { "id": 40, "name": "high" },
+    { "id": 50, "name": "urgent" },
+    { "id": 60, "name": "immediate" }
+  ],
+  "severities": [
+    { "id": 10, "name": "feature" },
+    { "id": 20, "name": "trivial" },
+    { "id": 50, "name": "major" },
+    { "id": 60, "name": "crash" }
+  ],
+  "statuses": [
+    { "id": 10, "name": "new" },
+    { "id": 50, "name": "assigned" },
+    { "id": 80, "name": "resolved" },
+    { "id": 90, "name": "closed" }
+  ],
+  "resolutions": [
+    { "id": 10, "name": "open" },
+    { "id": 20, "name": "fixed" },
+    { "id": 60, "name": "duplicate" }
+  ]
+}
+```
+
+> **Tipp:** Das Tool `get_issue_enums` liefert dieselben Daten für Clients ohne Ressourcen-Unterstützung.
+
+---
+
+## Prompts
+
+MCP-Prompt-Templates starten eine geführte Unterhaltung — der Client sendet die Prompt-Argumente und der Server liefert eine vorgefertigte Nachricht, die den LLM anweist, die passenden Tools aufzurufen. Beispiele in natürlicher Sprache sind in [examples.de.md](examples.de.md) zu finden.
+
+### Bug-Report erstellen
+
+Sammelt strukturierte Bug-Daten und ruft `create_issue` auf.
+
+**Prompt:** `create-bug-report`
+
+**Pflichtargumente:**
+- `project_id` — numerische Projekt-ID
+- `category` — Kategoriename
+- `summary` — Issue-Titel
+- `description` — detaillierte Fehlerbeschreibung
+
+**Optionale Argumente:**
+- `steps_to_reproduce` — Schritte zur Reproduktion
+- `expected` — erwartetes Verhalten
+- `actual` — tatsächliches (beobachtetes) Verhalten
+- `environment` — Umgebungsangaben (Betriebssystem, Browser, Version usw.)
+
+**Ablauf:** Der Prompt liefert eine Nachricht, die den LLM anweist, zunächst `get_issue_enums` aufzurufen (um gültige Schweregrad- und Prioritätswerte zu ermitteln) und anschließend `create_issue` mit den übergebenen Daten auszuführen.
+
+**Beispielaufruf:**
+
+```json
+{
+  "project_id": 3,
+  "category": "UI",
+  "summary": "Login-Button reagiert auf Mobile Safari nicht",
+  "description": "Ein Tipp auf den Login-Button auf einem iPhone 14 / Safari 17 bewirkt nichts.",
+  "steps_to_reproduce": "1. Login-Seite auf iPhone 14 öffnen\n2. Auf 'Anmelden' tippen\n3. Nichts passiert",
+  "expected": "Benutzer wird angemeldet und zum Dashboard weitergeleitet",
+  "actual": "Die Seite bleibt auf dem Login-Formular, keine Fehlermeldung",
+  "environment": "iPhone 14, iOS 17, Safari 17"
+}
+```
+
+---
+
+### Feature-Request erstellen
+
+Sammelt Feature-Details und ruft `create_issue` auf.
+
+**Prompt:** `create-feature-request`
+
+**Pflichtargumente:**
+- `project_id` — numerische Projekt-ID
+- `category` — Kategoriename
+- `summary` — Feature-Titel
+- `description` — detaillierte Beschreibung des Features
+
+**Optionale Argumente:**
+- `use_case` — konkreter Anwendungsfall oder Motivation für das Feature
+
+**Ablauf:** Der Prompt liefert eine Nachricht, die den LLM anweist, `create_issue` mit dem Schweregrad `feature` aufzurufen.
+
+**Beispielaufruf:**
+
+```json
+{
+  "project_id": 5,
+  "category": "UX",
+  "summary": "Dunkelmodus für Benutzereinstellungen",
+  "description": "Einen Dunkelmodus-Schalter auf der Seite mit den Benutzereinstellungen hinzufügen.",
+  "use_case": "Benutzer, die in schlecht beleuchteten Umgebungen arbeiten, berichten über Augenbelastung durch die aktuelle helle Benutzeroberfläche."
+}
+```
+
+---
+
+### Issue zusammenfassen
+
+Ruft ein einzelnes Issue ab und liefert eine prägnante Zusammenfassung.
+
+**Prompt:** `summarize-issue`
+
+**Pflichtargumente:**
+- `issue_id` — numerische Issue-ID
+
+**Ablauf:** Der Prompt liefert eine Nachricht, die den LLM anweist, `get_issue` aufzurufen und das Ergebnis zusammenzufassen — inklusive Status, Priorität, aktueller Notizen und empfohlener nächster Schritte.
+
+**Beispielaufruf:**
+
+```json
+{
+  "issue_id": 1042
+}
+```
+
+---
+
+### Projekt-Status-Report
+
+Listet alle Issues eines Projekts auf und erstellt einen Status-Report nach Schweregrad.
+
+**Prompt:** `project-status`
+
+**Pflichtargumente:**
+- `project_id` — numerische Projekt-ID
+
+**Ablauf:** Der Prompt liefert eine Nachricht, die den LLM anweist, `list_issues` für das Projekt aufzurufen und einen strukturierten Report zu erstellen: Anzahl offener Issues, Aufschlüsselung nach Schweregrad und eine Liste der kritischsten Einträge.
+
+**Beispielaufruf:**
+
+```json
+{
+  "project_id": 3
+}
+```
+
+---
+
 ## Destruktive Operationen
 
 ### Issue löschen

package/docs/cookbook.md

@@ -50,6 +50,15 @@ Tool-oriented recipes for the MantisBT MCP server — each recipe shows exactly
   - [Get MCP server version](#get-mcp-server-version)
   - [Get MantisBT version](#get-mantis-version)
   - [Get the current user](#get-the-current-user)
+- [Resources](#resources)
+  - [Read the current user profile](#read-the-current-user-profile)
+  - [Read all projects](#read-all-projects)
+  - [Read issue enum values](#read-issue-enum-values)
+- [Prompts](#prompts)
+  - [Create a bug report](#create-a-bug-report)
+  - [Create a feature request](#create-a-feature-request)
+  - [Summarize an issue](#summarize-an-issue)
+  - [Project status report](#project-status-report)
 - [Destructive Operations](#destructive-operations)
   - [Delete an issue](#delete-an-issue)
 
@@ -1416,6 +1425,215 @@ Returns the profile of the user associated with the configured API key. Useful t
 
 ---
 
+## Resources
+
+MCP Resources are URI-addressable, read-only data. Clients that support Resources can fetch them directly by URI — no tool call required. Note that Resource support is less widely implemented in MCP clients than Tools; check your client's documentation.
+
+> **Note:** Resources are read-only. Writing to them is not possible via the Resource primitive — use the corresponding tool (`create_issue`, `update_issue`, etc.) for write operations.
+
+### Read the current user profile
+
+Returns the profile of the authenticated API user.
+
+**Resource URI:** `mantis://me`
+
+**Fetch behaviour:** Always live — calls `GET /users/me` on every access.
+
+**Response:**
+
+```json
+{
+  "id": 4,
+  "name": "jsmith",
+  "real_name": "John Smith",
+  "email": "jsmith@example.com",
+  "access_level": { "id": 55, "name": "developer" }
+}
+```
+
+> **Tip:** The `get_current_user` tool provides the same data for clients that do not support Resources.
+
+---
+
+### Read all projects
+
+Returns all MantisBT projects accessible with the configured API key.
+
+**Resource URI:** `mantis://projects`
+
+**Fetch behaviour:** Served from the MetadataCache (default TTL 24 h). Falls back to a live API call when the cache is empty. Run `sync_metadata` to force a refresh.
+
+**Response:**
+
+```json
+[
+  { "id": 3, "name": "Webshop", "status": { "id": 10, "name": "development" }, "enabled": true },
+  { "id": 5, "name": "Backend API", "status": { "id": 10, "name": "development" }, "enabled": true }
+]
+```
+
+> **Tip:** The `list_projects` tool provides the same data for clients that do not support Resources.
+
+---
+
+### Read issue enum values
+
+Returns valid ID/name pairs for all issue enum fields (severity, priority, status, resolution, reproducibility). Use this to look up canonical English names before calling `create_issue` or `update_issue`.
+
+**Resource URI:** `mantis://enums`
+
+**Fetch behaviour:** Always live — calls the MantisBT config endpoint on every access.
+
+**Response:**
+
+```json
+{
+  "priorities": [
+    { "id": 10, "name": "none" },
+    { "id": 20, "name": "low" },
+    { "id": 30, "name": "normal" },
+    { "id": 40, "name": "high" },
+    { "id": 50, "name": "urgent" },
+    { "id": 60, "name": "immediate" }
+  ],
+  "severities": [
+    { "id": 10, "name": "feature" },
+    { "id": 20, "name": "trivial" },
+    { "id": 50, "name": "major" },
+    { "id": 60, "name": "crash" }
+  ],
+  "statuses": [
+    { "id": 10, "name": "new" },
+    { "id": 50, "name": "assigned" },
+    { "id": 80, "name": "resolved" },
+    { "id": 90, "name": "closed" }
+  ],
+  "resolutions": [
+    { "id": 10, "name": "open" },
+    { "id": 20, "name": "fixed" },
+    { "id": 60, "name": "duplicate" }
+  ]
+}
+```
+
+> **Tip:** The `get_issue_enums` tool provides the same data for clients that do not support Resources.
+
+---
+
+## Prompts
+
+MCP prompt templates initiate a guided conversation — the client sends the prompt arguments and the server returns a pre-filled message that instructs the LLM to call the appropriate tools. For natural language equivalents, see [examples.md](examples.md).
+
+### Create a bug report
+
+Collects structured bug data and calls `create_issue`.
+
+**Prompt:** `create-bug-report`
+
+**Required arguments:**
+- `project_id` — numeric project ID
+- `category` — category name string
+- `summary` — issue title
+- `description` — detailed description of the bug
+
+**Optional arguments:**
+- `steps_to_reproduce` — step-by-step reproduction instructions
+- `expected` — expected behavior
+- `actual` — actual (observed) behavior
+- `environment` — environment details (OS, browser, version, etc.)
+
+**What happens:** The prompt returns a message that instructs the LLM to call `get_issue_enums` (to resolve valid severity/priority values) and then `create_issue` with the provided data.
+
+**Example call:**
+
+```json
+{
+  "project_id": 3,
+  "category": "UI",
+  "summary": "Login button unresponsive on mobile Safari",
+  "description": "Tapping the login button on iPhone 14 / Safari 17 does nothing.",
+  "steps_to_reproduce": "1. Open login page on iPhone 14\n2. Tap 'Login'\n3. Nothing happens",
+  "expected": "User is logged in and redirected to dashboard",
+  "actual": "Page stays on login form, no error message",
+  "environment": "iPhone 14, iOS 17, Safari 17"
+}
+```
+
+---
+
+### Create a feature request
+
+Collects feature details and calls `create_issue`.
+
+**Prompt:** `create-feature-request`
+
+**Required arguments:**
+- `project_id` — numeric project ID
+- `category` — category name string
+- `summary` — feature title
+- `description` — detailed description of the feature
+
+**Optional arguments:**
+- `use_case` — concrete use case or motivation for the feature
+
+**What happens:** The prompt returns a message that instructs the LLM to call `create_issue` with severity `feature`.
+
+**Example call:**
+
+```json
+{
+  "project_id": 5,
+  "category": "UX",
+  "summary": "Dark mode for user settings",
+  "description": "Add a dark mode toggle to the user settings page.",
+  "use_case": "Users working in low-light environments report eye strain with the current bright UI."
+}
+```
+
+---
+
+### Summarize an issue
+
+Fetches a single issue and returns a concise summary.
+
+**Prompt:** `summarize-issue`
+
+**Required arguments:**
+- `issue_id` — numeric issue ID
+
+**What happens:** The prompt returns a message that instructs the LLM to call `get_issue` and summarize the result — including status, priority, recent notes, and suggested next steps.
+
+**Example call:**
+
+```json
+{
+  "issue_id": 1042
+}
+```
+
+---
+
+### Project status report
+
+Lists all issues for a project and generates a status report grouped by severity.
+
+**Prompt:** `project-status`
+
+**Required arguments:**
+- `project_id` — numeric project ID
+
+**What happens:** The prompt returns a message that instructs the LLM to call `list_issues` for the project and produce a structured report: open issue count, breakdown by severity, and a list of the most critical items.
+
+**Example call:**
+
+```json
+{
+  "project_id": 3
+}
+```
+
+---
+
 ## Destructive Operations
 
 ### Delete an issue

package/docs/examples.de.md

@@ -109,6 +109,24 @@ Praktische Beispiele für die Interaktion mit MantisBT über Claude, sobald der
 
 ---
 
+## Geführte Prompt-Workflows
+
+Der Server enthält Prompt-Templates, die Claude durch strukturierte Arbeitsabläufe führen — Tool-Namen oder Parameter müssen nicht manuell angegeben werden. Die Prompts werden aus einem MCP-fähigen Client beim Namen aufgerufen.
+
+### Issues über Prompt-Templates anlegen
+
+> »Verwende den Prompt `create-bug-report` für das Safari-Login-Issue: Projekt 3, Kategorie UI, Titel 'Login-Button reagiert auf Mobile Safari nicht', Beschreibung 'Ein Tipp auf den Login-Button auf iPhone 14 / Safari 17 bewirkt nichts', Schritte: Login-Seite öffnen → Anmelden antippen → nichts passiert, Erwartet: Weiterleitung zum Dashboard, Tatsächlich: Formular bleibt geöffnet.«
+
+> »Nutze `create-feature-request` für Projekt 5, Kategorie UX: Dunkelmodus-Schalter auf der Einstellungsseite hinzufügen.«
+
+### Zusammenfassen und Berichten
+
+> »Führe den Prompt `summarize-issue` für Issue #1042 aus.«
+
+> »Verwende den Prompt `project-status` für Projekt 3, um einen Überblick über offene Issues nach Schweregrad zu erhalten.«
+
+---
+
 ## Semantische Suche
 
 Die semantische Suche versteht die *Bedeutung* deiner Frage — nicht nur einzelne Schlüsselwörter. Sie findet konzeptionell verwandte Issues, auch wenn die genaue Formulierung abweicht. Aktivierung mit `MANTIS_SEARCH_ENABLED=true`.
@@ -156,3 +174,27 @@ Die semantische Suche versteht die *Bedeutung* deiner Frage — nicht nur einzel
 > »Gibt es bekannte Fallstricke beim Einrichten der Deployment-Pipeline?«
 
 > »Welche Issues beschreiben Probleme, die beim ersten Einrichten der Entwicklungsumgebung auftreten?«
+
+---
+
+## Ressourcen
+
+MCP-Ressourcen sind URI-adressierbare, schreibgeschützte Daten, die Clients direkt per URI abrufen können — kein Tool-Aufruf nötig. Die Ressourcen-Unterstützung variiert je nach Client; wenn der verwendete Client keine Ressourcen unterstützt, das entsprechende Tool als Alternative verwenden.
+
+### Server-Zustand über Ressourcen abrufen
+
+> »Lese `mantis://me`, um zu sehen, welches Konto der MCP-Server verwendet.«
+
+> »Rufe `mantis://projects` ab, um die Liste der verfügbaren Projekte zu erhalten.«
+
+> »Lade `mantis://enums`, um die gültigen Severity- und Priority-Werte einzusehen, bevor ein Issue erstellt wird.«
+
+### Alternative Tools für Clients ohne Ressourcen-Unterstützung
+
+Wenn der Client keine Ressourcen unterstützt, Claude einfach das entsprechende Tool verwenden lassen:
+
+> »Zeig mir mein Benutzerprofil.« *(verwendet `get_current_user`)*
+
+> »Welche Projekte sind verfügbar?« *(verwendet `list_projects`)*
+
+> »Welche Prioritätswerte sind gültig?« *(verwendet `get_issue_enums`)*

package/docs/examples.md

@@ -109,6 +109,24 @@ Practical examples of how to interact with MantisBT through Claude once the MCP
 
 ---
 
+## Guided Prompt Workflows
+
+The server ships with prompt templates that guide Claude through structured workflows — no need to specify tool names or parameters manually. Invoke them by name from a MCP-capable client.
+
+### Creating issues from a prompt template
+
+> "Use the `create-bug-report` prompt to file the Safari login issue: project 3, category UI, summary 'Login button unresponsive on mobile Safari', description 'Tapping login on iPhone 14 / Safari 17 does nothing', steps: open login page → tap Login → nothing happens, expected: redirect to dashboard, actual: form stays open."
+
+> "Use `create-feature-request` for project 5, category UX: add a dark mode toggle to the settings page."
+
+### Summarizing and reporting
+
+> "Run the `summarize-issue` prompt for issue #1042."
+
+> "Use the `project-status` prompt for project 3 to get an overview of open issues grouped by severity."
+
+---
+
 ## Semantic Search
 
 Semantic search understands the *meaning* of your question — not just keywords. It finds conceptually related issues even when the exact wording differs. Enable it with `MANTIS_SEARCH_ENABLED=true`.
@@ -156,3 +174,27 @@ Semantic search understands the *meaning* of your question — not just keywords
 > "Are there any known pitfalls when setting up the deployment pipeline?"
 
 > "Which issues describe problems that occur during initial environment setup?"
+
+---
+
+## Resources
+
+MCP Resources are URI-addressable, read-only data that clients can fetch directly by URI — no tool invocation required. Resource support varies by client; if your client does not support Resources, use the equivalent tool instead.
+
+### Reading server state via resources
+
+> "Read `mantis://me` to see which account the MCP server is using."
+
+> "Fetch `mantis://projects` to get the list of available projects."
+
+> "Load `mantis://enums` to see valid severity and priority values before creating an issue."
+
+### Equivalent tool fallbacks
+
+If your client does not support Resources, ask Claude to use the corresponding tool:
+
+> "Show me my user profile." *(uses `get_current_user`)*
+
+> "Which projects are available?" *(uses `list_projects`)*
+
+> "What are the valid priority values?" *(uses `get_issue_enums`)*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dpesch/mantisbt-mcp-server",
-  "version": "1.5.9",
+  "version": "1.6.1",
   "mcpName": "io.github.dpesch/mantisbt-mcp-server",
   "description": "MCP server for MantisBT REST API – read and manage bug tracker issues",
   "author": "Dominik Pesch",
@@ -11,9 +11,10 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://codeberg.org/dpesch/mantisbt-mcp-server"
+    "url": "https://github.com/dpesch/mantisbt-mcp-server",
+    "_note": "GitHub mirror for ecosystem compatibility only — canonical source: https://codeberg.org/dpesch/mantisbt-mcp-server"
   },
-  "keywords": ["mcp", "mantisbt", "bugtracker", "mantis", "model-context-protocol"],
+  "keywords": ["mcp", "mcp-server", "mantisbt", "bugtracker", "mantis", "model-context-protocol"],
   "main": "dist/index.js",
   "bin": {
     "mantisbt-mcp-server": "dist/index.js"