**Source:** https://heykiku.com/help/mcp-tools

# What you can ask kiku via MCP

heykiku's MCP server exposes tools for agency knowledge work once you [connect a client to your knowledge base](https://heykiku.com/features/connect). Document tools are read-only. `flag_kiku` records review metadata; it does not upload, edit, or delete documents. Every tool respects the caller's role and access tiers. If your role cannot see a document in the dashboard, your MCP client cannot see it either.

## ask_kiku

`ask_kiku` is the main tool for natural questions. It sends the question to your workspace's kiku agent with only the libraries your role can access. Use it for synthesis: "What is our positioning for nonprofit clients?", "Draft a reply using our voice," or "What do we usually include in a kickoff deck?" Each call counts like a normal chat message.

## flag_kiku

`flag_kiku` records that a kiku answer should show up in Questions to answer. Use it after `ask_kiku` discloses a cited disagreement between sources. Pass the `conversation_id` and `user_message_id` from the ask_kiku trailer (`assistant_message_id` is optional). All roles including freelancers can flag. Calling again on the same turn is safe. This does not upload, edit, or delete documents.

## search_knowledge

`search_knowledge` searches extracted document text and returns matching documents with snippets. Use it when you need to discover source material before asking for a summary: "Search for cancellation policy," "Find documents mentioning Q4 launch," or "Which files mention Brightleaf?"

## get_document and get_documents

`get_document` fetches one document by ID. `get_documents` fetches up to 20 at once. These tools are best after `search_knowledge` or `list_documents` has found the IDs. They return metadata and extracted text for accessible documents only.

## list_documents

`list_documents` browses visible documents with pagination and optional filters for folder, status, and creation date. Use it for "Show recent documents," "List completed documents in this folder," or "Find documents added since Monday." Non-approvers see complete documents plus their own uploads.

## list_folders

`list_folders` returns the folders your role can access, with document counts. Use it when you want the client to orient itself before asking a more specific question: "What folders can I search?" or "Which client folders are available to me?"

## list_libraries

`list_libraries` shows the Mistral libraries mapped to your accessible tiers: general, internal, sensitive, or owner-only. This is mostly useful for debugging access. It does not grant new access.

## whoami

`whoami` describes the authenticated caller, workspace, key or OAuth client, highest accessible tier, and quota fields. Use it when a client is connected but results do not match the access you expected.

## Related terms

- [Agency Knowledge Base](https://heykiku.com/glossary/agency-knowledge-base)
- [Tribal Knowledge](https://heykiku.com/glossary/tribal-knowledge)
- [Institutional Memory](https://heykiku.com/glossary/institutional-memory)