@dpesch/mantisbt-mcp-server 1.7.0 → 1.8.0

package/CHANGELOG.md

@@ -7,6 +7,26 @@ This project adheres to [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [Unreleased]
+
+---
+
+## [1.8.0] – 2026-03-27
+
+### Added
+- New MCP resource `mantis://projects/{id}`: combined project view with fields (`status`, `view_state`, `access_level`, `description`) plus users, versions, and categories — data that was previously only accessible via separate tool calls. Served from local cache; falls back to three parallel API calls when the cache is cold.
+- New tool `find_project_member`: search users with access to a project by name, display name, or email. Case-insensitive substring matching; returns up to `limit` results (default 10, max 100). Served from local cache when fresh; falls back to a live API call otherwise.
+- New tool `get_metadata_full`: returns the complete raw metadata cache (all project fields, full user/version/category lists, all tags) as minified JSON. Use when the compact summary from `get_metadata` is not enough.
+
+### Changed
+- `get_metadata` now returns a compact summary (project count, tag count, per-project counts of users/versions/categories, cache timestamp, and remaining TTL) instead of the full raw cache dump. Reduces response size from hundreds of KB to a few hundred bytes. Use `list_projects` for the full project list, `get_project_users` / `get_project_versions` / `get_project_categories` for per-project data, and `list_tags` for tags.
+- `list_projects` now applies the same normalization as `sync_metadata`: `custom_fields` and other undeclared API fields are stripped from project objects, keeping the response lean and consistent.
+
+### Fixed
+- `mantis://projects` resource response reduced from ~270 KB to ~6 KB (98% smaller): `custom_fields` are no longer included in project objects (they were passed through from the raw MantisBT API response despite not being part of the project schema), JSON output is now minified, and enum sub-objects (`status`, `view_state`, `access_level`) are stripped to only their declared fields. The `label` field on `status` and `view_state` is preserved for localized display name lookups.
+
+---
+
 ## [1.7.0] – 2026-03-26
 
 ### Added

package/README.de.md

@@ -133,10 +133,11 @@ npm run build
 
 | Tool | Beschreibung |
 |---|---|
-| `list_projects` | Alle zugänglichen Projekte auflisten |
+| `list_projects` | Alle zugänglichen Projekte auflisten; gibt normalisierte Projektdaten zurück (konsistent mit dem `sync_metadata`-Cache) |
 | `get_project_versions` | Versionen eines Projekts abrufen; optionale Booleans `obsolete` und `inherit` für veraltete bzw. vom Elternprojekt geerbte Versionen |
 | `get_project_categories` | Kategorien eines Projekts abrufen |
 | `get_project_users` | Benutzer eines Projekts abrufen |
+| `find_project_member` | Projektmitglieder nach Name, Realname oder E-Mail suchen (Teilstring-Suche, Groß-/Kleinschreibung ignoriert); optionale Parameter `query` und `limit` (Standard 10, max. 100); Cache-first |
 
 ### Semantische Suche *(optional)*
 
@@ -177,7 +178,8 @@ npm install sqlite-vec better-sqlite3
 | Tool | Beschreibung |
 |---|---|
 | `get_issue_fields` | Alle gültigen Feldnamen für den `select`-Parameter von `list_issues` zurückgeben |
-| `get_metadata` | Gecachte Metadaten abrufen (Projekte, Benutzer, Versionen, Kategorien) |
+| `get_metadata` | Kompakte Metadaten-Zusammenfassung abrufen: Anzahl Projekte/Tags und Anzahl Benutzer/Versionen/Kategorien je Projekt; für vollständige Arrays `get_metadata_full` verwenden |
+| `get_metadata_full` | Vollständigen rohen Metadaten-Cache als minifiziertes JSON zurückgeben (alle Projekte mit vollständigen Feldern, Benutzer/Versionen/Kategorien je Projekt, alle Tags) |
 | `sync_metadata` | Metadaten-Cache neu befüllen |
 | `list_filters` | Gespeicherte Filter auflisten |
 | `get_current_user` | Eigenes Benutzerprofil abrufen |
@@ -194,7 +196,8 @@ MCP-Ressourcen sind URI-adressierbare, schreibgeschützte Daten, die Clients dir
 | Ressource-URI | Beschreibung |
 |---|---|
 | `mantis://me` | Profil des authentifizierten API-Benutzers (Live-Abruf) |
-| `mantis://projects` | Alle zugänglichen MantisBT-Projekte (Cache-basiert, Aktualisierung via `sync_metadata`) |
+| `mantis://projects` | Alle zugänglichen MantisBT-Projekte als kompakte Liste (Cache-basiert, Aktualisierung via `sync_metadata`) |
+| `mantis://projects/{id}` | Kombinierte Projektansicht: Projektfelder + Benutzer + Versionen + Kategorien in einem Aufruf; Cache-first, List-Support zur Aufzählung aller verfügbaren Projekt-URIs |
 | `mantis://enums` | Gültige Werte für alle Issue-Enum-Felder: Severity, Priority, Status, Resolution, Reproducibility (Live-Abruf) |
 
 ## Verfügbare Prompts

package/README.md

@@ -133,10 +133,11 @@ npm run build
 
 | Tool | Description |
 |---|---|
-| `list_projects` | List all accessible projects |
+| `list_projects` | List all accessible projects; returns normalized project data (consistent with `sync_metadata` cache) |
 | `get_project_versions` | Get versions of a project; optional `obsolete` and `inherit` booleans to include obsolete or parent-inherited versions |
 | `get_project_categories` | Get categories of a project |
 | `get_project_users` | Get users of a project |
+| `find_project_member` | Search project members by name, real name, or email (case-insensitive substring match); optional `query` and `limit` (default 10, max 100); cache-first |
 
 ### Semantic search *(optional)*
 
@@ -177,7 +178,8 @@ npm install sqlite-vec better-sqlite3
 | Tool | Description |
 |---|---|
 | `get_issue_fields` | Return all field names valid for the `select` parameter of `list_issues` |
-| `get_metadata` | Retrieve cached metadata (projects, users, versions, categories) |
+| `get_metadata` | Retrieve a compact metadata summary: project/tag counts and per-project user/version/category counts; use `get_metadata_full` for complete arrays |
+| `get_metadata_full` | Return the full raw metadata cache as minified JSON (all projects with complete fields, users/versions/categories per project, all tags) |
 | `sync_metadata` | Refresh the metadata cache |
 | `list_filters` | List saved filters |
 | `get_current_user` | Retrieve your own user profile |
@@ -194,7 +196,8 @@ MCP Resources are URI-addressable, read-only data that clients can fetch directl
 | Resource URI | Description |
 |---|---|
 | `mantis://me` | Profile of the authenticated API user (live fetch) |
-| `mantis://projects` | All accessible MantisBT projects (cache-backed, refreshed via `sync_metadata`) |
+| `mantis://projects` | All accessible MantisBT projects as a compact list (cache-backed, refreshed via `sync_metadata`) |
+| `mantis://projects/{id}` | Combined project view: project fields + users + versions + categories in one call; cache-first, list-support for enumerating all available project URIs |
 | `mantis://enums` | Valid values for all issue enum fields: severity, priority, status, resolution, reproducibility (live fetch) |
 
 ## Available prompts

package/dist/cache.js

@@ -77,6 +77,9 @@ export class MetadataCache {
             return null;
         }
     }
