Tools reference
Complete reference for all 25 tools exposed by the Beakr MCP server.
Research tool
research
Ask a question and get a researched answer with citations. This is the primary tool for answering questions about your organization. Searches the knowledge base, documents, and connected services (Slack, Gmail, Calendar, Jira, etc.).
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | The question to answer |
personal_only | boolean | No | Scope to your personal project |
project | string | No | Project name or ID |
Workspace tools
list_projects
List all projects in the organization. Use to discover project IDs for scoping other tools.
get_profile
Get the organization or project knowledge profile, including goals, focus areas, and extraction guidance.
| Parameter | Type | Required | Description |
|---|---|---|---|
profile_type | string | No | "org" or "project" (default: "org") |
project | string | No | Project ID (required if profile_type is "project") |
Knowledge base tools
kb_ls
List knowledge base pages. Optionally filter by type, parent, or scope.
| Parameter | Type | Required | Description |
|---|---|---|---|
page_type | string | No | Filter by type: topic, person, organization, decision, meeting, overview, research_note |
roots_only | boolean | No | Show only root pages |
parent_page | string | No | Filter to children of a page |
limit | integer | No | Max pages to return |
personal_only | boolean | No | Scope to your personal project |
project | string | No | Project ID |
kb_cat
Read a page's full content by slug, title, or UUID.
| Parameter | Type | Required | Description |
|---|---|---|---|
page | string | Yes | Page slug, title, or UUID |
project | string | No | Project ID |
kb_search
Semantic and keyword search across pages.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search query |
limit | integer | No | Max results (default: 10, max: 20) |
personal_only | boolean | No | Scope to your personal project |
project | string | No | Project ID |
kb_grep
Search page content by keyword or pattern.
| Parameter | Type | Required | Description |
|---|---|---|---|
pattern | string | Yes | Keyword or search pattern |
personal_only | boolean | No | Scope to your personal project |
project | string | No | Project ID |
kb_blame
Show paragraph-level source attribution for a page.
| Parameter | Type | Required | Description |
|---|---|---|---|
page | string | Yes | Page slug, title, or UUID |
kb_sources
List source documents that contributed to a page.
| Parameter | Type | Required | Description |
|---|---|---|---|
page | string | Yes | Page slug, title, or UUID |
kb_provenance
Show section-level citations with stance (supports, contradicts, qualifies).
| Parameter | Type | Required | Description |
|---|---|---|---|
page | string | Yes | Page slug, title, or UUID |
kb_links
Show pages that link to this page (backlinks).
| Parameter | Type | Required | Description |
|---|---|---|---|
page | string | Yes | Page slug, title, or UUID |
kb_timeline
Query temporal events by date range, keyword, or page type.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | No | Keyword filter |
start_date | string | No | Start date (YYYY-MM-DD) |
end_date | string | No | End date (YYYY-MM-DD) |
page_type | string | No | Filter by page type |
include_content | boolean | No | Include full section markdown |
limit | integer | No | Max events (default: 50, max: 100) |
personal_only | boolean | No | Scope to your personal project |
project | string | No | Project ID |
kb_log
Show revision history for a page, or recent ingestion events globally.
| Parameter | Type | Required | Description |
|---|---|---|---|
page | string | No | Page slug, title, or UUID. Omit for global ingestion log. |
personal_only | boolean | No | Scope to your personal project |
project | string | No | Project ID |
kb_stats
Knowledge base statistics (page count, source count).
| Parameter | Type | Required | Description |
|---|---|---|---|
personal_only | boolean | No | Scope to your personal project |
project | string | No | Project ID |
kb_graph
Get knowledge graph summary: nodes, edges, and top connected pages.
| Parameter | Type | Required | Description |
|---|---|---|---|
personal_only | boolean | No | Scope to your personal project |
project | string | No | Project ID |
Write tools (proposal flow)
All writes to the knowledge base go through proposals. The agent creates a proposal, you review it, and only then is it applied. Every write proposal requires exactly one scope: project_id=<uuid> for shared/team knowledge or personal=true for the user's personal project.
kb_propose_create
Propose creating a new page. The agent provides title, content, page_type, optional parent, and structured sections metadata with section IDs (matching <!-- sec:ID --> markers in content), inline citation tokens like {{source_type:source_id}}, and event dates with precision.
kb_propose_edit
Propose replacing a page's content wholesale. Same shape as create, targets an existing page.
kb_propose_patch
Propose surgical edits — insert, replace, or delete specific sections or text ranges without rewriting the page.
kb_propose_find_replace
Propose a find/replace pass across a page.
kb_propose_move
Propose moving a page under a different parent.
kb_propose_archive
Propose archiving a page (soft delete).
Proposal lifecycle tools
kb_list_proposals
List pending proposals in scope. Useful for review queues.
kb_show_proposal
Show the full payload of a single proposal — page changes, sections, citations.
kb_accept_proposal
Apply a proposal. The agent only calls this after the user explicitly asks to accept it.
kb_dismiss_proposal
Dismiss a proposal without applying it.