PhotoShelter MCP server Let your AI agent deliver your PhotoShelter galleries.

ToolWhat it doesAccess

• list_galleries Galleries and collections, with access and image counts. read

  Returns galleries with name, parent collection, access setting and number of images. Newest first.

  MCP callphotoshelter_read → list_galleries

  REST endpointGET https://cotlet.dev/api/v1/photoshelter/galleries

  Parameters

  Parameters: list_galleries

  Name	Type	Description
  query string	string	Gallery name.
  page integer	integer	Page number. Default: 1.

  Example response

  {
    "galleries": [
      {
        "gallery_id": "G0000aBcD",
        "name": "Harbor Run 2026",
        "collection": "Events",
        "access": "Private",
        "images": 412
      }
    ],
    "page": 1
  }

• get_gallery One gallery with its images and share settings. read

  Returns the gallery images with file names and captions, plus its access setting and share link.

  MCP callphotoshelter_read → get_gallery

  REST endpointGET https://cotlet.dev/api/v1/photoshelter/galleries/{gallery_id}

  Parameters

  Parameters: get_gallery

  Name	Type	Description
  gallery_id string required	string	Gallery ID from list_galleries.
  page integer	integer	Page number. Default: 1.

  Example input

  {
    "gallery_id": "gallery_8c41d2"
  }

  Example response

  {
    "gallery_id": "G0000aBcD",
    "name": "Harbor Run 2026",
    "access": "Private",
    "images": [
      {
        "image_id": "I0000xYz1",
        "file": "HR26_0412.jpg",
        "caption": ""
      }
    ]
  }

• create_gallery Creates a private gallery in a collection. write

  Creates an empty private gallery. Nobody sees it until share_gallery, so it runs at once.

  MCP callphotoshelter_write → create_gallery

  REST endpointPOST https://cotlet.dev/api/v1/photoshelter/galleries

  Parameters

  Parameters: create_gallery

  Name	Type	Description
  name string required	string	Gallery name.
  collection string	string	Parent collection name.

  Example input

  {
    "name": "Jane Doe"
  }

  Example response

  {
    "gallery_id": "G0000eFgH",
    "name": "Okafor Wedding Selects",
    "collection": "Weddings",
    "access": "Private"
  }

• add_images_to_gallery Adds library images to a gallery. write

  Adds the images to the gallery without removing them from others. Runs at once; remove them again in PhotoShelter.

  MCP callphotoshelter_write → add_images_to_gallery

  REST endpointPOST https://cotlet.dev/api/v1/photoshelter/galleries/{gallery_id}/images-to-galleries

  Parameters

  Parameters: add_images_to_gallery

  Name	Type	Description
  gallery_id string required	string	Gallery ID from list_galleries.
  image_ids string[] required	string[]	Image IDs from search_images or get_gallery.

  Example input

  {
    "gallery_id": "gallery_8c41d2",
    "image_ids": [
      "image ids"
    ]
  }

  Example response

  {
    "gallery_id": "G0000eFgH",
    "added": 60
  }

• set_gallery_access Changes who can see a gallery. writeasks first

  Sets the gallery to private, password protected or public. Public and password protected galleries are visible to anyone with the link or password. By default you confirm each call; you can switch that off for this tool.

  MCP callphotoshelter_write → set_gallery_access

  REST endpointPUT https://cotlet.dev/api/v1/photoshelter/galleries/{gallery_id}/access

  Parameters

  Parameters: set_gallery_access

  Name	Type	Description
  gallery_id string required	string	Gallery ID from list_galleries.
  access string required	string	private, password or public.
  password string	string	Password for access password.

  Example input

  {
    "gallery_id": "gallery_8c41d2",
    "access": "access"
  }

  Example response

  {
    "gallery_id": "G0000eFgH",
    "access": "Password",
    "password_set": true
  }

• share_gallery Emails a gallery link to a client. writeasks first

  Sends the gallery link with your message to the addresses you pass. By default you confirm each call; you can switch that off for this tool.

  MCP callphotoshelter_write → share_gallery

  REST endpointPOST https://cotlet.dev/api/v1/photoshelter/galleries/{gallery_id}/share

  Parameters

  Parameters: share_gallery

  Name	Type	Description
  gallery_id string required	string	Gallery ID from list_galleries.
  to string[] required	string[]	Recipient emails.
  message string	string	Email message.

  Example input

  {
    "gallery_id": "G0000eFgH",
    "to": [
      "grace@example.com"
    ],
    "message": "Your wedding selects are ready."
  }

  Example response

  {
    "gallery_id": "G0000eFgH",
    "shared_with": [
      "grace@example.com"
    ],
    "link": "https://example.photoshelter.com/gallery/G0000eFgH"
  }

ToolWhat it doesAccess

• search_images Searches the image library by keyword, caption or file name. read

  Returns matching images with gallery, file name, caption and keywords.

  MCP callphotoshelter_read → search_images

  REST endpointGET https://cotlet.dev/api/v1/photoshelter/images/search

  Parameters

  Parameters: search_images

  Name	Type	Description
  query string required	string	Keyword, caption text or file name.
  page integer	integer	Page number. Default: 1.

  Example input

  {
    "query": "query"
  }

  Example response

  {
    "images": [
      {
        "image_id": "I0000xYz1",
        "file": "HR26_0412.jpg",
        "gallery": "Harbor Run 2026",
        "keywords": [
          "finish line",
          "runners"
        ]
      }
    ],
    "page": 1
  }

• get_image One image with its metadata. read

  Returns caption, keywords, credit, capture date and the galleries the image is in.

  MCP callphotoshelter_read → get_image

  REST endpointGET https://cotlet.dev/api/v1/photoshelter/images/{image_id}

  Parameters

  Parameters: get_image

  Name	Type	Description
  image_id string required	string	Image ID from search_images or get_gallery.

  Example input

  {
    "image_id": "image_8c41d2"
  }

  Example response

  {
    "image_id": "I0000xYz1",
    "file": "HR26_0412.jpg",
    "caption": "Runners at the finish line",
    "keywords": [
      "finish line",
      "runners"
    ],
    "credit": "Dana Reyes",
    "captured": "2026-10-04"
  }

• update_image_metadata Sets the caption, keywords or credit of images. write

  Writes caption, keywords and credit on one or more images. Visible only where the gallery is shared; undo by writing the old values. Runs at once.

  MCP callphotoshelter_write → update_image_metadata

  REST endpointPATCH https://cotlet.dev/api/v1/photoshelter/image-metadata

  Parameters

  Parameters: update_image_metadata

  Name	Type	Description
  image_ids string[] required	string[]	Image IDs.
  caption string	string	Caption.
  keywords string[]	string[]	Keywords to add.
  credit string	string	Credit line.

  Example input

  {
    "image_ids": [
      "image ids"
    ]
  }

  Example response

  {
    "updated": 24,
    "example": {
      "image_id": "I0000xYz1",
      "caption": "Runners at the finish line",
      "keywords": [
        "finish line",
        "runners",
        "harbor run"
      ]
    }
  }