List folders and galleries

List the folders and galleries inside a folder of your SmugMug site, with their visibility.

MCP tool smugmug_read → list_galleries

read

Returns the folders and galleries directly inside the folder, each with its ID, type (folder or gallery), title, visibility and link. Subfolders come back as folders, so you call it again with their ID to go deeper. Reads only; the account owner sees everything, whatever the visibility.

Parameters

Parameters: list_galleries
NameTypeDescription
folder_id string string Folder ID from an earlier call. Leave out to start at the top of your site.
cursor string string Next page cursor from the previous call.

tools/call

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "smugmug_read",
    "arguments": {
      "operation": "list_galleries",
      "arguments": {}
    }
  }
}

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "items": [
      {
        "id": "Hm3vLq",
        "type": "folder",
        "title": "Delivered 2026",
        "visibility": "unlisted",
        "web_url": "https://studio.smugmug.com/Delivered-2026"
      },
      {
        "id": "Xk4RtP",
        "type": "gallery",
        "title": "Smith wedding",
        "visibility": "unlisted",
        "web_url": "https://studio.smugmug.com/Weddings/Smith-wedding"
      },
      {
        "id": "Pw9bZs",
        "type": "gallery",
        "title": "Park family session",
        "visibility": "public",
        "web_url": "https://studio.smugmug.com/Family/Park-family-session"
      }
    ],
    "next_cursor": null
  },
  "isError": false
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.