Skip to content

Update Fabric MCP tool names and descriptions#1654

Open
jeremydhoover-blip wants to merge 11 commits intomicrosoft:mainfrom
jeremydhoover-blip:feature/update-tool-names-descriptions
Open

Update Fabric MCP tool names and descriptions#1654
jeremydhoover-blip wants to merge 11 commits intomicrosoft:mainfrom
jeremydhoover-blip:feature/update-tool-names-descriptions

Conversation

@jeremydhoover-blip
Copy link

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

Update Fabric MCP Tool Names and Descriptions

This PR standardizes Fabric MCP tool names and descriptions to follow a consistent pattern that improves AI model tool selection:

Name: verb_object (short, no redundant prefixes)
Description: What it does. Use this when (user intent). Additional context.

Why These Changes?

  • Ambiguous original names - Names like get, list, create, delete were too generic and didn't convey what the tool actually does
  • Better AI tool selection - Descriptive names and "Use this when..." patterns help models match user intent to the correct tool
  • Consistent naming convention - All tools now follow verb_object pattern (e.g., list_workspaces, download_file)
  • Shorter command group prefixes - Changed publicapis → api and itemdefinition → itemdef to stay within the 48-character tool name limit while keeping meaningful names

Files Changed

  • 16 command source files updated with new Name and Description properties
  • 12 test files updated with new tool name assertions
  • 1 setup file updated with shorter command group prefixes
  • README.md updated with new tool names and descriptions

Standardize all 15 Fabric MCP tool names and descriptions to follow consistent pattern:
- Title: <verb><object>
- Description: Performs <action>. Use this when <condition>. <constraints>

Updated tools:
Fabric Public API tools (6):
- list_fabric_api_workloads (formerly publicapis_list)
- get_fabric_api_spec (formerly publicapis_get)
- get_fabric_platform_api_spec (formerly publicapis_platform_get)
- get_fabric_best_practices (formerly publicapis_bestpractices_get)
- get_fabric_api_examples (formerly publicapis_bestpractices_examples_get)
- get_fabric_item_schema (formerly publicapis_bestpractices_itemdefinition_get)

OneLake tools (9):
- list_onelake_workspaces (formerly workspace list)
- list_onelake_items (formerly item list)
- list_onelake_items_dfs (formerly item list-data)
- create_fabric_item (formerly item create)
- list_onelake_files (formerly file list)
- create_onelake_directory (formerly directory create)
- delete_onelake_directory (formerly directory delete)
- upload_onelake_file (formerly upload file)
- download_onelake_file (formerly download file)
- delete_onelake_file (formerly file delete)

Updated README.md with new tool names and descriptions in Available Tools table.
@github-actions
Copy link

github-actions bot commented Feb 5, 2026

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

Jeremy Hoover and others added 10 commits February 16, 2026 16:23
Removed redundant prefixes since system adds server path prefixes:
- get_fabric_best_practices -> get_best_practices
- get_fabric_api_examples -> get_api_examples
- get_fabric_item_schema -> get_item_schema
- list_fabric_api_workloads -> list_workloads
- get_fabric_api_spec -> get_api_spec
- get_fabric_platform_api_spec -> get_platform_api_spec
- download_onelake_file -> download_file
- upload_onelake_file -> upload_file
- create_onelake_directory -> create_directory
- delete_onelake_directory -> delete_directory
- delete_onelake_file -> delete_file
- list_onelake_files -> list_files
- create_fabric_item -> create_item
- list_onelake_items_dfs -> list_items_dfs
- list_onelake_items -> list_items
- list_onelake_workspaces -> list_workspaces

Updated README.md and test files to match.
- get_item_schema -> get_schema (55 chars was exceeding by 7)
- get_api_examples -> get_examples (50 chars was exceeding by 2)
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