Folders — MCP Tools
6 tools in the Folders group of the Routebase MCP server.
create_folder
Create a new folder in an API specification to organize endpoints. Supports nesting via parentFolderId. Requires project context.
Required scope: specs:write
| Parameter | Type | Required | Description |
|---|---|---|---|
specId |
string | Yes | Public ID (GUID) of the API specification |
versionId |
string | Yes | Public ID (GUID) of the spec version to add the folder to |
name |
string | Yes | Folder name (e.g., 'Users', 'Authentication', 'Orders') |
icon |
string | No | Icon for the folder (emoji or icon name) |
parentFolderId |
string | No | Public ID (GUID) of the parent folder for nesting, or omit for top-level |
delete_folder
Delete a folder (soft delete). Nested subfolders are also removed; endpoints inside become ungrouped. Requires project context.
Required scope: specs:delete
| Parameter | Type | Required | Description |
|---|---|---|---|
specId |
string | Yes | Public ID (GUID) of the API specification |
versionId |
string | Yes | Public ID (GUID) of the spec version the folder belongs to |
folderId |
string | Yes | Public ID (GUID) of the folder to delete |
list_folders
List the folder structure of an API specification. Each folder has a parentFolderId for hierarchical nesting. Pass folderId to get just that one, with its rowVersion for update_folder. Requires project context (call set_context first).
Required scope: specs:read
| Parameter | Type | Required | Description |
|---|---|---|---|
specId |
string | Yes | Public ID (GUID) of the API specification |
versionId |
string | No | Optional version ID (GUID) to filter folders by a specific version |
folderId |
string | No | Optional public ID (GUID) of a single folder to return |
move_folder
Move a folder under a new parent folder, or to the top level by omitting newParentFolderId. Requires project context.
Required scope: specs:write
| Parameter | Type | Required | Description |
|---|---|---|---|
specId |
string | Yes | Public ID (GUID) of the API specification |
versionId |
string | Yes | Public ID (GUID) of the spec version the folder belongs to |
folderId |
string | Yes | Public ID (GUID) of the folder to move |
newParentFolderId |
string | No | Public ID (GUID) of the new parent folder, or omit to move to the top level |
reorder_folders
Set the display order of folders under one parent. Pass every folder ID at that level in the order you want; omit parentFolderId to order the root-level folders. Requires project context.
Required scope: specs:write
| Parameter | Type | Required | Description |
|---|---|---|---|
specId |
string | Yes | Public ID (GUID) of the API specification |
versionId |
string | Yes | Public ID (GUID) of the spec version |
folderIds |
string | Yes | Folder IDs (GUIDs) in the desired order, comma-separated. All of them must sit under the same parent. |
parentFolderId |
string | No | Public ID (GUID) of the parent folder; omit for the root level |
update_folder
Rename a folder and/or change its icon. Omit name or icon to keep the current value. Requires the folder's rowVersion for optimistic concurrency control. Requires project context.
Required scope: specs:write
| Parameter | Type | Required | Description |
|---|---|---|---|
specId |
string | Yes | Public ID (GUID) of the API specification |
versionId |
string | Yes | Public ID (GUID) of the spec version the folder belongs to |
folderId |
string | Yes | Public ID (GUID) of the folder to update |
rowVersion |
string | Yes | Base64-encoded row version of the folder (for concurrency control) |
name |
string | No | New folder name, or omit to keep the current name |
icon |
string | No | New icon (emoji or icon name), or omit to keep the current icon |