outline-mcp-server 5.4.0 → 5.5.0

package/README.md

@@ -59,13 +59,18 @@ One click install in Cursor:
 `outline-mcp-server` supports the latest streamable-http protocol, the deprecated sse protocol, and good ole fashioned stdio.
 
 ```bash
-# S-HTTP/SSE servers
+# S-HTTP/SSE servers (with optional env var)
 OUTLINE_API_KEY=... npx -y outline-mcp-server@latest
 
-# STDIO
+# S-HTTP/SSE servers (without env var, use headers for auth)
+npx -y outline-mcp-server@latest
+
+# STDIO (requires env var)
 OUTLINE_API_KEY=... npx -y --package=outline-mcp-server@latest -c outline-mcp-server-stdio
 ```
 
+When running HTTP/SSE servers without an environment variable, you'll need to provide the API key in your request headers. The server will display available authentication methods on startup.
+
 ### Cursor (mcp.json)
 
 Add the following MCP definition to your configuration:
@@ -85,9 +90,33 @@ Add the following MCP definition to your configuration:
 }
 ```
 
+### Authentication
+
+The Outline MCP server supports two authentication methods:
+
+1. **Environment Variable (Required for stdio mode)**: Set `OUTLINE_API_KEY` as an environment variable
+2. **Request Headers (HTTP/SSE modes)**: Provide the API key in request headers
+
+For **stdio mode**, the API key environment variable is required and validated on startup.
+
+For **HTTP/SSE modes**, you have two options:
+
+- Set `OUTLINE_API_KEY` as an environment variable (fallback method)
+- Provide API key in request headers (recommended for per-request authentication)
+
+#### Header-based Authentication
+
+When using HTTP/SSE endpoints, you can provide the API key using any of these headers:
+
+- `x-outline-api-key: your_api_key_here`
+- `outline-api-key: your_api_key_here`
+- `authorization: Bearer your_api_key_here`
+
+If no header is provided, the server will fall back to the `OUTLINE_API_KEY` environment variable. If neither is available, the request will fail with an authentication error.
+
 ### Env vars
 
-- `OUTLINE_API_KEY` (_required_): your API key for outline, duh
+- `OUTLINE_API_KEY` (_required for stdio, optional for HTTP/SSE_): your API key for outline
 - `OUTLINE_API_URL` (_optional_): Alternative URL for your outline API (if using an alt domain/self-hosting)
 - `OUTLINE_MCP_PORT` (_optional_): Specify the port on which the server will run (default: 6060)
 - `OUTLINE_MCP_HOST` (_optional_): Host/IP to bind the server to (default: 127.0.0.1). Use 0.0.0.0 to bind to all network interfaces

package/build/index.js

@@ -3,29 +3,70 @@ import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/
 import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
 import fastify from 'fastify';
 import { getMcpServer } from './utils/getMcpServer.js';
-const mcpServer = await getMcpServer();
+import { RequestContext } from './utils/toolRegistry.js';
+/**
+ * Extracts API key from request headers
+ */
+function extractApiKey(request) {
+    // Check common header variations
+    const headers = request.headers;
+    return (headers['x-outline-api-key'] ||
+        headers['outline-api-key'] ||
+        headers['authorization']?.replace(/^Bearer\s+/i, ''));
+}
+/**
+ * Sets up request context with API key
+ */
+function setupRequestContext(request) {
+    const apiKey = extractApiKey(request);
+    const envApiKey = process.env.OUTLINE_API_KEY;
+    if (apiKey) {
+        // Use header API key
+        const context = RequestContext.getInstance();
+        context.setApiKey(apiKey);
+        console.log('Using API key from request headers');
+    }
+    else if (envApiKey) {
+        // Use environment variable API key
+        const context = RequestContext.getInstance();
+        context.setApiKey(envApiKey);
+        console.log('Using API key from environment variable');
+    }
+    else {
+        // No API key available
+        console.log('No API key provided in headers and no default environment variable set.');
+        console.log('Please set the OUTLINE_API_KEY environment variable or provide it in the request headers.');
+        throw new Error('API key required: Set OUTLINE_API_KEY environment variable or provide x-outline-api-key header');
+    }
+}
 // HTTP mode - default behavior
 const app = fastify();
 // Stateless mode (default, recommended for most deployments)
 app.post('/mcp', async (request, reply) => {
     try {
+        // Setup request context with API key
+        setupRequestContext(request);
+        const mcpServer = await getMcpServer();
         const httpTransport = new StreamableHTTPServerTransport({
             sessionIdGenerator: undefined,
         });
         reply.raw.on('close', () => {
             httpTransport.close();
             mcpServer.close();
+            // Clean up context
+            RequestContext.resetInstance();
         });
         await mcpServer.connect(httpTransport);
         await httpTransport.handleRequest(request.raw, reply.raw, request.body);
     }
     catch (error) {
+        console.error('Error in /mcp endpoint:', error.message);
         if (!reply.sent) {
             reply.code(500).send({
                 jsonrpc: '2.0',
                 error: {
                     code: -32603,
-                    message: 'Internal server error',
+                    message: error.message || 'Internal server error',
                 },
                 id: null,
             });
@@ -56,6 +97,9 @@ app.delete('/mcp', async (request, reply) => {
 let sseTransport = null;
 app.get('/sse', async (request, reply) => {
     try {
+        // Setup request context with API key
+        setupRequestContext(request);
+        const mcpServer = await getMcpServer();
         // Create SSE transport for legacy clients
         if (!sseTransport) {
             sseTransport = new SSEServerTransport('/messages', reply.raw);
@@ -63,13 +107,13 @@ app.get('/sse', async (request, reply) => {
         }
     }
     catch (error) {
-        console.error(error);
+        console.error('Error in /sse endpoint:', error.message);
         if (!reply.sent) {
             reply.code(500).send({
                 jsonrpc: '2.0',
                 error: {
                     code: -32603,
-                    message: 'Internal server error',
+                    message: error.message || 'Internal server error',
                 },
                 id: null,
             });
@@ -78,11 +122,18 @@ app.get('/sse', async (request, reply) => {
 });
 // Legacy message endpoint for older clients
 app.post('/messages', async (req, res) => {
-    if (!sseTransport) {
-        res.status(400).send('No transport found');
-        return;
+    try {
+        setupRequestContext(req);
+        if (!sseTransport) {
+            res.status(400).send('No transport found');
+            return;
+        }
+        await sseTransport.handlePostMessage(req.raw, res.raw, req.body);
+    }
+    catch (error) {
+        console.error('Error in /messages endpoint:', error.message);
+        res.status(500).send(error.message || 'Internal server error');
     }
-    await sseTransport.handlePostMessage(req.raw, res.raw, req.body);
 });
 const PORT = process.env.OUTLINE_MCP_PORT ? parseInt(process.env.OUTLINE_MCP_PORT, 10) : 6060;
 const HOST = process.env.OUTLINE_MCP_HOST || '127.0.0.1';
@@ -91,6 +142,10 @@ app.listen({ port: PORT, host: HOST }, (err, address) => {
         console.error(err);
         process.exit(1);
     }
-    console.log(`\n\nOutline MCP Server running:\n\tstreamable-http: ${address}/mcp\n\tsse (deprecated): ${address}/sse\n\n`);
-    console.log('To use this MCP server in stdio mode, run it via `outline-mcp-server-stdio`.');
+    console.log(`\n\nOutline MCP Server running:\n\tstreamable-http: http://${HOST}:${PORT}/mcp\n\tsse (deprecated): http://${HOST}:${PORT}/sse\n\n`);
+    console.log('API Key Configuration:');
+    console.log('- Set OUTLINE_API_KEY environment variable for default authentication');
+    console.log('- Or provide x-outline-api-key header in requests for per-request authentication');
+    console.log('- Or provide authorization header with Bearer token');
+    console.log('\nTo use this MCP server in stdio mode, run it via `outline-mcp-server-stdio`.');
 });

