Connect to a different Power BI report (.Report folder or parent .pbip project folder). Use this to switch reports mid-session without restarting the server.

Show the currently connected report path. Includes hasSemanticModel: boolean — true when a sibling .SemanticModel/ folder exists. Check this before calling pbir_model_usage.

List pages (paginated). Slim default returns id/displayName/width/height/visualCount/isActive/hidden; slim:false adds displayOption. includeVisuals:true (or pageId) embeds per-visual summaries. Top-level totalVisualCount sums the FULL set, not just the visible slice. For cross-page sweeps prefer one includeVisuals:true call over fanning out per-page pbir_list_visuals.

Create a new page in the report. Supports standard, tooltip, and drillthrough page types.

Rename an existing page

Delete a page and all its visuals

Set the page order

Set which page is active (shown on open)

Show or hide a page in the navigation pane. Hidden pages still work for drillthrough.

Get the report-level settings and theme configuration

Merge report-level settings. Keys: useStylableVisualContainerHeader, useEnhancedTooltips, exportDataMode (0|1), persistentFilters, keyboardNavigationEnabled, defaultDrillFilterOtherVisuals, allowChangeFilterTypes, useDefaultAggregateDisplayName.

Update the page dimensions

Auto-arrange all visuals on a page in a grid.

Duplicate an entire page with all its visuals to a new page

Reload the report in Power BI Desktop by closing and reopening the .pbip file. SAFETY: closes PBIDesktop.exe, so any unsaved work in Desktop (including modeling-MCP measures/relationships not yet flushed by Desktop autosave) is LOST. Requires confirm:true to proceed — otherwise returns a save-first warning for the agent to relay to the user.

Show or hide the filter pane.

Manage extension measures (report-level DAX in reportExtensions.json). Empty file crashes PBI Desktop — tool auto-deletes when empty.

Set the page canvas background and/or wallpaper. Hex color (#0D1117). Transparency 0-100.

Set cross-filter interaction (Filter/Highlight/NoFilter) from source visual to target visual.

List available visual types. Default returns slim type list (~150 tokens). Pass verbose:true for per-type data-role bucket metadata (~1,200 tokens).

List visuals on a page (paginated). Default slim returns id/type/x/y/w/h/title. slim:false includes filterCount. Use limit/offset to page through large pages. Use visualType to filter for cross-page sweeps in combination with pbir_list_pages per-page iteration.

Get visual details. Default returns id/type/position/title/bindings summary. verbose:true returns full PBIR JSON.

Add visuals to a page via visuals: [...] batch. Inline containerFormat/visualFormat/dataColors per entry avoids extra pbir_format_visual calls. Stacked charts need a Series binding; 'KPI card' = card with one measure; scatter uses Category bucket. Use pbir_lookup_theme_property for valid category/property names.

Delete a visual from a page

Move and/or resize a visual on a page

Duplicate an existing visual, optionally to a different page or position

Change the visual type of an existing visual (e.g. barChart to columnChart) while keeping data bindings

Set or update the title of a visual. Can set text, visibility, font, size, alignment.

Format visual properties. Auto-routes title/background/border/padding/dropShadow/visualHeader to container, others to visual; override with target='visual'|'container'. Call pbir_lookup_theme_property for valid category/property names per visualType. Gotchas: slicer uses textSize, not fontSize (items/header); waterfall uses sentimentColors, not dataPoint.

Set data point colors. Series-based charts use metadata mode. Category-based (no Series) requires categoryEntity+categoryProperty.

Apply conditional formatting to a visual container background or title font. formatType: rules / gradient / clear. ComparisonKind: 0=Eq,1=GT,2=GTE,3=LT,4=LTE,5=NEq.

Apply a named theme preset to all visuals on a page. Themes: dark, light, corporate, blue-purple.

Set the sort order of a visual. Overrides the auto-sort. Use Table[Column] for field refs.

Update the data bindings of an existing visual. Replaces the query state entirely. Supports Table[Column] shorthand: use { "field": "Sales[Net Price]", "type": "measure" } as an alternative to separate entity/property fields.

Apply a custom JSON theme. Hex colors. dataColors 6-12 values. visualStyles keyed by visualType or '*'.

Get the currently applied theme. Returns base theme name + custom theme JSON if any.

Remove the custom theme from the report, reverting to the default base theme. The theme file is kept in StaticResources but unlinked from report.json.

Compare a proposed theme JSON against the currently applied theme and return what would be added, removed, or changed. Useful for previewing theme changes before applying.

List all theme files stored in the report's StaticResources/RegisteredResources/ folder.

Audit visuals on a page for theme overrides. Returns summary header + topN findings (default 20). topN:0 = all.

List filters on a page or visual. Slim mode (default) returns Table[Column] strings.

Add a filter to a page or visual. Omit visualId for page-level. topN requires visualId. Types: categorical / topN / relativeDate / advanced (Equals, GreaterThan, Contains, IsBlank, etc; supports And/Or compounds).

Remove a specific filter by name from a page or visual.

Remove ALL filters from a page or a specific visual.

Delete multiple visuals from a page. Set confirmBulk:true when >5.

Apply the same formatting to multiple visuals. target='container' (title/background/border) or 'visual' (axes/legend/labels). Set confirmBulk:true when >5.

Rebind multiple visuals in one call. Replaces existing bindings. Set confirmBulk:true when >5. continueOnError:true validates per-entry — bad bindings don't abort the batch.

List all bookmarks defined in the report.

Create a new bookmark. The bookmark is created with an empty exploration state — open Power BI Desktop to capture the current view state into it.

Delete a bookmark by ID.

Rename an existing bookmark.

Domain knowledge for Power BI report development. Topics discovered live from skills/*.md — call with topic:'list' to enumerate.

Compute a deterministic rows×cols grid; server owns margin/gap/remainder math. Use this INSTEAD of N pbir_add_visual calls when building a page from scratch. planOnly:true (default) returns the plan; planOnly:false validates bindings+layout then writes in one call. See guide('wireframes') for grid-shape selection.

Validate a page's (or the whole report's) layout against the wireframe rules — margins, gaps, overlap, off-canvas, banner geometry. Returns errors + warnings per visual plus stats (visual count, coverage, bottom edge). Read-only. Pair with pbir_audit_theme_compliance for full project verification.

Query the bundled Power BI theme schema for valid visualStyles property names. No args = list visual types; +visualType = list categories; +category = list properties with types/enums.

Cross-reference the semantic model with the report — shows where every measure and column is used, DAX dependencies, unused fields, and per-page coverage. Also generates an HTML dashboard for visual inspection. Requires a sibling .SemanticModel/ folder alongside the .Report/ — call pbir_get_report first to check hasSemanticModel before invoking this tool.

List on-demand tools (no args) or activate by name (pass tools array).