Outline Wiki MCP Server

Instructions

Implementation Reference

• src/lib/handlers/smart.ts:107-128 (handler)

  The core handler function that implements the summarize_document tool logic: checks if brain is enabled, fetches the full document content via Outline API, and generates a summary using the brain module.

  async summarize_document(args: { documentId: string; language?: string }) {
    if (!brain.isEnabled()) {
      return { error: ERROR_MESSAGES.SMART_FEATURES_DISABLED };
    }
  
    // Fetch document
    const { data } = await apiCall(() =>
      apiClient.post<OutlineDocument>('/documents.info', { id: args.documentId })
    );
  
    if (!data.text) {
      return { error: ERROR_MESSAGES.NO_CONTENT_TO_SUMMARIZE };
    }
  
    const summary = await brain.summarize(data.text, args.language);
  
    return {
      documentId: data.id,
      title: data.title,
      summary,
    };
  },

• src/lib/schemas.ts:150-153 (schema)

  Zod schema defining the input parameters for the summarize_document tool: documentId (required) and language (optional).

  export const summarizeDocumentSchema = z.object({
    documentId,
    language: z.string().optional(),
  });

• src/lib/tools.ts:210-214 (registration)

  Registers the tool definition for MCP, including name, description, and conversion of Zod schema to JSON schema.

  createTool(
    'summarize_document',
    'Generate an AI-powered summary of a document.',
    'summarize_document'
  ),

• src/lib/handlers/index.ts:19-28 (registration)

  Combines all handlers, including smart handlers (which contain summarize_document), into a single ToolHandlers object for use in MCP.

  export function createAllHandlers(ctx: AppContext): ToolHandlers {
    return {
      ...createSearchHandlers(ctx),
      ...createDocumentHandlers(ctx),
      ...createCollectionHandlers(ctx),
      ...createCommentHandlers(ctx),
      ...createBatchHandlers(ctx),
      ...createSmartHandlers(ctx),
    } as ToolHandlers;
  }