castor-mcp 0.6.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chuck
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,77 @@
+# Castor for Confluence Data Center
+
+Docs: https://castor.moosejudge.com/docs
+
+A secure MCP server that bridges Atlassian Confluence Data Center (9.2 and 10.2, the two current
+LTS lines) with AI agents like Claude.
+
+> Castor is an independent, community-built tool. It is not affiliated with, endorsed by, or
+> sponsored by Atlassian. Confluence® is a registered trademark of Atlassian Pty Ltd.
+
+## Overview
+
+As Atlassian sunsets Data Center support, this server ensures organizations can still leverage AI
+safely within their on-premise Confluence infrastructure. It follows open standards, the MCP
+specification, and a "secure by default" model — see `alces-mcp` (the sibling Jira DC server this
+project mirrors) for the shared design lineage.
+
+## Features
+
+- **7 domain tools** covering spaces, pages, and CQL search, plus `get_api_references` for
+  querying the generated API catalog — `docs/api-catalog.md` tracks the full set of cataloged
+  Confluence DC operations and which are implemented.
+- **Dual-token security**: `CONFLUENCE_USER_TOKEN` for standard operations,
+  `CONFLUENCE_ADMIN_TOKEN` for elevated ones (e.g. `admin_get_space_permissions`) — admin tools are
+  invisible to the agent without the admin token configured.
+- **Skills as MCP Resources**: agent-facing operational guidance via `skill://spaces-pages`.
+
+## Install to use
+
+Just want to talk to your Confluence DC instance through Claude Desktop, without cloning or
+building anything? Install the pre-built bundle:
+
+1. Download the latest `castor-mcp-<version>.mcpb` from the
+   [GitLab Releases page](https://gitlab.com/moosejudge/castor-mcp/-/releases).
+2. In Claude Desktop: **Settings → Extensions → Advanced settings → Extension Developer →
+   "Install Extension…"**, then select the downloaded file.
+3. Enter your Confluence URL and PAT(s) when prompted — these are stored via your OS keychain,
+   never as plaintext.
+
+Once connected, see [docs/user/](./docs/user/spaces-pages.md) for what you can do and how to ask
+for it.
+
+If you're integrating Castor into a coding agent instead of Claude Desktop, it's also published on
+npm as [`castor-mcp`](https://www.npmjs.com/package/castor-mcp) — point your agent's MCP config at
+`command: "npx"`, `args: ["-y", "castor-mcp"]` instead of cloning or building anything. See
+[Setup to develop](#setup-to-develop) below only if you're contributing or need to run from an
+unreleased commit.
+
+## Setup to develop
+
+1. Clone the repository.
+2. Install dependencies:
+   ```bash
+   npm install
+   ```
+3. Copy `.env.example` to `.env` and fill in `CONFLUENCE_URL` and `CONFLUENCE_USER_TOKEN`
+   (optionally `CONFLUENCE_ADMIN_TOKEN`).
+4. Build the project:
+   ```bash
+   npm run build
+   ```
+5. Run tests:
+   ```bash
+   npm test
+   ```
+
+There is no running local Confluence instance yet — `docker-compose.yml` defines one (see
+`docs/developer/testing-environment.md`), but it requires a Confluence developer license this
+project does not currently have, and has never been started.
+
+## Documentation
+
+- `docs/user/` — task-oriented guide to what the agent can do.
+- `docs/developer/` — codebase notes for contributors.
+- `docs/api-catalog.md` — generated reference of every cataloged Confluence DC operation and its
+  implementation status.
+- `docs/specs/`, `docs/plans/` — design specs and implementation plans.

package/build/api-catalog.d.ts

@@ -0,0 +1,27 @@
+export interface ApiOperation {
+    api: string;
+    path: string;
+    method: string;
+    tag: string;
+    operation_id: string | null;
+    summary: string;
+    deprecated: boolean;
+    auth_tier: "user" | "admin";
+    destructiveness: string;
+    min_version: string;
+    max_version: string;
+    implementation_status: string;
+    implemented_by: string | null;
+}
+export interface ApiCatalog {
+    generated_from: string[];
+    generated_note: string;
+    operations: ApiOperation[];
+}
+export type ApiReferenceCategory = "user" | "admin";
+export interface ApiReferenceArgs {
+    category?: ApiReferenceCategory;
+    tag?: string;
+    search?: string;
+}
+export declare function buildApiReferenceText(catalog: ApiCatalog, args: ApiReferenceArgs): string;

package/build/api-catalog.js

@@ -0,0 +1,76 @@
+const ROW_DUMP_THRESHOLD = 80;
+const MAX_ROWS = 150;
+function opsForCategory(catalog, category) {
+    return catalog.operations.filter((o) => o.auth_tier === category);
+}
+function applyFilters(ops, args) {
+    let out = ops;
+    if (args.tag) {
+        const needle = args.tag.toLowerCase();
+        out = out.filter((o) => o.tag.toLowerCase().includes(needle));
+    }
+    if (args.search) {
+        const needle = args.search.toLowerCase();
+        out = out.filter((o) => o.path.toLowerCase().includes(needle) ||
+            o.summary.toLowerCase().includes(needle) ||
+            (o.operation_id ?? "").toLowerCase().includes(needle));
+    }
+    return out;
+}
+function tagBreakdown(ops) {
+    const counts = new Map();
+    for (const op of ops)
+        counts.set(op.tag, (counts.get(op.tag) ?? 0) + 1);
+    return [...counts.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .map(([tag, count]) => `- \`${tag}\` (${count})`)
+        .join("\n");
+}
+function renderRows(ops) {
+    const truncated = ops.length > MAX_ROWS;
+    const rows = ops.slice(0, MAX_ROWS);
+    let md = `| Status | Method | Path | Summary | Kind |\n|---|---|---|---|---|\n`;
+    for (const op of rows) {
+        md += `| ${op.implementation_status} | ${op.method} | \`${op.path}\` | ${op.summary} | ${op.destructiveness} |\n`;
+    }
+    if (truncated) {
+        md += `\n_...${ops.length - MAX_ROWS} more rows omitted — narrow with \`tag\` or \`search\`._\n`;
+    }
+    return md;
+}
+function renderOverview(catalog) {
+    const counts = {
+        user: opsForCategory(catalog, "user").length,
+        admin: opsForCategory(catalog, "admin").length,
+    };
+    return [
+        `Confluence DC API catalog — ${catalog.operations.length} cataloged operations.`,
+        ``,
+        `Call again with a \`category\` to see entries:`,
+        `- \`user\` (${counts.user}) — user-tier`,
+        `- \`admin\` (${counts.admin}) — admin-tier`,
+        ``,
+        `Add \`tag\` or \`search\` to narrow within a category.`,
+        ``,
+        catalog.generated_note,
+    ].join("\n");
+}
+export function buildApiReferenceText(catalog, args) {
+    if (!args.category)
+        return renderOverview(catalog);
+    const base = opsForCategory(catalog, args.category);
+    const filtered = applyFilters(base, args);
+    if (filtered.length === 0) {
+        return `No operations found in category \`${args.category}\` matching the given filters.`;
+    }
+    if (filtered.length > ROW_DUMP_THRESHOLD && !args.tag && !args.search) {
+        return [
+            `Category \`${args.category}\` has ${filtered.length} operations — too many to list at once.`,
+            `Narrow with \`tag\` (or \`search\`). Tags in this category:`,
+            ``,
+            tagBreakdown(filtered),
+        ].join("\n");
+    }
+    return `${filtered.length} operation(s) in \`${args.category}\`${args.tag ? ` / tag "${args.tag}"` : ""}${args.search ? ` matching "${args.search}"` : ""}:\n\n${renderRows(filtered)}`;
+}
+//# sourceMappingURL=api-catalog.js.map

package/build/api-catalog.js.map

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

package/build/confluence-client.d.ts

@@ -0,0 +1,33 @@
+import { AxiosInstance } from "axios";
+export interface ConfluenceConfig {
+    url: string;
+    token: string;
+}
+export declare class ConfluenceClient {
+    private axiosInstance;
+    constructor(config: ConfluenceConfig, axiosInstance?: AxiosInstance);
+    get(path: string, params?: Record<string, unknown>, responseType?: "json" | "arraybuffer"): Promise<import("axios").AxiosResponse<any, any, {}, Record<string, unknown>>>;
+    post(path: string, body?: unknown, headers?: Record<string, string | undefined>): Promise<import("axios").AxiosResponse<any, unknown, {}, any>>;
+    put(path: string, body?: unknown): Promise<import("axios").AxiosResponse<any, unknown, {}, any>>;
+    delete(path: string, params?: Record<string, unknown>): Promise<import("axios").AxiosResponse<any, any, {}, Record<string, unknown>>>;
+    /** GET /rest/api/space — list spaces, optionally filtered by type ("global"|"personal"). */
+    listSpaces(params?: {
+        type?: string;
+        limit?: number;
+    }): Promise<import("axios").AxiosResponse<any, any, {}, Record<string, unknown>>>;
+    /** GET /rest/api/space/{spaceKey} */
+    getSpace(spaceKey: string): Promise<import("axios").AxiosResponse<any, any, {}, Record<string, unknown>>>;
+    /**
+     * GET /rest/api/content/{id} — expands body.storage/version/space so callers get a page's
+     * content, version number, and owning space in one round trip.
+     */
+    getContent(id: string): Promise<import("axios").AxiosResponse<any, any, {}, Record<string, unknown>>>;
+    /** POST /rest/api/content */
+    createContent(body: unknown): Promise<import("axios").AxiosResponse<any, unknown, {}, any>>;
+    /** PUT /rest/api/content/{contentId} */
+    updateContent(contentId: string, body: unknown): Promise<import("axios").AxiosResponse<any, unknown, {}, any>>;
+    /** GET /rest/api/content/search — Confluence Query Language (CQL). */
+    searchContent(cql: string, limit?: number): Promise<import("axios").AxiosResponse<any, any, {}, Record<string, unknown>>>;
+    /** GET /rest/api/space/{spaceKey}/permissions — requires space-admin permission. */
+    getSpacePermissions(spaceKey: string): Promise<import("axios").AxiosResponse<any, any, {}, Record<string, unknown>>>;
+}

package/build/confluence-client.js

@@ -0,0 +1,65 @@
+import axios from "axios";
+export class ConfluenceClient {
+    axiosInstance;
+    constructor(config, axiosInstance) {
+        if (axiosInstance) {
+            this.axiosInstance = axiosInstance;
+            return;
+        }
+        const baseUrl = config.url.endsWith("/") ? config.url.slice(0, -1) : config.url;
+        this.axiosInstance = axios.create({
+            baseURL: baseUrl,
+            headers: {
+                Authorization: `Bearer ${config.token}`,
+                "Content-Type": "application/json",
+                Accept: "application/json",
+            },
+        });
+    }
+    async get(path, params, responseType) {
+        return this.axiosInstance.get(path, { params, responseType });
+    }
+    async post(path, body, headers) {
+        if (headers)
+            return this.axiosInstance.post(path, body, { headers });
+        return this.axiosInstance.post(path, body);
+    }
+    async put(path, body) {
+        return this.axiosInstance.put(path, body);
+    }
+    async delete(path, params) {
+        return this.axiosInstance.delete(path, { params });
+    }
+    /** GET /rest/api/space — list spaces, optionally filtered by type ("global"|"personal"). */
+    async listSpaces(params) {
+        return this.get("/rest/api/space", params);
+    }
+    /** GET /rest/api/space/{spaceKey} */
+    async getSpace(spaceKey) {
+        return this.get(`/rest/api/space/${encodeURIComponent(spaceKey)}`);
+    }
+    /**
+     * GET /rest/api/content/{id} — expands body.storage/version/space so callers get a page's
+     * content, version number, and owning space in one round trip.
+     */
+    async getContent(id) {
+        return this.get(`/rest/api/content/${encodeURIComponent(id)}`, { expand: "body.storage,version,space" });
+    }
+    /** POST /rest/api/content */
+    async createContent(body) {
+        return this.post("/rest/api/content", body);
+    }
+    /** PUT /rest/api/content/{contentId} */
+    async updateContent(contentId, body) {
+        return this.put(`/rest/api/content/${encodeURIComponent(contentId)}`, body);
+    }
+    /** GET /rest/api/content/search — Confluence Query Language (CQL). */
+    async searchContent(cql, limit) {
+        return this.get("/rest/api/content/search", { cql, limit });
+    }
+    /** GET /rest/api/space/{spaceKey}/permissions — requires space-admin permission. */
+    async getSpacePermissions(spaceKey) {
+        return this.get(`/rest/api/space/${encodeURIComponent(spaceKey)}/permissions`);
+    }
+}
+//# sourceMappingURL=confluence-client.js.map

package/build/confluence-client.js.map

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

package/build/index.d.ts

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

package/build/index.js

@@ -0,0 +1,137 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, ReadResourceRequestSchema, ErrorCode, McpError, } from "@modelcontextprotocol/sdk/types.js";
+import { readFile } from "fs/promises";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import dotenv from "dotenv";
+import { load as loadYaml } from "js-yaml";
+import { ConfluenceClient } from "./confluence-client.js";
+import { TOOL_DEFINITIONS, listableToolEntries } from "./tool-definitions.js";
+import { RESOURCE_DEFINITIONS, getResourceDefinition } from "./resource-definitions.js";
+import { buildApiReferenceText } from "./api-catalog.js";
+import { readPackageVersion } from "./version.js";
+dotenv.config();
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+class CastorMcpServer {
+    server;
+    userClient = null;
+    adminClient = null;
+    skillContentCache = new Map();
+    apiCatalogCache = null;
+    constructor() {
+        this.server = new Server({ name: "castor-mcp", version: readPackageVersion() }, {
+            capabilities: { tools: {}, resources: {} },
+            instructions: "Category-specific operational guidance is available as MCP Resources " +
+                "(skill://spaces-pages) — fetch it via resources/read before constructing complex " +
+                "CQL or working through a create/update page workflow.",
+        });
+        this.initializeClients();
+        this.setupHandlers();
+        this.server.onerror = (error) => console.error("[MCP Error]", error);
+        process.on("SIGINT", async () => {
+            await this.server.close();
+            process.exit(0);
+        });
+    }
+    initializeClients() {
+        const url = process.env.CONFLUENCE_URL;
+        const userToken = process.env.CONFLUENCE_USER_TOKEN;
+        const adminToken = process.env.CONFLUENCE_ADMIN_TOKEN;
+        if (!url) {
+            console.error("CONFLUENCE_URL is not set");
+            return;
+        }
+        if (userToken) {
+            this.userClient = new ConfluenceClient({ url, token: userToken });
+        }
+        if (adminToken) {
+            this.adminClient = new ConfluenceClient({ url, token: adminToken });
+        }
+    }
+    requireUserClient() {
+        if (!this.userClient) {
+            throw new McpError(ErrorCode.InvalidRequest, "No Confluence user client configured — set CONFLUENCE_URL and CONFLUENCE_USER_TOKEN.");
+        }
+        return this.userClient;
+    }
+    requireAdminClient() {
+        if (!this.adminClient) {
+            throw new McpError(ErrorCode.InvalidRequest, "No Confluence admin client configured — set CONFLUENCE_ADMIN_TOKEN to enable admin tools.");
+        }
+        return this.adminClient;
+    }
+    setupHandlers() {
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
+            tools: listableToolEntries(this.adminClient !== null).map(([name, def]) => ({
+                name,
+                description: def.description,
+                inputSchema: def.inputSchema,
+            })),
+        }));
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const definition = TOOL_DEFINITIONS[request.params.name];
+            if (!definition) {
+                throw new McpError(ErrorCode.MethodNotFound, `Tool not found: ${request.params.name}`);
+            }
+            return definition.handler(this, request.params.arguments);
+        });
+        this.server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+            resources: Object.values(RESOURCE_DEFINITIONS).map(({ uri, name, description, mimeType }) => ({
+                uri,
+                name,
+                description,
+                mimeType,
+            })),
+        }));
+        this.server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => ({ resourceTemplates: [] }));
+        this.server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+            const def = getResourceDefinition(request.params.uri);
+            let text;
+            try {
+                text = await this.loadSkillContent(def.filePath);
+            }
+            catch {
+                throw new McpError(ErrorCode.InternalError, `Error reading skill resource ${def.uri}`);
+            }
+            return { contents: [{ uri: def.uri, mimeType: def.mimeType, text }] };
+        });
+    }
+    async loadSkillContent(filePath) {
+        const cached = this.skillContentCache.get(filePath);
+        if (cached !== undefined)
+            return cached;
+        const fullPath = join(__dirname, "..", "skills", filePath);
+        const text = await readFile(fullPath, "utf-8");
+        this.skillContentCache.set(filePath, text);
+        return text;
+    }
+    async loadApiCatalog() {
+        if (this.apiCatalogCache)
+            return this.apiCatalogCache;
+        const catalogPath = join(__dirname, "..", "docs", "api-catalog.yaml");
+        const raw = await readFile(catalogPath, "utf-8");
+        this.apiCatalogCache = loadYaml(raw);
+        return this.apiCatalogCache;
+    }
+    async handleGetApiReferences(args) {
+        try {
+            const catalog = await this.loadApiCatalog();
+            const text = buildApiReferenceText(catalog, (args ?? {}));
+            return { content: [{ type: "text", text }] };
+        }
+        catch (error) {
+            throw new McpError(ErrorCode.InternalError, `Error reading API catalog: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async run() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        console.error("Castor MCP server running on stdio");
+    }
+}
+const server = new CastorMcpServer();
+server.run().catch(console.error);
+//# sourceMappingURL=index.js.map

package/build/index.js.map

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

package/build/resource-definitions.d.ts

@@ -0,0 +1,10 @@
+export interface ResourceDefinition {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+    /** Relative to the skills/ directory at the repo root. */
+    filePath: string;
+}
+export declare const RESOURCE_DEFINITIONS: Record<string, ResourceDefinition>;
+export declare function getResourceDefinition(uri: string): ResourceDefinition;

package/build/resource-definitions.js

@@ -0,0 +1,75 @@
+import { ErrorCode, McpError } from "@modelcontextprotocol/sdk/types.js";
+export const RESOURCE_DEFINITIONS = {
+    "skill://spaces-pages": {
+        uri: "skill://spaces-pages",
+        name: "Confluence Spaces & Pages",
+        description: "CQL construction and page-versioning guidance for the spaces/pages tools.",
+        mimeType: "text/markdown",
+        filePath: "spaces-pages.md",
+    },
+    "skill://content": {
+        uri: "skill://content",
+        name: "Confluence Content",
+        description: "Content properties, structure, labels, bulk operations, and attachments — real gotchas " +
+            "found live-verifying content.ts, content-structure.ts, labels.ts, bulk-pages.ts, and " +
+            "attachments.ts.",
+        mimeType: "text/markdown",
+        filePath: "content.md",
+    },
+    "skill://spaces-admin": {
+        uri: "skill://spaces-admin",
+        name: "Confluence Space Administration",
+        description: "Space lifecycle (create/update/archive/delete/trash) and color scheme management — real " +
+            "gotchas found live-verifying spaces-admin.ts and color-schemes.ts.",
+        mimeType: "text/markdown",
+        filePath: "spaces-admin.md",
+    },
+    "skill://permissions": {
+        uri: "skill://permissions",
+        name: "Confluence Permissions",
+        description: "Global and space-scoped permission read/grant/revoke/set — real gotchas found " +
+            "live-verifying permissions.ts.",
+        mimeType: "text/markdown",
+        filePath: "permissions.md",
+    },
+    "skill://users-groups": {
+        uri: "skill://users-groups",
+        name: "Confluence Users & Groups",
+        description: "User/group lookup, membership, watching, and admin account management — real gotchas " +
+            "found live-verifying users-groups.ts and admin-users-groups.ts.",
+        mimeType: "text/markdown",
+        filePath: "users-groups.md",
+    },
+    "skill://webhooks": {
+        uri: "skill://webhooks",
+        name: "Confluence Webhooks",
+        description: "Webhook lifecycle and testing — real gotchas found live-verifying webhooks.ts.",
+        mimeType: "text/markdown",
+        filePath: "webhooks.md",
+    },
+    "skill://instance-maintenance": {
+        uri: "skill://instance-maintenance",
+        name: "Confluence Backup, Restore & Search Index",
+        description: "Backup/restore jobs and search index management, including which operations are " +
+            "genuinely irreversible — real gotchas found live-verifying backup-restore.ts and " +
+            "index-management.ts.",
+        mimeType: "text/markdown",
+        filePath: "instance-maintenance.md",
+    },
+    "skill://system": {
+        uri: "skill://system",
+        name: "Confluence System Info & Search",
+        description: "Audit records, cluster status, instance metrics, long-running tasks, cross-entity search, " +
+            "and server information — real gotchas found live-verifying system.ts.",
+        mimeType: "text/markdown",
+        filePath: "system.md",
+    },
+};
+export function getResourceDefinition(uri) {
+    const def = RESOURCE_DEFINITIONS[uri];
+    if (!def) {
+        throw new McpError(ErrorCode.InvalidParams, `Unknown resource: ${uri}`);
+    }
+    return def;
+}
+//# sourceMappingURL=resource-definitions.js.map

package/build/resource-definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-definitions.js","sourceRoot":"","sources":["../src/resource-definitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAWzE,MAAM,CAAC,MAAM,oBAAoB,GAAuC;IACtE,sBAAsB,EAAE;QACtB,GAAG,EAAE,sBAAsB;QAC3B,IAAI,EAAE,2BAA2B;QACjC,WAAW,EAAE,2EAA2E;QACxF,QAAQ,EAAE,eAAe;QACzB,QAAQ,EAAE,iBAAiB;KAC5B;IACD,iBAAiB,EAAE;QACjB,GAAG,EAAE,iBAAiB;QACtB,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,yFAAyF;YACzF,uFAAuF;YACvF,iBAAiB;QACnB,QAAQ,EAAE,eAAe;QACzB,QAAQ,EAAE,YAAY;KACvB;IACD,sBAAsB,EAAE;QACtB,GAAG,EAAE,sBAAsB;QAC3B,IAAI,EAAE,iCAAiC;QACvC,WAAW,EACT,0FAA0F;YAC1F,oEAAoE;QACtE,QAAQ,EAAE,eAAe;QACzB,QAAQ,EAAE,iBAAiB;KAC5B;IACD,qBAAqB,EAAE;QACrB,GAAG,EAAE,qBAAqB;QAC1B,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT,gFAAgF;YAChF,gCAAgC;QAClC,QAAQ,EAAE,eAAe;QACzB,QAAQ,EAAE,gBAAgB;KAC3B;IACD,sBAAsB,EAAE;QACtB,GAAG,EAAE,sBAAsB;QAC3B,IAAI,EAAE,2BAA2B;QACjC,WAAW,EACT,uFAAuF;YACvF,iEAAiE;QACnE,QAAQ,EAAE,eAAe;QACzB,QAAQ,EAAE,iBAAiB;KAC5B;IACD,kBAAkB,EAAE;QAClB,GAAG,EAAE,kBAAkB;QACvB,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,gFAAgF;QAC7F,QAAQ,EAAE,eAAe;QACzB,QAAQ,EAAE,aAAa;KACxB;IACD,8BAA8B,EAAE;QAC9B,GAAG,EAAE,8BAA8B;QACnC,IAAI,EAAE,2CAA2C;QACjD,WAAW,EACT,kFAAkF;YAClF,mFAAmF;YACnF,sBAAsB;QACxB,QAAQ,EAAE,eAAe;QACzB,QAAQ,EAAE,yBAAyB;KACpC;IACD,gBAAgB,EAAE;QAChB,GAAG,EAAE,gBAAgB;QACrB,IAAI,EAAE,iCAAiC;QACvC,WAAW,EACT,4FAA4F;YAC5F,uEAAuE;QACzE,QAAQ,EAAE,eAAe;QACzB,QAAQ,EAAE,WAAW;KACtB;CACF,CAAC;AAEF,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,MAAM,GAAG,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,aAAa,EAAE,qBAAqB,GAAG,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/build/tool-definitions.d.ts

@@ -0,0 +1,19 @@
+import { ConfluenceClient } from "./confluence-client.js";
+import { type ToolResult } from "./tools/spaces-pages.js";
+export interface ToolDefinitionServer {
+    requireUserClient(): ConfluenceClient;
+    requireAdminClient(): ConfluenceClient;
+    handleGetApiReferences(args: Record<string, unknown> | undefined): Promise<ToolResult>;
+}
+export interface ToolDefinition {
+    description: string;
+    inputSchema: Record<string, unknown>;
+    requiresAdmin?: boolean;
+    handler: (server: ToolDefinitionServer, args: unknown) => Promise<ToolResult>;
+}
+export declare const TOOL_DEFINITIONS: Record<string, ToolDefinition>;
+/**
+ * Pure filter used by the ListTools handler — admin-flagged tools are dropped entirely from the
+ * advertised tool list when no admin client is configured, not just rejected at call time.
+ */
+export declare function listableToolEntries(adminAvailable: boolean): Array<[string, ToolDefinition]>;