Documentation Index Fetch the complete documentation index at: https://docs.shingleai.com/llms.txt
Use this file to discover all available pages before exploring further.
The ShingleAI MCP server provides 7 tools for managing files and folders in organization storage. These tools are organized into two categories: files and folders.
Files Tools for uploading, downloading, listing, searching, and deleting files. File content is exchanged as base64-encoded strings to support the MCP protocol.
uploadFile Upload a file to organization storage with base64-encoded content.
Permission: files:writeParameters: Name Type Required Description filenamestring Yes Name of the file (1-255 characters) contentstring Yes Base64-encoded file content (max 10MB file size) contentTypestring Yes MIME type of the file (e.g., application/pdf, image/png) folderIdstring (UUID) | null No Optional folder ID to place the file in descriptionstring No Optional description of the file (max 5000 characters) tagsstring[] No Optional tags for the file (max 10)
Returns: Object with success boolean and a file object containing id, filename, size, contentType, and folderId.downloadFile Download a file from organization storage as base64-encoded content.
Permission: files:readParameters: Name Type Required Description fileIdstring (UUID) Yes The ID of the file to download
Returns: Object with a file metadata object (id, filename, contentType, size) and a content string containing base64-encoded file bytes.Downloads are gated by each file’s agentAccessEnabled flag. Files with agent access disabled return an error.
listFiles List files in organization storage with optional folder filtering and pagination.
Permission: files:readParameters: Name Type Required Default Description folderIdstring (UUID) | null No - Filter by folder ID (null for root level, omit for all files) limitnumber No 10 Number of files to return (1-100) offsetnumber No 0 Pagination offset sortOrderstring No ”desc” Sort order by creation date (asc or desc)
Returns: { "files" : [ ... ], "count" : 23 , "limit" : 10 , "offset" : 0 }
searchFiles Search files by filename, description, or tags using full-text search.
Permission: files:readParameters: Name Type Required Default Description querystring Yes - Search query to match against filename, description, and tags (1-255 characters) limitnumber No 10 Number of results to return (1-100) offsetnumber No 0 Pagination offset
Returns: { "files" : [ ... ], "count" : 5 , "query" : "invoice" , "limit" : 10 , "offset" : 0 }
deleteFile Delete a file from organization storage (soft delete).
Permission: files:deleteParameters: Name Type Required Description fileIdstring (UUID) Yes The ID of the file to delete
Returns: Object with success boolean, the deleted file object, and a message string.Folders Tools for organizing files into a folder hierarchy. Folders can be nested up to 5 levels deep.
createFolder Create a new folder in organization storage with optional parent folder (max 5 levels deep).
Permission: folders:writeParameters: Name Type Required Description namestring Yes Name of the folder (1-255 characters) parentFolderIdstring (UUID) | null No Optional parent folder ID (null for root level)
Returns: The created folder object.listFolders List folders in organization storage with optional parent folder filtering and pagination.
Permission: folders:readParameters: Name Type Required Default Description parentFolderIdstring (UUID) | null No - Filter by parent folder ID (null for root level, omit for all folders) limitnumber No 10 Number of folders to return (1-100) offsetnumber No 0 Pagination offset sortOrderstring No ”desc” Sort order by creation date (asc or desc)
Returns: { "folders" : [ ... ], "count" : 6 , "limit" : 10 , "offset" : 0 }
Next Steps
Contact Tools Manage contacts and their associated data
Authentication Learn how MCP clients authenticate to the server