package/build/outline/outlineClient.js

@@ -2,19 +2,56 @@ import axios from 'axios';
 import { config } from 'dotenv';
 import { dirname, join } from 'path';
 import { fileURLToPath } from 'url';
+import { RequestContext } from '../utils/toolRegistry.js';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 config({ path: join(__dirname, '..', '.env') });
-const API_KEY = process.env.OUTLINE_API_KEY;
 const API_URL = process.env.OUTLINE_API_URL || 'https://app.getoutline.com/api';
-if (!API_KEY) {
-    throw new Error('OUTLINE_API_KEY environment variable is required');
+/**
+ * Creates an Outline API client with the specified API key
+ */
+export function createOutlineClient(apiKey) {
+    const key = apiKey || process.env.OUTLINE_API_KEY;
+    if (!key) {
+        throw new Error('OUTLINE_API_KEY must be provided either as parameter or environment variable');
+    }
+    return axios.create({
+        baseURL: API_URL,
+        headers: {
+            Authorization: `Bearer ${key}`,
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+        },
+    });
 }
-// Create axios client with authentication
-export const outlineClient = axios.create({
-    baseURL: API_URL,
-    headers: {
-        Authorization: `Bearer ${API_KEY}`,
-        'Content-Type': 'application/json',
-        Accept: 'application/json',
+/**
+ * Gets an outline client using context API key first, then environment variable
+ */
+export function getOutlineClient() {
+    const context = RequestContext.getInstance();
+    const contextApiKey = context.getApiKey();
+    if (contextApiKey) {
+        return createOutlineClient(contextApiKey);
+    }
+    return createOutlineClient();
+}
+/**
+ * Gets the default outline client using environment variable
+ * Only validates when called, not on import
+ */
+export function getDefaultOutlineClient() {
+    return createOutlineClient();
+}
+/**
+ * Default client instance for backward compatibility
+ * Note: This will only validate API key when first accessed, not on import
+ */
+let _defaultClient = null;
+export const outlineClient = new Proxy({}, {
+    get(target, prop) {
+        if (!_defaultClient) {
+            _defaultClient = getDefaultOutlineClient();
+        }
+        const value = _defaultClient[prop];
+        return typeof value === 'function' ? value.bind(_defaultClient) : value;
     },
 });

package/build/stdio.js

@@ -1,6 +1,11 @@
 #!/usr/bin/env bun
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { getMcpServer } from './utils/getMcpServer.js';
+// Validate API key for stdio mode
+if (!process.env.OUTLINE_API_KEY) {
+    console.error('Error: OUTLINE_API_KEY environment variable is required for stdio mode');
+    process.exit(1);
+}
 const mcpServer = await getMcpServer();
 // STDIO mode - for direct client connections
 const transport = new StdioServerTransport();

package/build/tools/archiveDocument.js

@@ -1,5 +1,5 @@
 import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { outlineClient } from '../outline/outlineClient.js';
+import { getOutlineClient } from '../outline/outlineClient.js';
 import toolRegistry from '../utils/toolRegistry.js';
 import { z } from 'zod';
 // Register this tool
@@ -11,7 +11,8 @@ toolRegistry.register('archive-document', {
     },
     async callback(args) {
         try {
-            const response = await outlineClient.post('/documents.archive', {
+            const client = getOutlineClient();
+            const response = await client.post('/documents.archive', {
                 id: args.id,
             });
             return { content: [{ type: 'text', text: JSON.stringify(response.data.data) }] };

package/build/tools/askDocuments.js

@@ -1,5 +1,5 @@
 import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { outlineClient } from '../outline/outlineClient.js';
+import { getOutlineClient } from '../outline/outlineClient.js';
 import toolRegistry from '../utils/toolRegistry.js';
 import z from 'zod';
 // Register this tool
@@ -43,7 +43,8 @@ toolRegistry.register('ask_documents', {
             if (args.dateFilter) {
                 payload.dateFilter = args.dateFilter;
             }
-            const response = await outlineClient.post('/documents.answerQuestion', payload);
+            const client = getOutlineClient();
+            const response = await client.post('/documents.answerQuestion', payload);
             return { content: [{ type: 'text', text: JSON.stringify(response.data.data) }] };
         }
         catch (error) {

package/build/tools/createCollection.js

@@ -1,5 +1,5 @@
 import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { outlineClient } from '../outline/outlineClient.js';
+import { getOutlineClient } from '../outline/outlineClient.js';
 import toolRegistry from '../utils/toolRegistry.js';
 import z from 'zod';
 // Register this tool
@@ -33,7 +33,8 @@ toolRegistry.register('create_collection', {
             if (args.private !== undefined) {
                 payload.private = args.private;
             }
-            const response = await outlineClient.post('/collections.create', payload);
+            const client = getOutlineClient();
+            const response = await client.post('/collections.create', payload);
             return { content: [{ type: 'text', text: JSON.stringify(response.data.data) }] };
         }
         catch (error) {

package/build/tools/createComment.js

@@ -1,5 +1,5 @@
 import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { outlineClient } from '../outline/outlineClient.js';
+import { getOutlineClient } from '../outline/outlineClient.js';
 import toolRegistry from '../utils/toolRegistry.js';
 import z from 'zod';
 // Register this tool
@@ -27,7 +27,8 @@ toolRegistry.register('create_comment', {
             if (args.data) {
                 payload.data = args.data;
             }
-            const response = await outlineClient.post('/comments.create', payload);
+            const client = getOutlineClient();
+            const response = await client.post('/comments.create', payload);
             return { content: [{ type: 'text', text: JSON.stringify(response.data.data) }] };
         }
         catch (error) {

package/build/tools/createDocument.js

@@ -1,5 +1,5 @@
 import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { outlineClient } from '../outline/outlineClient.js';
+import { getOutlineClient } from '../outline/outlineClient.js';
 import toolRegistry from '../utils/toolRegistry.js';
 import z from 'zod';
 // Register this tool
@@ -33,7 +33,8 @@ toolRegistry.register('create_document', {
             if (args.template !== undefined) {
                 payload.template = args.template;
             }
-            const response = await outlineClient.post('/documents.create', payload);
+            const client = getOutlineClient();
+            const response = await client.post('/documents.create', payload);
             return { content: [{ type: 'text', text: JSON.stringify(response.data.data) }] };
         }
         catch (error) {

package/build/tools/createTemplateFromDocument.js

@@ -1,5 +1,5 @@
 import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { outlineClient } from '../outline/outlineClient.js';
+import { getOutlineClient } from '../outline/outlineClient.js';
 import toolRegistry from '../utils/toolRegistry.js';
 import z from 'zod';
 // Register this tool
@@ -14,7 +14,8 @@ toolRegistry.register('create_template_from_document', {
             const payload = {
                 id: args.id,
             };
-            const response = await outlineClient.post('/documents.templatize', payload);
+            const client = getOutlineClient();
+            const response = await client.post('/documents.templatize', payload);
             return { content: [{ type: 'text', text: JSON.stringify(response.data.data) }] };
         }
         catch (error) {

package/build/tools/deleteComment.js

@@ -1,5 +1,5 @@
 import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { outlineClient } from '../outline/outlineClient.js';
+import { getOutlineClient } from '../outline/outlineClient.js';
 import toolRegistry from '../utils/toolRegistry.js';
 import z from 'zod';
 // Register this tool
@@ -11,7 +11,8 @@ toolRegistry.register('delete_comment', {
     },
     async callback(args) {
         try {
-            const response = await outlineClient.post('/comments.delete', {
+            const client = getOutlineClient();
+            const response = await client.post('/comments.delete', {
                 id: args.id,
             });
             return { content: [{ type: 'text', text: JSON.stringify(response.data.success) }] };

package/build/tools/deleteDocument.js

@@ -1,5 +1,5 @@
 import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { outlineClient } from '../outline/outlineClient.js';
+import { getOutlineClient } from '../outline/outlineClient.js';
 import toolRegistry from '../utils/toolRegistry.js';
 import z from 'zod';
 // Register this tool
@@ -11,7 +11,8 @@ toolRegistry.register('delete_document', {
     },
     async callback(args) {
         try {
-            const response = await outlineClient.post('/documents.delete', {
+            const client = getOutlineClient();
+            const response = await client.post('/documents.delete', {
                 id: args.id,
             });
             return { content: [{ type: 'text', text: JSON.stringify(response.data.success) }] };

package/build/tools/getCollection.js

@@ -1,5 +1,5 @@
 import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { outlineClient } from '../outline/outlineClient.js';
+import { getOutlineClient } from '../outline/outlineClient.js';
 import toolRegistry from '../utils/toolRegistry.js';
 import z from 'zod';
 // Register this tool
@@ -11,7 +11,8 @@ toolRegistry.register('get_collection', {
     },
     async callback(args) {
         try {
-            const response = await outlineClient.post(`/collections.info`, { id: args.id });
+            const client = getOutlineClient();
+            const response = await client.post(`/collections.info`, { id: args.id });
             return { content: [{ type: 'text', text: JSON.stringify(response.data.data) }] };
         }
         catch (error) {

package/build/tools/getDocument.js

@@ -1,5 +1,5 @@
 import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { outlineClient } from '../outline/outlineClient.js';
+import { getOutlineClient } from '../outline/outlineClient.js';
 import toolRegistry from '../utils/toolRegistry.js';
 import z from 'zod';
 // Register this tool
@@ -13,7 +13,8 @@ toolRegistry.register('get_document', {
     },
     async callback(args) {
         try {
-            const response = await outlineClient.post('/documents.info', { id: args.id });
+            const client = getOutlineClient();
+            const response = await client.post('/documents.info', { id: args.id });
             return { content: [{ type: 'text', text: JSON.stringify(response.data.data) }] };
         }
         catch (error) {

package/build/tools/listCollections.js

@@ -1,5 +1,5 @@
 import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { outlineClient } from '../outline/outlineClient.js';
+import { getOutlineClient } from '../outline/outlineClient.js';
 import toolRegistry from '../utils/toolRegistry.js';
 import z from 'zod';
 // Register this tool
@@ -15,7 +15,8 @@ toolRegistry.register('list_collections', {
             if (args.limit) {
                 payload.limit = args.limit;
             }
-            const response = await outlineClient.post('/collections.list', payload);
+            const client = getOutlineClient();
+            const response = await client.post('/collections.list', payload);
             return {
                 content: [
                     {

package/build/tools/listDocuments.js

@@ -1,5 +1,5 @@
 import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { outlineClient } from '../outline/outlineClient.js';
+import { getOutlineClient } from '../outline/outlineClient.js';
 import toolRegistry from '../utils/toolRegistry.js';
 import z from 'zod';
 // Register this tool
@@ -49,7 +49,8 @@ toolRegistry.register('list_documents', {
                 payload.query = args.query;
             }
             // Make the POST request to the documents.list endpoint
-            const response = await outlineClient.post('/documents.list', payload);
+            const client = getOutlineClient();
+            const response = await client.post('/documents.list', payload);
             // Transform the response to a more usable format
             const documents = response.data.data;
             // Return the documents with additional metadata

package/build/tools/listUsers.js

@@ -1,5 +1,5 @@
 import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { outlineClient } from '../outline/outlineClient.js';
+import { getOutlineClient } from '../outline/outlineClient.js';
 import toolRegistry from '../utils/toolRegistry.js';
 import z from 'zod';
 // Register this tool
@@ -55,7 +55,8 @@ toolRegistry.register('list_users', {
             if (args.role) {
                 payload.role = args.role;
             }
-            const response = await outlineClient.post('/users.list', payload);
+            const client = getOutlineClient();
+            const response = await client.post('/users.list', payload);
             return {
                 content: [
                     { type: 'text', text: `users: ${JSON.stringify(response.data.data)}` },

package/build/tools/moveDocument.js

@@ -1,5 +1,5 @@
 import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { outlineClient } from '../outline/outlineClient.js';
+import { getOutlineClient } from '../outline/outlineClient.js';
 import toolRegistry from '../utils/toolRegistry.js';
 import z from 'zod';
 // Register this tool
@@ -28,7 +28,8 @@ toolRegistry.register('move_document', {
             if (args.parentDocumentId) {
                 payload.parentDocumentId = args.parentDocumentId;
             }
-            const response = await outlineClient.post('/documents.move', payload);
+            const client = getOutlineClient();
+            const response = await client.post('/documents.move', payload);
             return { content: [{ type: 'text', text: JSON.stringify(response.data.data) }] };
         }
         catch (error) {

package/build/tools/searchDocuments.js

@@ -1,5 +1,5 @@
 import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { outlineClient } from '../outline/outlineClient.js';
+import { getOutlineClient } from '../outline/outlineClient.js';
 import toolRegistry from '../utils/toolRegistry.js';
 import z from 'zod';
 // Register this tool
@@ -22,7 +22,8 @@ toolRegistry.register('search_documents', {
             if (args.limit) {
                 payload.limit = args.limit;
             }
-            const response = await outlineClient.post('/documents.search', payload);
+            const client = getOutlineClient();
+            const response = await client.post('/documents.search', payload);
             return {
                 content: [
                     { type: 'text', text: `documents: ${JSON.stringify(response.data.data)}` },

package/build/tools/updateCollection.js

@@ -1,5 +1,5 @@
 import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { outlineClient } from '../outline/outlineClient.js';
+import { getOutlineClient } from '../outline/outlineClient.js';
 import toolRegistry from '../utils/toolRegistry.js';
 import z from 'zod';
 // Register this tool
@@ -33,7 +33,8 @@ toolRegistry.register('update_collection', {
             if (args.color) {
                 payload.color = args.color;
             }
-            const response = await outlineClient.post('/collections.update', payload);
+            const client = getOutlineClient();
+            const response = await client.post('/collections.update', payload);
             return { content: [{ type: 'text', text: JSON.stringify(response.data.data) }] };
         }
         catch (error) {

package/build/tools/updateComment.js

@@ -1,5 +1,5 @@
 import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { outlineClient } from '../outline/outlineClient.js';
+import { getOutlineClient } from '../outline/outlineClient.js';
 import toolRegistry from '../utils/toolRegistry.js';
 import z from 'zod';
 // Register this tool
@@ -22,7 +22,8 @@ toolRegistry.register('update_comment', {
             if (args.data) {
                 payload.data = args.data;
             }
-            const response = await outlineClient.post('/comments.update', payload);
+            const client = getOutlineClient();
+            const response = await client.post('/comments.update', payload);
             return { content: [{ type: 'text', text: JSON.stringify(response.data.data) }] };
         }
         catch (error) {

package/build/tools/updateDocument.js

@@ -1,5 +1,5 @@
 import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { outlineClient } from '../outline/outlineClient.js';
+import { getOutlineClient } from '../outline/outlineClient.js';
 import toolRegistry from '../utils/toolRegistry.js';
 import z from 'zod';
 // Register this tool
@@ -30,7 +30,8 @@ toolRegistry.register('update_document', {
             if (args.done !== undefined) {
                 payload.done = args.done;
             }
-            const response = await outlineClient.post('/documents.update', payload);
+            const client = getOutlineClient();
+            const response = await client.post('/documents.update', payload);
             return { content: [{ type: 'text', text: JSON.stringify(response.data.data) }] };
         }
         catch (error) {

package/build/utils/toolRegistry.js

@@ -1,3 +1,34 @@
+// Context to store request-specific data
+export class RequestContext {
+    constructor() {
+        this.context = new Map();
+    }
+    static getInstance() {
+        if (!RequestContext.instance) {
+            RequestContext.instance = new RequestContext();
+        }
+        return RequestContext.instance;
+    }
+    static resetInstance() {
+        RequestContext.instance = null;
+    }
+    set(key, value) {
+        this.context.set(key, value);
+    }
+    get(key) {
+        return this.context.get(key);
+    }
+    clear() {
+        this.context.clear();
+    }
+    getApiKey() {
+        return this.get('apiKey');
+    }
+    setApiKey(apiKey) {
+        this.set('apiKey', apiKey);
+    }
+}
+RequestContext.instance = null;
 class ToolRegistry {
     constructor() {
         this.registry = new Map();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "outline-mcp-server",
-  "version": "5.4.0",
+  "version": "5.5.0",
   "description": "An MCP server for interacting with Outline's API",
   "type": "module",
   "bin": {