Skip to content

Rename tools and flatten command hierarchy#1817

Open
jeremydhoover-blip wants to merge 2 commits intomicrosoft:mainfrom
jeremydhoover-blip:feature/2-rename-tool-names
Open

Rename tools and flatten command hierarchy#1817
jeremydhoover-blip wants to merge 2 commits intomicrosoft:mainfrom
jeremydhoover-blip:feature/2-rename-tool-names

Conversation

@jeremydhoover-blip
Copy link

@jeremydhoover-blip jeremydhoover-blip commented Feb 26, 2026

Summary
Renames all Fabric MCP tool names to be more descriptive and self-documenting, and flattens the command hierarchy by removing subgroups.

Changes

  1. Docs tools: Rename generic names to descriptive noun-based names: get → best_practices, api_examples, item_definitions, platform_api_spec, workload_api_spec; list → workloads
  2. OneLake tools: Add context to tool names: delete → delete_file, file → download_file/upload_file, create → create_directory, list → list_files/list_items/list_tables/list_workspaces, etc.
  3. Flatten command hierarchies: Remove all subgroups from both Docs and OneLake setups; register commands directly at the area level
  4. Update descriptions: Rewrite all command descriptions to concise single-line format
  5. Update titles: Remove verb prefixes from command titles
  6. Fix references: Update error messages that referenced old tool names
  7. Update tests: All test assertions updated for new names, descriptions, and flat structure

Part 2 of 4 — split from #1785. Depends on PRs: 1816, 1818, 1819

Jeremy Hoover added 2 commits February 26, 2026 10:56
- Rename tools/Fabric.Mcp.Tools.PublicApi directory to tools/Fabric.Mcp.Tools.Docs
- Update C# namespaces from Fabric.Mcp.Tools.PublicApi to Fabric.Mcp.Tools.Docs
- Rename FabricPublicApiSetup class to FabricDocsSetup
- Update area name from 'publicapis' to 'docs'
- Update solution files, Program.cs, and project references
- Update cspell, SUPPORT.md, and TROUBLESHOOTING.md references
- No changes to individual tool names or command hierarchy structure
- Docs tools: Rename generic names (get, list) to descriptive names
  (best_practices, api_examples, item_definitions, platform_api_spec,
  workload_api_spec, workloads)
- OneLake tools: Add context to tool names (delete -> delete_file,
  create -> create_directory, list -> list_files, etc.)
- Flatten both Docs and OneLake command hierarchies: remove all subgroups,
  register commands directly at the area level
- Update command descriptions to be concise single-line format
- Update command titles to remove verb prefixes
- Fix error messages referencing old tool names
- Remove OneLake ItemCreateCommandTests (command moved to Core in next PR)
- Update all tests for new names, descriptions, and flat structure
@github-actions
Copy link

Thank you for your contribution @jeremydhoover-blip! We will review the pull request and get back to you soon.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: Untriaged

Development

Successfully merging this pull request may close these issues.

1 participant