BookStack (Wiki) MCP Server for Pydantic AIGive Pydantic AI instant access to 32 tools to Create Attachment, Create Book, Create Chapter, and more
Pydantic AI brings type-safe agent development to Python with first-class MCP support. Connect BookStack (Wiki) through Vinkius and every tool is automatically validated against Pydantic schemas. catch errors at build time, not in production.
Ask AI about this MCP Server for Pydantic AI
The BookStack (Wiki) MCP Server for Pydantic AI is a standout in the Collaboration category — giving your AI agent 32 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
import asyncio
from pydantic_ai import Agent
from pydantic_ai.mcp import MCPServerHTTP
async def main():
# Your Vinkius token. get it at cloud.vinkius.com
server = MCPServerHTTP(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
agent = Agent(
model="openai:gpt-4o",
mcp_servers=[server],
system_prompt=(
"You are an assistant with access to BookStack (Wiki) "
"(32 tools)."
),
)
result = await agent.run(
"What tools are available in BookStack (Wiki)?"
)
print(result.data)
asyncio.run(main())
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About BookStack (Wiki) MCP Server
Connect your BookStack instance to any AI agent and turn your documentation into an interactive knowledge base through natural conversation.
Pydantic AI validates every BookStack (Wiki) tool response against typed schemas, catching data inconsistencies at build time. Connect 32 tools through Vinkius and switch between OpenAI, Anthropic, or Gemini without changing your integration code. full type safety, structured output guarantees, and dependency injection for testable agents.
What you can do
- Content Hierarchy — List and manage shelves, books, chapters, and pages using
list_shelves,list_books, andlist_pagesto maintain perfect organization. - Smart Search — Find exactly what you need across your entire wiki instance with the powerful
searchtool. - Full Content Lifecycle — Create, update, or delete pages and chapters directly from your agent to keep documentation fresh.
- Multi-format Export — Use
export_pageto retrieve content in PDF, Markdown, HTML, or Plaintext formats for external use. - System Oversight — Monitor your instance with
get_system_status, checklist_audit_logfor recent changes, or manage thelist_recycle_bin. - Attachments — Manage file attachments linked to your documentation using the dedicated attachment tools.
The BookStack (Wiki) MCP Server exposes 32 tools through the Vinkius. Connect it to Pydantic AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 32 BookStack (Wiki) tools available for Pydantic AI
When Pydantic AI connects to BookStack (Wiki) through Vinkius, your AI agent gets direct access to every tool listed below — spanning wiki, documentation, knowledge-base, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Create attachment on BookStack (Wiki)
Create a new attachment link
Create book on BookStack (Wiki)
Create a new book
Create chapter on BookStack (Wiki)
Create a new chapter
Create page on BookStack (Wiki)
Requires either book_id or chapter_id, name, and html or markdown. Create a new page in BookStack
Create shelf on BookStack (Wiki)
Create a new shelf
Delete attachment on BookStack (Wiki)
Delete an attachment
Delete book on BookStack (Wiki)
Delete a book
Delete chapter on BookStack (Wiki)
Delete a chapter
Delete page on BookStack (Wiki)
Delete a page (moves to recycle bin)
Delete shelf on BookStack (Wiki)
Delete a shelf
Export book on BookStack (Wiki)
Export book content
Export chapter on BookStack (Wiki)
Export chapter content
Export page on BookStack (Wiki)
Export page content
Get attachment on BookStack (Wiki)
Get details for a specific attachment
Get book on BookStack (Wiki)
Get details for a specific book
Get chapter on BookStack (Wiki)
Get details for a specific chapter
Get page on BookStack (Wiki)
Get details for a specific page
Get shelf on BookStack (Wiki)
Get details for a specific shelf
Get system status on BookStack (Wiki)
Check system version and status
List attachments on BookStack (Wiki)
List all attachments in BookStack
List audit log on BookStack (Wiki)
View system activity audit log
List books on BookStack (Wiki)
List all books in BookStack
List chapters on BookStack (Wiki)
List all chapters in BookStack
List pages on BookStack (Wiki)
Supports pagination, sorting, and filtering. List all pages in BookStack
List recycle bin on BookStack (Wiki)
List deleted items in the recycle bin
List shelves on BookStack (Wiki)
List all shelves in BookStack
Search on BookStack (Wiki)
Search across all content in BookStack
Update attachment on BookStack (Wiki)
Update an existing attachment
Update book on BookStack (Wiki)
Update an existing book
Update chapter on BookStack (Wiki)
Update an existing chapter
Update page on BookStack (Wiki)
Update an existing page
Update shelf on BookStack (Wiki)
Update an existing shelf
Connect BookStack (Wiki) to Pydantic AI via MCP
Follow these steps to wire BookStack (Wiki) into Pydantic AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install Pydantic AI
pip install pydantic-aiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.py and run: python agent.pyExplore tools
Why Use Pydantic AI with the BookStack (Wiki) MCP Server
Pydantic AI provides unique advantages when paired with BookStack (Wiki) through the Model Context Protocol.
Full type safety: every MCP tool response is validated against Pydantic models, catching data inconsistencies before they reach your application
Model-agnostic architecture. switch between OpenAI, Anthropic, or Gemini without changing your BookStack (Wiki) integration code
Structured output guarantee: Pydantic AI ensures tool results conform to defined schemas, eliminating runtime type errors
Dependency injection system cleanly separates your BookStack (Wiki) connection logic from agent behavior for testable, maintainable code
BookStack (Wiki) + Pydantic AI Use Cases
Practical scenarios where Pydantic AI combined with the BookStack (Wiki) MCP Server delivers measurable value.
Type-safe data pipelines: query BookStack (Wiki) with guaranteed response schemas, feeding validated data into downstream processing
API orchestration: chain multiple BookStack (Wiki) tool calls with Pydantic validation at each step to ensure data integrity end-to-end
Production monitoring: build validated alert agents that query BookStack (Wiki) and output structured, schema-compliant notifications
Testing and QA: use Pydantic AI's dependency injection to mock BookStack (Wiki) responses and write comprehensive agent tests
Example Prompts for BookStack (Wiki) in Pydantic AI
Ready-to-use prompts you can give your Pydantic AI agent to start working with BookStack (Wiki) immediately.
"Search my BookStack wiki for 'security policy'."
"Create a new page titled 'Onboarding' in book ID 5 with some basic HTML content."
"Export the 'API Reference' page (ID: 88) as a PDF."
Troubleshooting BookStack (Wiki) MCP Server with Pydantic AI
Common issues when connecting BookStack (Wiki) to Pydantic AI through Vinkius, and how to resolve them.
MCPServerHTTP not found
pip install --upgrade pydantic-aiBookStack (Wiki) + Pydantic AI FAQ
Common questions about integrating BookStack (Wiki) MCP Server with Pydantic AI.
How does Pydantic AI discover MCP tools?
MCPServerHTTP instance with the server URL. Pydantic AI connects, discovers all tools, and generates typed Python interfaces automatically.Does Pydantic AI validate MCP tool responses?
Can I switch LLM providers without changing MCP code?
Explore More MCP Servers
View all →
Open Trivia Database
6 toolsAccess 13,000+ community-curated trivia questions from OpenTDB � filter by category, difficulty, and type with session-based deduplication.

Ember Climate
11 toolsAccess global electricity data — generation, demand, emissions, and capacity from Ember Climate's open energy API.

Moloni (Cloud Invoicing & Fiscal Management)
20 toolsManage certified invoicing via Moloni — track customers by VAT/NIF, audit invoices, and monitor stock levels.

7shifts
12 toolsSchedule restaurant staff, manage shifts, track labor costs, and coordinate your team with intelligent workforce planning.
