testmo_create_folder
Create a new folder in a Testmo project to organize test cases. Specify a parent folder to create subfolders.
Instructions
Create a new folder in a Testmo project.
Args: project_id: The project ID. name: Folder name. parent_id: Parent folder ID (omit for root level).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | ||
| name | Yes | ||
| parent_id | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- testmo/tools/folders.py:67-89 (handler)The actual tool handler function for testmo_create_folder. Creates a folder via POST /projects/{project_id}/folders with name and optional parent_id.
@mcp.tool() async def testmo_create_folder( project_id: int, name: str, parent_id: int | None = None, ) -> dict[str, Any]: """Create a new folder in a Testmo project. Args: project_id: The project ID. name: Folder name. parent_id: Parent folder ID (omit for root level). """ folder_data: dict[str, Any] = {"name": name} if parent_id: folder_data["parent_id"] = parent_id result = await _request( "POST", f"/projects/{project_id}/folders", data={"folders": [folder_data]}, ) folders = result.get("result", []) return folders[0] if folders else result - testmo/tools/folders.py:67-68 (registration)The @mcp.tool() decorator registers testmo_create_folder as an MCP tool on the FastMCP server instance.
@mcp.tool() async def testmo_create_folder( - testmo/client.py:22-25 (helper)The _request helper function used by the handler to call the Testmo REST API.
) async def _request( - testmo/tools/folders.py:69-78 (schema)Type hints define the input schema: project_id (int), name (str), parent_id (int | None).
project_id: int, name: str, parent_id: int | None = None, ) -> dict[str, Any]: """Create a new folder in a Testmo project. Args: project_id: The project ID. name: Folder name. parent_id: Parent folder ID (omit for root level).