# Wolai MCP MCP

> Wolai lets your AI agent manage all company knowledge, combining wiki-style pages with structured databases. Forget clicking through complex menus; you simply ask for information or tell it to build new documentation using natural conversation. It’s an automated system for organizing everything from meeting notes to product roadmaps.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** collaborative-workspace, database-management, information-organization, block-based-editing, knowledge-base, document-management

## Description

Wolai handles the chaos of massive internal knowledge bases. Instead of wrestling with a complicated web interface just to find one fact, your agent treats your workspace like a unified intelligence layer. It can instantly list all accessible pages and retrieve deep details about specific content blocks within those pages. Need to track feature requirements? The system manages multi-dimensional databases; you can query them or even create brand new records without touching the UI. This ability to treat raw data as the source for structured documentation is a huge deal. When your agent runs on Vinkius, it means that even if you build complex workflows combining Wolai with other services (like a CRM or billing MCP), everything passes through a zero-trust proxy. Your keys never sit on a disk; they only move in transit. This keeps the entire documentation process secure while allowing you to automate processes across multiple platforms.

## Tools

### create_database_row
Adds a brand new, fully populated row of data into the database you specify.

### create_page
Generates and publishes an entirely new page within your Wolai workspace.

### get_database
Returns the schema and structure of a chosen database.

### get_page
Fetches the complete details and metadata for a single specified page.

### get_workspace_info
Pulls high-level information about your entire knowledge base structure and configuration.

### list_blocks
Shows all individual content blocks within a specific page for detailed review.

### list_databases
Lists every structured database available in your workspace.

### list_pages
Retrieves a list of all primary content pages in your workspace.

### list_users
Retrieves a list of all accounts that are part of the collaborative workspace.

### query_database
Runs targeted searches against your structured databases to find data rows that match criteria.

## Prompt Examples

**Prompt:** 
```
List all pages in my Wolai workspace.
```

**Response:** 
```
I've retrieved your Wolai pages. You have 6 active pages, including 'Project Roadmap' and 'Meeting Notes'. Which one would you like to view the content for?
```

**Prompt:** 
```
Query the 'Product Backlog' database for items with 'High' priority.
```

**Response:** 
```
I've queried the 'Product Backlog' database. I found 3 items with high priority: 'Refactor Auth Engine', 'Implement PDF Export', and 'API Documentation'. Would you like more details on any of them?
```

**Prompt:** 
```
Create a new page in Wolai titled 'Weekly Sprint Notes'.
```

**Response:** 
```
Done! I've created the page 'Weekly Sprint Notes' in your workspace. You can now start adding content blocks to it. Page ID: WL-8821.
```

## Capabilities

### List all pages
Reads and reports every page available in your knowledge base.

### Get specific page details
Retrieves the full content and metadata for one designated page.

### Query structured data
Runs complex searches against your defined databases to pull out precise facts.

### Create new database records
Adds a complete, formatted row of data into an existing database table.

### Read content blocks
Accesses the raw text and media information inside any given page.

### List available databases
Shows a list of all structured data repositories in your workspace.

## Use Cases

### Project requirements are scattered everywhere.
A PM needs to gather all high-priority feature requests. They ask the agent to query_database on 'Product Backlog' and then synthesize those results, using get_page to draft a summary document for stakeholders.

### The team wiki is outdated.
A technical writer needs to update the main onboarding guide. First, they call list_pages to see all related content areas, then use create_page to build the new version and populate it with blocks from existing sources.

### I need a report on who can access sensitive data.
An operations analyst uses list_users in combination with get_workspace_info to quickly map out team roles and determine if all collaborators have the necessary permissions for the most critical databases.

### I don't know where the original specs are.
A researcher asks the agent to list_pages, gets a directory of potential documents, selects one via get_page, and then uses list_blocks to find the specific section detailing API endpoints.

## Benefits

- Stop manually compiling docs. Instead of copy-pasting facts from a spreadsheet to a wiki page, use query_database and let your agent pull the precise data needed for the article.
- Build out documentation on demand. When you need a new guide or project kickoff document, simply ask the system to create_page; it handles the setup and publishing process.
- Deep dive into content. If you only know the page title, list_blocks allows your agent to look inside and find specific pieces of media or text without needing the full context.
- Understand your data structure. Use get_database to see exactly what fields are available before attempting to query it, preventing failed searches down the line.
- Audit team access easily. The list_users tool lets you check who has permission to view and edit core knowledge areas, which is key for compliance checks.

## How It Works

The bottom line is you talk to your knowledge base using natural language, and the MCP handles the complex calls behind the scenes.

1. Subscribe to the Wolai MCP and provide your required App ID and Secret credentials.
2. Connect your preferred AI client, like Claude or Cursor, through the Vinkius platform.
3. Direct your agent with a request—for instance, 'List all pages related to Q3 planning'—and it executes the necessary steps.

## Frequently Asked Questions

**How do I find my Wolai App ID and Secret?**
Log in to Wolai, go to [Personal Center] → [Space Settings] → [App Settings], and create a 'Self-built App' to generate your App ID and App Secret.

**Can I search for specific data within a database?**
Yes. Use the `query_database` tool with the database ID. You can optionally provide a JSON filter string to narrow down the results based on your criteria.

**What is a 'Block' in Wolai?**
Like Notion, Wolai uses a block-based structure. Everything from a paragraph of text to an image or a sub-page is considered a block. You can list these using the `list_blocks` tool.

**If I need to understand the fields for a new query, how does `get_database` help me?**
It returns the full database schema. You'll see every column name and data type available before writing a complex query with `query_database`. This prevents guesswork when structuring your data calls.

**After I run `list_pages`, how can I use the page ID to create a new Wolai page with `create_page`?**
You pass the specific Page ID you want to link to. The tool handles creating the structure, ensuring that the newly created content is properly attached and scoped within your existing workspace context.

**If I need user data, what does the `list_users` tool provide about team membership?**
It gives a list of all active users in the Wolai workspace. You can use this list to check roles or manage who has access to specific pages and databases. It's essential for tracking collaboration.

**When I use `get_page`, what kind of errors should I expect if the provided Page ID isn't valid?**
The tool will return a clear 'Not Found' status code, along with details explaining which specific Page ID is missing or inaccessible. This helps you narrow down where your data structure might be broken.

**If I need to see my overall system context, how does `get_workspace_info` work?**
It provides high-level metadata about the entire Wolai environment. This includes global settings and details that frame all your pages and databases, giving you a complete overview.