tools.md

MCP Tools Reference

Grafeo exposes 29 MCP tools. All tools return text responses (Markdown-friendly) and accept JSON inputs as shown below.

Context & Understanding

Tool	Input	Description
get_file_context	path: string	File summary: purpose, symbols, dependencies, reverse deps, annotations.
search_codebase	query: string kind?: string	Fuzzy search across indexed files/symbols.
get_dependency_graph	target: string	Imports and dependents for a file/export.
get_blast_radius	file: string	Risk assessment by dependent count.
get_export_info	name: string	Export details: properties, methods, usage count + usage files.
get_module_overview	module: string	Module summary: files, entry point, key components.
get_framework_info	(none)	Detected framework + project metadata.

Knowledge Management

Tool	Input	Description
save_convention	area: string rule: string example?: string rationale?: string	Store a coding convention.
get_conventions	area?: string	List conventions (optionally filtered by area).
save_decision	title: string decision: string context?: string consequences?: string tags?: string	Store an ADR (architecture decision).
annotate_file	path: string note: string category?: string	Add a persistent file annotation.
get_annotations	path?: string	List annotations (optionally filtered by file).

Tasks & Continuity

Tool	Input	Description
create_task	title: string description?: string context?: string	Create a persistent task.
update_task	id: number status: string context?: string	Update task status/context.
get_active_tasks	(none)	List all non-completed tasks.
log_change	file: string changeType: string summary: string relatedTask?: number	Record a change entry.

Analytics

Tool	Input	Description
get_project_stats	(none)	Counts by file type/module + totals.
find_hotspots	(none)	Most imported files/exports + high complexity.
get_recent_changes	limit?: number	Recent change log entries.

Indexing

Tool	Input	Description
reindex_file	path: string	Re-scan and re-index one file.
reindex_all	(none)	Full project re-index.
index_status	(none)	Index totals and last indexed time.

Power Tools

Tool	Input	Description
session_bootstrap	file_path?: string	Rules + tasks + conventions + index + recent changes.
read_file	path: string startLine?: number endLine?: number	Read file with line numbers.
get_project_rules	section?: string	Return project rules (AGENTS/CLAUDE/cursorrules).
preflight_check	intent: string files: string[] evidence?: string	Blast radius + conventions before edits.
find_examples	pattern: string fileGlob?: string maxResults?: number contextLines?: number	Grep source for a pattern with context.
batch_context	files?: string[] exports?: string[]	Combined file + export context.
postchange_audit	changes: {file, changeType, summary}[] validationEvidence?: string	Reindex + log after edits.