MCP tools reference
11 read-only tools, served over MCP and callable from the CLI. Most take a symbol id — get one from find_symbol, file_overview or list_entrypoints.
find_symbol#
Find functions, methods and module-level values by name. Start here to get a symbol's id for the other tools.
Returns — Matching symbols with id, name, kind, file, line, how the framework invokes it, and how many call sites reach it.
codemarrow call find_symbol '{"query":"login"}'read_symbol#
Read the source code of one function or value, with line numbers.
Returns — The symbol and its declaration, each line prefixed with its line number.
codemarrow call read_symbol '{"id":42}'read_file#
Read a range of lines from any file in the project, with line numbers.
Returns — The requested lines with line numbers, and the file’s total line count.
codemarrow call read_file '{"path":"src/auth/login.ts"}'file_overview#
What a source file defines, every place that uses it (function, file and line), the project code it uses, and the library packages it calls into.
Returns — Definitions, incoming uses, outgoing uses and package calls for the file.
codemarrow call file_overview '{"path":"src/auth/login.ts"}'get_callers#
Everything that directly reaches a symbol, each at its call site — including framework wiring such as middleware that intercepts a route or a layout that wraps a page.
Returns — Each caller with file, line, the call as written, link kind and confidence.
codemarrow call get_callers '{"id":42}'get_callees#
Everything a symbol directly reaches: project functions and values it calls or uses, each at its call site, plus the library packages it calls into.
Returns — Each callee with its call site, link kind and confidence, plus library package calls.
codemarrow call get_callees '{"id":42}'trace#
Follow callers or callees several hops at once, returned as nodes and edges. Use get_callers or get_callees for one hop with call sites.
Returns — The root symbol, every symbol reached, and edges from the reaching symbol to the reached one.
codemarrow call trace '{"id":42,"direction":"callers"}'impact#
What a change to a symbol could affect: callers transitively, plus everything it intercepts, wraps or catches errors for. Nearest first.
Returns — Affected symbols with their distance in hops, nearest first, and the number of files touched.
codemarrow call impact '{"id":42}'list_entrypoints#
Functions the framework invokes itself — HTTP routes, pages, middleware — i.e. where requests enter the code.
Returns — Entry points, each with how the framework invokes it: a route, page or middleware.
codemarrow call list_entrypointspackage_usage#
Where the project calls into third-party packages: a summary of all packages, or every call site into one package.
Returns — A per-package summary, or every call site into the given package.
codemarrow call package_usagesearch_text#
Search the text of indexed source files, for anything the graph doesn't link — a value passed as an argument, a config key, a string.
Returns — Matching lines with file and line number.
codemarrow call search_text '{"pattern":"SESSION_TTL"}'Links and confidence#
Every link between two symbols carries a kind and a confidence.
callrendersreferencesusesinterceptswrapscatchesexactlikelyambiguous