box_search_folder_by_name_tool
Search and locate specific folders in Box by their name using the MCP Server Box. Simplify folder identification by retrieving folder IDs for efficient organization and access.
Instructions
Locate a folder in Box by its name.
Args: folder_name (str): The name of the folder to locate. return: List[dict]: The folder ID.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| folder_name | Yes |
Implementation Reference
- src/tools/box_tools_search.py:52-63 (handler)The core handler function implementing the tool logic. It retrieves a Box client, locates folders by name using box_locate_folder_by_name, and returns their dict representations.async def box_search_folder_by_name_tool(ctx: Context, folder_name: str) -> List[dict]: """ Locate a folder in Box by its name. Args: folder_name (str): The name of the folder to locate. return: List[dict]: The folder ID. """ box_client = get_box_client(ctx) search_results = box_locate_folder_by_name(box_client, folder_name) return [search_result.to_dict() for search_result in search_results]
- src/tool_registry/search_tools.py:9-12 (registration)The registration function that decorates and registers the box_search_folder_by_name_tool (and box_search_tool) with the MCP server using mcp.tool() decorator.def register_search_tools(mcp: FastMCP): mcp.tool()(box_search_tool) mcp.tool()(box_search_folder_by_name_tool)