List symbols
list_symbolsList the largest symbols in one build of a target, optionally filtered by region, section, source file, object or name, or totalled per section, library, object, file or directory with 'group_by'. Use it to see what takes the space.
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": {
"project": "<project>",
"target": "<target>"
},
"name": "list_symbols"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | The build: a full commit SHA, a SHA prefix (7+ characters), or a branch or tag name. Default: the head of the default branch. | |
| limit | No | Maximum rows to return (default 50, max 200). | |
| offset | No | Rows to skip, for paging (default 0). | |
| region | No | Only this memory region, e.g. FLASH or RAM. | |
| target | Yes | Target name (see list_targets). | |
| details | No | Add address, binding, line, object and archive to each symbol (default false). | |
| project | Yes | The project: a public project's GitHub 'owner/repo' (no API key needed), or, with an API key, a project id or name from list_projects. | |
| section | No | Only this section, e.g. .bss. | |
| group_by | No | Return totals per group instead of symbols. 'section' sizes whole sections, including string literals no symbol names ('unnamed_bytes'); name_contains then matches the section name. | |
| file_contains | No | Only symbols whose source file path contains this text (case-insensitive). | |
| name_contains | No | Only symbols whose name contains this text (case-insensitive). | |
| object_contains | No | Only symbols whose archive or object file path contains this text (case-insensitive). |