agent-tools.md

Agent Tool Reference

Oversight currently registers 57 tools in the unified agent runtime. This page describes the full runtime tool catalog used by built-in Oversight agents and exposed by GET /api/meta/tools.

The Streamable HTTP MCP endpoint (POST /mcp) intentionally exposes a smaller subset focused on collection + task-planning flows. Use tools/list against /mcp to inspect that narrower list at runtime.

Document Management

Tool	Description
create_document	Create a document in a specific collection_id + project_id; exact-duplicate content is deduplicated and reuses the existing document
read_document	Read a document by ID including labels and attributes
search_documents	Search documents by labels, attributes, keywords, or parent; returns lightweight hits, so use read_document for full content
delete_document	Delete a document and all associated data
add_label	Add a label/tag to a document
remove_label	Remove a label from a document
set_attr	Set a key-value attribute on a document

Document Relations

Tool	Description
create_edge	Create a directed relationship between two documents
get_edges	Get all connected edges for a document
trace_path	Traverse outward from a starting document through the knowledge graph up to max_depth hops

Embedding and Search

Tool	Description
embed_document	Generate embeddings for a document using the embedding API
vector_search	Vector similarity search across documents
search	Unified search across tasks, documents, and projects (lexical/semantic/hybrid)

Git Operations

Tool	Description
scan_commits	Scan git repository for recent commits and auto-link to assets
get_branch_diff	Get diff between git branches
compare_branches	Compare two git branches

Task Management

Tool	Description
create_task	Create a task with type, priority, content, parent, assignees, labels; content defaults to the project's General collection when no collection is specified
list_tasks	List tasks with filters (status, type, assignee, parent, cycle, label)
get_task	Get full task details
update_task	Update task fields (title, priority, assignees, labels, etc.); content updates the linked document or creates one in General if needed
transition_task	Transition a task to a new workflow state
comment_on_task	Add a comment to a task
add_task_relation	Add a relation between tasks (blocks, relates_to, duplicates)
check_blockers	Check if a task has unresolved blocking dependencies
attach_to_task	Link a document, commit, PR, or file to a task

Task Decomposition

Tool	Description
spawn_subtask	Create a subtask (auto mode or review proposal mode)
propose_task	Propose a new task with a relation to the source task

Workflow Management

Tool	Description
list_workflows	List all workflow definitions with states and transitions
create_workflow	Create a new workflow with states and transitions
get_workflow_bundle	Load a workflow as a complete bundle including stage reactions
preview_workflow_bundle	Validate a workflow bundle against intent, coverage, and scenarios
apply_workflow_bundle	Apply a workflow bundle only after preview validation passes
create_view	Create a workflow view (board, list, tree, etc.)
list_views	List workflow views

Knowledge Base Tools

Tool	Description
create_collection	Create a new knowledge base in a project, including read/write guidance, document requirements, and default access
list_collections	List all knowledge bases in a project
query_collection	Search documents within a knowledge base (semantic when embeddings are configured, plus keyword/browse fallback)
read_collection_doc	Read a document from a knowledge base
write_collection	Create a new document or overwrite an existing one in a knowledge base; requires a prior query_collection / read_collection_doc on that collection
edit_collection_doc	Edit an existing document in a knowledge base; requires a prior query_collection / read_collection_doc on that collection
set_collection_access	Set access permissions for a knowledge base
remove_collection_access	Remove access permissions from a knowledge base

Coding and Shell

Tool	Description
read_file	Read file contents with line numbers
write_file	Write content to a file
list_files	List files in a directory with optional glob filtering
run_command	Run whitelisted shell commands (cargo, pnpm, git, etc.)
search_code	Search code patterns using ripgrep with regex support

Insights and Findings

Tool	Description
record_finding	Record a finding (risk, gap, issue) with category and severity
extract_insight	Extract generalized patterns from multiple findings
recall_knowledge	Recall previously recorded insights relevant to current work

Resources and Integrations

Tool	Description
list_resources	List accessible resources by type/group/tag; returns metadata and injection hints, but not the underlying secrets
get_resource	Get the configuration for a named resource; may include sensitive connection details, so callers must handle it carefully

Ensemble Voting

Tool	Description
ensemble_vote	Submit a vote scoring an agent's work (0.0-1.0)
ensemble_result	Get aggregate voting results for an ensemble
ensemble_status	Check current status of an ensemble vote
ensemble_votes	List all votes for an ensemble

Markdown

Tool	Description
parse_document	Parse the Markdown file at file_path into structured sections by heading hierarchy

---