# BookStack (Wiki) MCP for AI Agents MCP

> BookStack (Wiki) gives your AI agent complete control over structured documentation. Search, create, update, and export entire knowledge bases—from internal policies to technical specs—all through natural conversation.

## Overview
- **Category:** collaboration
- **Price:** Free
- **Tags:** wiki, documentation, knowledge-base, bookstack, content-organization

## Description

Think of this MCP as connecting your entire company wiki directly into your workflow. Instead of manually navigating folders or copying text from multiple pages, you talk to your agent like you’re talking to a teammate who already knows the system inside and out.

It turns dry documentation into an active knowledge resource. You can ask for an overview of all books on 'Networking', have the agent compile the details, and then use that information to draft a new chapter or update an old one. The entire process happens conversationally. Once you subscribe through Vinkius, your AI client gains access to this powerful set of tools, letting you treat your documentation structure—shelves, books, chapters, and pages—as a single entity you can manipulate with simple instructions.

## Tools

### create_attachment
Creates a new link for an attachment file within the wiki.

### create_book
Adds a new container (Book) to your documentation structure.

### create_chapter
Creates a section (Chapter) inside an existing Book.

### create_page
Generates a brand new wiki page, requiring content and placement within a chapter or book.

### create_shelf
Establishes a top-level container (Shelf) for grouping related documentation books.

### delete_attachment
Removes an attachment link that was previously added to the wiki content.

### delete_book
Permanently removes a Book, requiring confirmation of contents deletion.

### delete_chapter
Removes a Chapter and all associated pages within it.

### delete_page
Deletes a wiki page, moving its content to the recycle bin first.

### delete_shelf
Removes an entire Shelf container from the top level of the knowledge base.

### export_book
Exports all content from a specified Book into external formats.

### export_chapter
Exports all content from a specific Chapter for offline use.

### export_page
Retrieves the content of a single page into formats like PDF or Markdown.

### get_attachment
Fetches the details and metadata for an existing attachment link.

### get_book
Retrieves all stored information about a specific Book, including its chapters and pages.

### get_chapter
Gets the full details of a chapter, showing its contents and structure.

### get_page
Retrieves all content and metadata for a single wiki page.

### get_shelf
Fetches the details of an entire Shelf, listing its contained books.

### get_system_status
Checks the current operational status and version information for the wiki instance.

### list_attachments
List all attachments in BookStack

### list_audit_log
Retrieves a list of recent system activity, showing who made changes and when.

### list_books
Lists all the main Books available in the entire wiki structure.

### list_chapters
Provides a list of every Chapter currently defined across all books.

### list_pages
Lists all individual pages in the wiki, supporting sorting and filtering by criteria.

### list_recycle_bin
Shows a list of items (books, pages, etc.) that have been deleted but can be restored.

### list_shelves
Lists all top-level organizational Shelves in the wiki.

### search
Searches across every piece of content, titles, and metadata within the entire BookStack wiki.

### update_attachment
Modifies or replaces an existing attachment link on a page.

### update_book
Makes modifications to the metadata or structure of an existing Book.

### update_chapter
Updates the details and content within a specific Chapter container.

### update_page
Edits the title, content, or metadata of an existing wiki page.

### update_shelf
Modifies the details and structure of a top-level Shelf container.

## Prompt Examples

**Prompt:** 
```
I need to create a new section about our payment methods for the 'Getting Started' book.
```

**Response:** 
```
Okay, I've set up the structure. Here are the steps:

1. **Created Shelf:** 'Billing & Payments'
2. **Created Book:** 'Payment Methods Guide'
3. **Created Chapter:** 'Visa/Mastercard Details'
4. **Created Page:** 'PCI Compliance Overview' (ID: 890)

You can now fill in the details on page ID 890.
```

**Prompt:** 
```
Find all documentation related to our legacy payment gateway and export it as a PDF.
```

**Response:** 
```
**Payment Gateway Archive Report**

I found three pages relevant to the old system:
*   Page: Legacy API Specs (Book ID 12, Chapter ID 3)
*   Page: Decommissioning Timeline (Book ID 12, Chapter ID 4)
*   Page: Data Migration Guide (Book ID 12, Chapter ID 5)

I have compiled all three into a single PDF export for you to download.
```

