get_workspace_graph
Discover all filenames, sheet names, columns, and cross-sheet relationships from a local cache, giving you the workspace structure before any API call.
Instructions
Returns the cached file structure — all filenames, sheet
names, column headers, and cross-sheet relationships
(inferred at scan time from matching column names plus
overlapping sampled values, merged with any the user
declared in ~/.excelmcp/relationships.yaml; each carries
a confidence score and its evidence).
INSTANT — makes no API call. Reads from local graph.json.
ALWAYS call this first at session start to orient yourself.
Shows you exactly which files exist, what sheets they have,
and what columns are in each sheet. The structure varies
for every company — never assume, always discover.
Also returns sheet_name_variants: groups of sheet names
that differ only in case or whitespace across files —
check it before any cross-file operation, because those
match by exact sheet name.
Each sheet carries a regions list: the table bodies found
in it, derived from the sheet's own SUM/COUNT formulas, in
absolute sheet rows. A sheet with more than one region holds
several separate tables (also listed in multi_region_sheets),
so a plain aggregate over it adds up blocks that were never
meant to be summed — read its unclaimed_rows and check which
region you mean before totalling anything.
layout_confidence is "unconfirmed" wherever the region map
came from formulas alone and nothing has verified it.
Use this before any filter_sheet call when unsure which
file or column to query.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| folder_path | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||