Tools reference

Complete reference for all 16 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 personal space
`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 personal space
`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 personal space
`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 personal space
`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 personal space
`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 personal space
`project`	string	No	Project ID

kb_stats

Knowledge base statistics (page count, source count).

Parameter	Type	Required	Description
`personal_only`	boolean	No	Scope to personal space
`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 personal space
`project`	string	No	Project ID