MCP Tools Reference

Travsr exposes 26 tools over the Model Context Protocol, all using JSON-RPC 2.0. The graph query and observability tools work over both stdio and SSE; the repo and synonym management tools are stdio-only, so a remote SSE client sees 17.

Graph query tools

Tool	What it returns
get_dependencies	Direct and transitive imports for a file
get_callers	All call sites of a symbol across repos
find_references	Every use site of a symbol, not just calls
find_pattern	Graph-scoped textual search for what the graph cannot model
get_blast_radius	Files that would break if this file changes
search_symbol	Symbol definition locations by name
get_repo_map	Structural overview of a repository
get_execution_path	PCST path between two symbols
get_context	Full PPR + knapsack context for a query (synonym-aware)
get_graph_stats	Exact node/edge counts + last-indexed commit
get_graph_json	Raw subgraph as node/edge JSON for renderers
get_snippets	Kind-aware source snippets for named symbols
get_lang_status	Whether semantic (Phase B) analysis is active for a file's language

Observability tools

Every tool above answers a question about your code. These answer questions about the index those answers came from, which is what lets an agent tell "there are no callers" from "the graph cannot see them yet".

Tool	What it returns
get_index_status	Freshness, counts, Phase A/B state per language, semantic readiness
get_daemon_logs	Recent daemon log entries, severity-filtered and redacted
get_graph_health	Integrity report: ghost paths, orphan edges, lexical parity

All three are read-only and available over both stdio and SSE.

Repo management tools (stdio-only)

Tool	What it does
repo_languages	Per-language node counts for the indexed repo
repos_list	All repos in the Travsr registry with DB existence status
repos_prune	Remove registry entries whose DB file no longer exists
repos_remove	Remove one registry entry by name

Synonym tools (stdio-only)

Tool	What it does
synonym_list	List all synonym pairs
synonym_add	Add an alias to a term
synonym_set	Replace all aliases for a term
synonym_remove	Remove one alias or an entire term
synonym_reset	Restore built-in synonym defaults

JSON Schema conventions

All tools accept a single JSON object. Required fields are marked "required": [...]. Paths are relative to the repository root unless a repo parameter is specified. Use dot notation for symbols (ClassName.methodName) or #-qualified signatures (src/auth/jwt.ts#sign).

Error format

{
  "error": {
    "code": "SYMBOL_NOT_FOUND",
    "message": "No symbol matching 'PaymentService.charge' in repo.",
    "details": { "repo": "/Users/me/my-project" }
  }
}

Error codes

Code	Meaning
SYMBOL_NOT_FOUND	No node matching the given name or path
FILE_NOT_FOUND	The given file path does not exist in the graph
GRAPH_STALE	The graph is behind HEAD; run travsr init (or commit to trigger the hook)
BUDGET_EXCEEDED	Token budget too small to return any meaningful result
REPO_NOT_INDEXED	The repo has not been initialized with travsr init