For AI agents: the complete documentation index is at https://docs.routebase.dev/llms.txt. Every page is also available as Markdown by appending index.md to its URL or by sending Accept: text/markdown.
MCP Reference

Folders — MCP Tools

Folders that organize endpoints within a spec. This page documents the Folders group of the Routebase MCP server, with the scope and the parameters of each tool.

A session that stages its tools advertises this group once the agent calls enable_toolset with the slug folders. Full-access keys, scoped keys and OAuth sessions see every tool they are allowed to call without that step.

create_folder

Create a new folder in an API specification to organize endpoints. Supports nesting via parentFolderId. Use this for a new folder; to put an existing one under another parent use move_folder. 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. Use this to remove the folder; to keep it but change where it sits use move_folder. 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. Use this to change a folder's parent; to change the order among its siblings use reorder_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 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. Use this to change the order among siblings; to change a folder's parent use move_folder. 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. Use this for name and icon only; to change where the folder sits use move_folder or reorder_folders. 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