Find symbols
find_symbolsLocate declared symbols by exact or wildcard name pattern in a registered repository, filtering by kind and result limit to narrow code context.
Instructions
Match declaration names by exact or wildcard (*, ?) pattern (exact first; no bodies/edges; truncated=true if capped). Use search_source for code text or inspect_symbol for body+edges.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"repo_id": "<repo_id>",
"pattern": "<pattern>"
},
"name": "find_symbols"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Optional declaration kind filter (e.g. 'function', 'class', 'method', 'interface'). | |
| limit | No | Maximum matches to return (1 to max_symbol_results; defaults to 'locate' profile or server cap, reporting excess in omitted_count). | |
| pattern | Yes | Symbol name or qualified-name pattern (supports '*' and '?' wildcards; exact matches rank first). | |
| profile | No | Named budget profile preset ('locate', 'orient', 'impact', 'read'); defaults to 'locate'. | |
| repo_id | Yes | Registered repository ID from list_repositories (never a filesystem path). | |
| max_tokens | No | Token cap for the response (32 to max_result_tokens); defaults to 'locate' profile budget. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Matched symbol records without bodies or graph edges. | |
| error | No | Present when the tool call fails (either a structured {code, message, details} object or a diagnostic string). | |
| budget | No | Token budget accounting for this response. | |
| repo_id | No | Registered repository identifier. | |
| evidence | No | Source-verified file line spans and SHA-256 hashes backing the response. | |
| warnings | No | Freshness, ambiguity, redaction, or security warnings. | |
| freshness | No | Index freshness state ('fresh', 'pending', 'stale', or 'unknown'). | |
| truncated | No | True if items were omitted due to budget or node limits. | |
| ledger_rev | No | Current evidence ledger revision for repo_id. | |
| completeness | No | Coverage/resolution completeness indicator. | |
| index_run_id | No | Identifier of the active index snapshot run. | |
| schema_version | No | Envelope schema version ('1.0'). | |
| untrusted_repository_content | No | True when payload embeds raw repository text. |