+    getRemainingTtlSeconds(timestampMs) {
+        return Math.round(this.ttlSeconds - (Date.now() - timestampMs) / 1000);
+    }
     async saveIssueFields(fields) {
         await mkdir(this.cacheDir, { recursive: true });
         const file = { timestamp: Date.now(), fields };

package/dist/constants.js

@@ -1,4 +1,9 @@
 // ---------------------------------------------------------------------------
+// Category name normalization
+// ---------------------------------------------------------------------------
+/** Prefix MantisBT adds to category names inherited from [All Projects]. */
+export const ALL_PROJECTS_PREFIX = '[All Projects] ';
+// ---------------------------------------------------------------------------
 // Relationship type IDs
 // ---------------------------------------------------------------------------
 // Note: the MantisBT REST API only accepts numeric type IDs, not string names.

package/dist/index.js

@@ -55,7 +55,7 @@ async function createMcpServer() {
     registerFileTools(server, client, startupConfig.uploadDir);
     registerRelationshipTools(server, client);
     registerMonitorTools(server, client);
-    registerProjectTools(server, client);
+    registerProjectTools(server, client, cache);
     registerUserTools(server, client);
     registerFilterTools(server, client);
     registerConfigTools(server, client, cache);

package/dist/resources/index.js

@@ -1,10 +1,19 @@
+import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { fetchIssueEnums } from '../tools/config.js';
+import { normalizeProject } from '../tools/metadata.js';
+import { ALL_PROJECTS_PREFIX } from '../constants.js';
 function jsonResource(uri, data) {
     return {
-        contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(data, null, 2) }],
+        contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(data) }],
     };
 }
 export function registerResources(server, client, cache) {
+    async function loadProjects() {
+        const cached = await cache.loadIfValid();
+        return cached?.projects
+            ?? (await client.get('projects')).projects?.map(normalizeProject)
+            ?? [];
+    }
     server.registerResource('current-user', 'mantis://me', {
         title: 'Current User',
         description: 'Profile of the user associated with the configured API key.',
@@ -14,12 +23,51 @@ export function registerResources(server, client, cache) {
         title: 'Projects',
         description: 'All MantisBT projects accessible to the current API user. Served from local cache when fresh; falls back to live fetch. Refresh via the sync_metadata tool.',
         mimeType: 'application/json',
-    }, async (uri) => {
+    }, async (uri) => jsonResource(uri, await loadProjects()));
+    server.registerResource('project-detail', new ResourceTemplate('mantis://projects/{id}', {
+        list: async () => ({
+            resources: (await loadProjects()).map((p) => ({
+                uri: `mantis://projects/${p.id}`,
+                name: p.name,
+            })),
+        }),
+    }), {
+        title: 'Project Detail',
+        description: 'Combined project view: fields (status, view_state, access_level, description) plus all associated users, versions, and categories. Served from local cache when fresh; falls back to live API fetch. Refresh via the sync_metadata tool.',
+        mimeType: 'application/json',
+    }, async (uri, { id }) => {
+        const numId = Number(id);
         const cached = await cache.loadIfValid();
-        const projects = cached?.projects
-            ?? (await client.get('projects')).projects
-            ?? [];
-        return jsonResource(uri, projects);
+        let project;
+        let users;
+        let versions;
+        let categories;
+        if (cached) {
+            project = cached.projects.find((p) => p.id === numId);
+            const meta = cached.byProject[numId];
+            users = meta?.users ?? [];
+            versions = meta?.versions ?? [];
+            categories = meta?.categories ?? [];
+        }
+        else {
+            const [projectResult, usersResult, versionsResult] = await Promise.all([
+                client.get(`projects/${numId}`),
+                client.get(`projects/${numId}/users`),
+                client.get(`projects/${numId}/versions`, { obsolete: 1, inherit: 1 }),
+            ]);
+            const raw = projectResult.projects?.[0];
+            project = raw ? normalizeProject(raw) : undefined;
+            users = usersResult.users ?? [];
+            versions = versionsResult.versions ?? [];
+            categories = (raw?.categories ?? []).map((c) => ({
+                ...c,
+                name: c.name.startsWith(ALL_PROJECTS_PREFIX) ? c.name.slice(ALL_PROJECTS_PREFIX.length) : c.name,
+            }));
+        }
+        if (!project) {
+            throw new Error(`Project ${numId} not found`);
+        }
+        return jsonResource(uri, { ...project, users, versions, categories });
     });
     server.registerResource('issue-enums', 'mantis://enums', {
         title: 'Issue Enums',

package/dist/tools/metadata.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { getVersionHint } from '../version-hint.js';
+import { ALL_PROJECTS_PREFIX } from '../constants.js';
 // Fields MantisBT strips from issue responses when the array is empty.
 // They are always valid 'select' values even if absent in a sample issue.
 const EMPTY_STRIPPED_FIELDS = [
@@ -83,10 +84,27 @@ async function collectTagsFromIssues(client, projects) {
     }
     return Array.from(tagMap.values()).sort((a, b) => a.id - b.id);
 }
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function normalizeIdName(o) {
+    return { id: o.id, name: o.name, ...(o.label !== undefined && { label: o.label }) };
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function normalizeProject(p) {
+    return {
+        id: p.id,
+        name: p.name,
+        ...(p.description !== undefined && { description: p.description }),
+        ...(p.status !== undefined && { status: normalizeIdName(p.status) }),
+        ...(p.enabled !== undefined && { enabled: p.enabled }),
+        ...(p.view_state !== undefined && { view_state: normalizeIdName(p.view_state) }),
+        ...(p.access_level !== undefined && { access_level: { id: p.access_level.id, label: p.access_level.label } }),
+        ...(p.subprojects !== undefined && { subprojects: p.subprojects.map(normalizeProject) }),
+    };
+}
 async function fetchAndCacheMetadata(client, cache) {
     // Fetch all projects
     const projectResult = await client.get('projects');
-    const projects = projectResult.projects ?? [];
+    const projects = (projectResult.projects ?? []).map(normalizeProject);
     const byProject = {};
     // For each project, fetch users, versions, categories in parallel
     await Promise.all(projects.map(async (project) => {
@@ -102,7 +120,6 @@ async function fetchAndCacheMetadata(client, cache) {
         const versions = versionsResult.status === 'fulfilled'
             ? (versionsResult.value.versions ?? [])
             : [];
-        const ALL_PROJECTS_PREFIX = '[All Projects] ';
         const rawCategories = projectDetailResult.status === 'fulfilled'
             ? (projectDetailResult.value.projects?.[0]?.categories ?? [])
             : [];
@@ -177,10 +194,52 @@ Use this tool to refresh stale data.`,
     // ---------------------------------------------------------------------------
     server.registerTool('get_metadata', {
         title: 'Get Cached Metadata',
-        description: `Return cached MantisBT metadata (projects, users, versions, categories).
+        description: `Return a compact summary of cached MantisBT metadata: project count, tag count, and per-project counts of users, versions, and categories.
+
+If the cache does not exist or has expired (default TTL: 24 hours), it will automatically sync first.
+Use sync_metadata to force a refresh. For full lists use: list_projects (projects), get_project_users / get_project_versions / get_project_categories (per-project data), list_tags (tags).`,
+        inputSchema: z.object({}),
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+    }, async () => {
+        try {
+            const data = await cache.loadIfValid() ?? await fetchAndCacheMetadata(client, cache);
+            const summary = {
+                projects: data.projects.length,
+                tags: data.tags.length,
+                byProject: Object.fromEntries(data.projects.map((p) => {
+                    const meta = data.byProject[p.id];
+                    return [String(p.id), {
+                            name: p.name,
+                            users: meta?.users.length ?? 0,
+                            versions: meta?.versions.length ?? 0,
+                            categories: meta?.categories.length ?? 0,
+                        }];
+                })),
+                cached_at: new Date(data.timestamp).toISOString(),
+                ttl_seconds: cache.getRemainingTtlSeconds(data.timestamp),
+            };
+            return {
+                content: [{ type: 'text', text: JSON.stringify(summary, null, 2) }],
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            return { content: [{ type: 'text', text: errorText(msg) }], isError: true };
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // get_metadata_full
+    // ---------------------------------------------------------------------------
+    server.registerTool('get_metadata_full', {
+        title: 'Get Full Cached Metadata',
+        description: `Return the complete raw MantisBT metadata cache: all projects with full fields, and per-project lists of users, versions, categories, plus all tags.
 
 If the cache does not exist or has expired (default TTL: 24 hours), it will automatically sync first.
-Use sync_metadata to force a refresh.`,
+Use sync_metadata to force a refresh. For a lightweight overview use get_metadata instead.`,
         inputSchema: z.object({}),
         annotations: {
             readOnlyHint: true,
@@ -191,7 +250,7 @@ Use sync_metadata to force a refresh.`,
         try {
             const data = await cache.loadIfValid() ?? await fetchAndCacheMetadata(client, cache);
             return {
-                content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+                content: [{ type: 'text', text: JSON.stringify(data) }],
             };
         }
         catch (error) {

package/dist/tools/projects.js

@@ -1,13 +1,14 @@
 import { z } from 'zod';
 import { getVersionHint } from '../version-hint.js';
+import { ALL_PROJECTS_PREFIX } from '../constants.js';
+import { normalizeProject } from './metadata.js';
 function errorText(msg) {
     const vh = getVersionHint();
     vh?.triggerLatestVersionFetch();
     const hint = vh?.getUpdateHint();
     return hint ? `Error: ${msg}\n\n${hint}` : `Error: ${msg}`;
 }
-const ALL_PROJECTS_PREFIX = '[All Projects] ';
-export function registerProjectTools(server, client) {
+export function registerProjectTools(server, client, cache) {
     // ---------------------------------------------------------------------------
     // list_projects
     // ---------------------------------------------------------------------------
@@ -23,8 +24,9 @@ export function registerProjectTools(server, client) {
     }, async () => {
         try {
             const result = await client.get('projects');
+            const projects = (result.projects ?? []).map(normalizeProject);
             return {
-                content: [{ type: 'text', text: JSON.stringify(result.projects ?? result, null, 2) }],
+                content: [{ type: 'text', text: JSON.stringify(projects, null, 2) }],
             };
         }
         catch (error) {
@@ -131,4 +133,50 @@ This tool strips that prefix so the returned names can be used directly when cre
             return { content: [{ type: 'text', text: errorText(msg) }], isError: true };
         }
     });
+    // ---------------------------------------------------------------------------
+    // find_project_member
+    // ---------------------------------------------------------------------------
+    server.registerTool('find_project_member', {
+        title: 'Find Project Member',
+        description: `Search for users with access to a MantisBT project by name, display name, or email.
+
+Returns up to \`limit\` matching users (default: 10, max: 100). Matching is case-insensitive substring search across \`name\`, \`real_name\`, and \`email\` fields. Omit \`query\` to list the first \`limit\` users.
+
+Data is served from the local metadata cache when fresh; falls back to a live API call otherwise.`,
+        inputSchema: z.object({
+            project_id: z.coerce.number().int().positive().describe('Numeric project ID'),
+            query: z.string().optional().describe('Case-insensitive substring to match against name, real_name, or email'),
+            limit: z.coerce.number().int().min(1).max(100).default(10).describe('Maximum number of results to return (default: 10, max: 100)'),
+        }),
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+    }, async ({ project_id, query, limit }) => {
+        try {
+            let users;
+            const cached = cache ? await cache.loadIfValid() : null;
+            if (cached?.byProject[project_id]) {
+                users = cached.byProject[project_id].users;
+            }
+            else {
+                const result = await client.get(`projects/${project_id}/users`);
+                users = result.users ?? [];
+            }
+            if (query) {
+                const q = query.toLowerCase();
+                users = users.filter((u) => u.name.toLowerCase().includes(q) ||
+                    (u.real_name?.toLowerCase().includes(q) ?? false) ||
+                    (u.email?.toLowerCase().includes(q) ?? false));
+            }
+            return {
+                content: [{ type: 'text', text: JSON.stringify(users.slice(0, limit), null, 2) }],
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            return { content: [{ type: 'text', text: errorText(msg) }], isError: true };
+        }
+    });
 }

package/docs/cookbook.de.md

@@ -46,6 +46,10 @@ Tool-orientierte Rezepte für den MantisBT MCP Server — jedes Rezept zeigt gen
   - [Suche mit Felderweiterung](#suche-mit-felderweiterung)
 - [Projekte & Kategorien](#projekte--kategorien)
   - [Projektkategorien auflisten](#projektkategorien-auflisten)
+  - [Projektmitglied suchen](#projektmitglied-suchen)
+- [Metadaten](#metadaten)
+  - [Metadaten-Zusammenfassung abrufen](#metadaten-zusammenfassung-abrufen)
+  - [Vollständigen Metadaten-Cache abrufen](#vollständigen-metadaten-cache-abrufen)
 - [Version & Diagnose](#version--diagnose)
   - [MCP-Server-Version abrufen](#mcp-server-version-abrufen)
   - [MantisBT-Version abrufen](#mantisbt-version-abrufen)
@@ -53,6 +57,7 @@ Tool-orientierte Rezepte für den MantisBT MCP Server — jedes Rezept zeigt gen
 - [Ressourcen](#ressourcen)
   - [Eigenes Benutzerprofil lesen](#eigenes-benutzerprofil-lesen)
   - [Alle Projekte lesen](#alle-projekte-lesen)
+  - [Einzelnes Projekt mit allen Details lesen](#einzelnes-projekt-mit-allen-details-lesen)
   - [Issue-Enum-Werte lesen](#issue-enum-werte-lesen)
 - [Prompts](#prompts)
   - [Bug-Report erstellen](#bug-report-erstellen)
@@ -1079,7 +1084,7 @@ Entfernt einen Tag von einem Issue. Erfordert die numerische Tag-ID.
 "Tag #14 successfully removed from issue #1042."
 ```
 
-> **Hinweis:** `detach_tag` erfordert eine numerische ID, keinen Tag-Namen. Es gibt keine Suche per Name — die ID muss immer zuerst über `get_issue` oder `get_metadata` abgerufen werden.
+> **Hinweis:** `detach_tag` erfordert eine numerische ID, keinen Tag-Namen. Es gibt keine Suche per Name — die ID muss immer zuerst über `get_issue` oder `list_tags` abgerufen werden.
 
 ---
 
@@ -1338,6 +1343,123 @@ Gibt alle verfügbaren Kategorien eines MantisBT-Projekts zurück. Die zurückge
 
 ---
 
+### Projektmitglied suchen
+
+Sucht Projektmitglieder nach Name, Realname oder E-Mail. Die Suche ist Groß-/Kleinschreibungsunabhängig und findet Teilstrings. Ergebnisse werden bevorzugt aus dem Metadaten-Cache geliefert; bei leerem Cache wird die live API verwendet.
+
+**Tool:** `find_project_member`
+
+**Parameter:**
+- `project_id` — numerische Projekt-ID
+- `query` — _(optional)_ Suchbegriff für `name`, `real_name` oder `email`
+- `limit` — _(optional)_ maximale Trefferanzahl, Standard 10, max. 100
+
+**Request:**
+
+```json
+{
+  "project_id": 3,
+  "query": "smith",
+  "limit": 5
+}
+```
+
+**Response:**
+
+```json
+[
+  { "id": 4, "name": "jsmith", "real_name": "John Smith", "email": "jsmith@example.com", "access_level": { "id": 55, "name": "developer" } },
+  { "id": 11, "name": "asmith", "real_name": "Alice Smith", "email": "asmith@example.com", "access_level": { "id": 40, "name": "reporter" } }
+]
+```
+
+> **Tipp:** `query` weglassen, um alle Mitglieder des Projekts aufzulisten (bis zu `limit`).
+
+---
+
+## Metadaten
+
+### Metadaten-Zusammenfassung abrufen
+
+Gibt eine kompakte Übersicht aller gecachten Metadaten zurück: Gesamtzahl der Projekte und Tags sowie die Anzahl von Benutzern, Versionen und Kategorien je Projekt. Nützlich für einen schnellen Überblick, ohne große Arrays zu übertragen.
+
+**Tool:** `get_metadata`
+
+**Parameter:** _(keine)_
+
+**Request:**
+
+```json
+{}
+```
+
+**Response:**
+
+```json
+{
+  "projects": 24,
+  "tags": 15,
+  "byProject": {
+    "3": { "name": "Webshop", "users": 8, "versions": 12, "categories": 4 },
+    "5": { "name": "Backend API", "users": 5, "versions": 7, "categories": 3 }
+  },
+  "cached_at": "2026-03-27T09:00:00.000Z",
+  "ttl_seconds": 82800
+}
+```
+
+> **Hinweis:** Für vollständige Listen `list_projects`, `get_project_users`, `get_project_versions`, `get_project_categories`, `list_tags` oder `get_metadata_full` verwenden.
+
+---
+
+### Vollständigen Metadaten-Cache abrufen
+
+Gibt den vollständigen rohen Metadaten-Cache als minifiziertes JSON zurück. Enthält alle Projekte mit vollständigen Feldern sowie Benutzer, Versionen und Kategorien je Projekt und alle Tags. Geeignet, wenn alle Daten in einem einzigen Aufruf benötigt werden.
+
+**Tool:** `get_metadata_full`
+
+**Parameter:** _(keine)_
+
+**Request:**
+
+```json
+{}
+```
+
+**Response:**
+
+```json
+{
+  "projects": [
+    {
+      "id": 3,
+      "name": "Webshop",
+      "status": { "id": 10, "name": "development" },
+      "enabled": true,
+      "users": [
+        { "id": 4, "name": "jsmith", "real_name": "John Smith", "email": "jsmith@example.com", "access_level": { "id": 55, "name": "developer" } }
+      ],
+      "versions": [
+        { "id": 21, "name": "2.4.0", "released": false, "obsolete": false }
+      ],
+      "categories": [
+        { "id": 1, "name": "General" },
+        { "id": 2, "name": "UI" }
+      ]
+    }
+  ],
+  "tags": [
+    { "id": 1, "name": "regression" },
+    { "id": 2, "name": "hotfix" }
+  ],
+  "cached_at": "2026-03-27T09:00:00.000Z"
+}
+```
+
+> **Tipp:** `get_metadata` liefert dieselben Daten als kompakte Zusammenfassung (nur Zählwerte). `get_metadata_full` verwenden, wenn die eigentlichen Arrays benötigt werden.
+
+---
+
 ## Version & Diagnose
 
 ### MCP-Server-Version abrufen
@@ -1476,6 +1598,41 @@ Gibt alle MantisBT-Projekte zurück, auf die der konfigurierte API-Key Zugriff h
 
 ---
 
+### Einzelnes Projekt mit allen Details lesen
+
+Gibt eine kombinierte Ansicht eines einzelnen Projekts zurück: Projektfelder sowie alle Mitglieder, Versionen und Kategorien in einem Aufruf. Cache-first (MetadataCache); bei leerem Cache werden drei parallele API-Aufrufe durchgeführt. Clients mit Resource-List-Unterstützung können alle verfügbaren Projekt-URIs aufzählen.
+
+**Ressource-URI:** `mantis://projects/{id}` (`{id}` durch die numerische Projekt-ID ersetzen)
+
+**Abrufverhalten:** Cache-first (MetadataCache, Standard-TTL 24 h). Fällt auf Live-API-Aufrufe zurück, wenn der Cache leer ist.
+
+**Beispiel-URI:** `mantis://projects/42`
+
+**Response:**
+
+```json
+{
+  "id": 3,
+  "name": "Webshop",
+  "status": { "id": 10, "name": "development" },
+  "enabled": true,
+  "users": [
+    { "id": 4, "name": "jsmith", "real_name": "John Smith", "email": "jsmith@example.com", "access_level": { "id": 55, "name": "developer" } }
+  ],
+  "versions": [
+    { "id": 21, "name": "2.4.0", "released": false, "obsolete": false }
+  ],
+  "categories": [
+    { "id": 1, "name": "General" },
+    { "id": 2, "name": "UI" }
+  ]
+}
+```
+
+> **Tipp:** `mantis://projects` für eine kompakte Liste aller Projekte verwenden, anschließend Detaildaten einzelner Projekte über `mantis://projects/{id}` abrufen.
+
+---
+
 ### 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.