**Prompt:** 
```
Show me the last five times someone changed the API rate limit page.
```

**Response:** 
```
**Audit Log: Rate Limit Page (ID: 42)**

Here are the most recent changes:
*   **Oct 1, 2023:** John Doe updated content on `update_page`.
*   **Sept 28, 2023:** Jane Smith added attachment link to `create_attachment`.
*   **Sept 25, 2023:** System automated update via `update_book`.

The last change was a content modification on October 1st.
```

## Capabilities

### Search the entire knowledge base
Find specific policies or technical details across every book and page in your wiki instance.

### Structure and organize content hierarchy
Create, update, and delete foundational elements like shelves, books, chapters, and pages to keep documentation perfectly organized.

### Generate new documents or sections
Write entirely new wiki pages, complete with markdown or HTML content, directly from your chat window.

### Manage attachments and files
Attach, retrieve details for, or delete linked files related to specific documentation items.

### Export content for external use
Pull content from a page, chapter, or entire book into common formats like PDF, Markdown, or plain text.

### Monitor and audit system changes
Review the system status or check the list of recent activity logs to track who changed what and when.

## Use Cases

### A new hire needs to understand the compliance structure.
Instead of reading a massive manual, the agent uses `search` to pull up only 'GDPR guidelines' and compiles them into a single, summarized document for the new hire.

### The engineering team updated the API specs.
An engineer asks the agent to update the core documentation. The agent uses `update_page` on the relevant page and calls `list_audit_log` afterward to confirm that the change was successfully recorded.

### Support needs to create a new troubleshooting guide.
The support lead asks the agent to build a whole new section. The agent uses `create_shelf`, then `create_book`, followed by several calls to `create_page` to structure the entire flow.

### A book needs to be archived and shared with external partners.
The agent is instructed to export the entire 'Partners API Reference' Book using `export_book`, ensuring all content is delivered in a single, readable PDF file.

## Benefits

- Search across the whole wiki: Use the `search` tool to find specific policies or specs instantly, eliminating time spent clicking through irrelevant folders.
- Maintain perfect organization: Easily manage the entire hierarchy by calling tools like `create_shelf`, `list_books`, and `update_chapter` to keep documentation clean.
- Rapid content creation: Write new pages using `create_page` or draft full chapters with `create_chapter`, letting your agent handle the structural placement.
- Future-proof documentation: When an article needs external sharing, use `export_page` or `export_book` to get reliable PDF, Markdown, or HTML versions immediately.
- Full lifecycle management: The agent handles the messy parts—you can delete old content with `delete_page`, and track it all using `list_audit_log`.

## How It Works

The bottom line is that once connected, your AI client acts as a full-time documentation administrator for your wiki.

1. Subscribe to this MCP in Vinkius, then provide your BookStack URL, Token ID, and Token Secret credentials.
2. Your AI client connects using these credentials, granting it full read/write access to your wiki structure.
3. You tell the agent what you need—for example, 'Find all pages about API rate limits.' The MCP executes the request and returns the structured data.

## Frequently Asked Questions

**How does the BookStack (Wiki) MCP help me organize my documentation?**
It lets you manage your entire wiki structure—shelves, books, chapters, and pages—using simple conversations. Instead of clicking through menus, you just tell your agent to create a book or list all related chapters.

**Can the BookStack (Wiki) MCP export content in multiple formats?**
Yes. You can request that an entire book, chapter, or single page be exported as PDF, Markdown, HTML, or plain text for external use or archiving.

**Does the BookStack (Wiki) MCP let me update old technical specifications?**
Absolutely. You can tell your agent to find a specific page and perform updates using tools like `update_page` or `update_book`, ensuring your specs are always current.

**Is the BookStack (Wiki) MCP only for reading documentation?**
No, it's highly active. You can create new content from scratch by generating pages and chapters, or you can delete outdated material using `delete_page`.

**How do I check who changed something in the wiki with this MCP?**
The agent can run a query against the system's audit log (`list_audit_log`), showing you exactly which user made changes, when they did it, and what was modified.