# PhotoShelter MCP Server and API by Cotlet

> PhotoShelter MCP Server and API by Cotlet is a freemium MCP server. Hosted MCP server letting AI agents build, caption and share PhotoShelter galleries. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $29 a month
- **Platforms:** API, CLI, Web
- **Website:** https://cotlet.dev/integrations/photoshelter-api-mcp-server
- **Repository:** https://github.com/cotlet-connect/photoshelter-mcp
- **MCP Registry name:** dev.cotlet/photoshelter
- **Listing updated:** 2026-11-18

## About

The server connects an AI agent to a PhotoShelter account through a Cotlet sign-in, so the agent works in the same library a photographer already uses. Its nine tools cover reading galleries and images, creating galleries, adding library images, changing gallery access, sharing links and writing captions, keywords and credits.

Access is granted by signing in to PhotoShelter once in a browser that Cotlet hosts, rather than requesting an API key from PhotoShelter support. The site says the service never stores the account password and never exposes the session cookie to the agent. Each tool is also available over REST with the same key, for scripts and automation tools such as n8n.

It suits photographers and studios who want an agent to handle gallery building and metadata work. Two tools, changing access and sharing a gallery, ask for confirmation by default. Uploads, deletions, sales and billing are not covered. Cotlet describes itself as unofficial and not affiliated with PhotoShelter.

## Features

- **Gallery building:** Creates private galleries and adds library images to them without removing images from other galleries.
- **Library search:** Searches images by keyword, caption or file name and returns matches with gallery and keyword details.
- **Bulk metadata edits:** Writes captions, keywords and credit lines on several images in one call.
- **Gated sharing:** Changes gallery access and emails gallery links, with confirmation requested by default for those two actions.
- **Sign-in without API key:** Uses the user's own PhotoShelter login in a hosted browser instead of a PhotoShelter developer key.
- **REST and MCP access:** The same nine tools can be called over MCP by agents or over REST by scripts, using one Cotlet key.

## Good for

- Build a client gallery of selects from a finished shoot
- Caption and keyword a whole shoot so it is searchable the same day
- Find images across an existing PhotoShelter library by keyword
- Password protect or make private older public galleries
- Email a gallery link to a client after approval

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http photoshelter https://cotlet.dev/mcp/v1/photoshelter/connect
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://cotlet.dev/mcp/v1/photoshelter/connect
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "photoshelter": {
      "url": "https://cotlet.dev/mcp/v1/photoshelter/connect"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "photoshelter": {
      "type": "http",
      "url": "https://cotlet.dev/mcp/v1/photoshelter/connect"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "photoshelter": {
      "serverUrl": "https://cotlet.dev/mcp/v1/photoshelter/connect"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "photoshelter": {
      "type": "http",
      "url": "https://cotlet.dev/mcp/v1/photoshelter/connect"
    }
  }
}
```

## FAQ

### Do I need a PhotoShelter API key to use it?

No. The site says Cotlet works through the user's own PhotoShelter sign-in, so no key request to PhotoShelter support is needed.

### Can it upload photos?

No. The site says uploads are not covered and images must already be in the library.

### Which actions ask for confirmation?

Changing gallery access and sharing a gallery ask first by default. Creating galleries, adding images and editing metadata run immediately.

### Is it affiliated with PhotoShelter?

No. The site states Cotlet is independent and not affiliated with PhotoShelter.

### How is usage priced?

The pricing page describes credit packs from $29, with 10 credits per successful call for most tools and a 7-day trial with 2,000 credits.

### Is PhotoShelter MCP Server and API by Cotlet free?

PhotoShelter MCP Server and API by Cotlet has a free plan, with paid plans for more usage or features. Paid plans start at $29 a month.

### How do I add PhotoShelter MCP Server and API by Cotlet to Claude Code?

Run this command in your terminal: claude mcp add --transport http photoshelter https://cotlet.dev/mcp/v1/photoshelter/connect

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

---
Source: https://ai-powered.com/mcp/photoshelter-mcp-server-and-api-by-cotlet
