cgis_find_symbol
Resolve a partial symbol name to ranked candidate fully qualified names before tracing flows or analyzing impact, eliminating guesswork.
Instructions
Resolve a partial symbol name to candidate FQNs (substring match, ranked).
Call this BEFORE ``cgis_trace_flow`` / ``cgis_analyze_impact`` /
``cgis_get_structure`` when you know a short name (e.g.
``get_reservation_prices``) but not its full FQN — it removes the
read-the-file-first guesswork. Returns JSON ``[{fqn, name, type, file,
line}]`` ranked exact > prefix > substring. ``kind`` filters by node type
(FUNCTION / METHOD / CLASS / …); ``fqn_prefix`` scopes the search. A prefix
that starts with the directories the graph was ingested below (``src.cgis``
for a graph of ``src/``) and covers no code is read without them.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Only return this node type, e.g. FUNCTION, METHOD or CLASS (any case). An unknown type matches nothing rather than raising an error. | |
| limit | No | Maximum number of candidates to return. | |
| query | Yes | Leaf symbol name to search for, without dots (e.g. get_flow_result) — not an FQN. Case-insensitive substring match, ranked exact > prefix > substring. | |
| db_path | No | SQLite graph built by cgis_ingest. A relative path resolves against the MCP server's working directory, not the agent's — prefer an absolute path. | graph.db |
| fqn_prefix | No | Only return symbols at or under this FQN prefix, matched on whole dot-segments: app.svc does not match app.svc_alt, and a partial segment matches nothing. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |