[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# Photonesto API and MCP server: Let your AI agent handle the orders after the shoot.

> Photonesto publishes no public API and no developer documentation. No Photonesto MCP server and no official ChatGPT or Claude connector was found on its site or in its help center.

Photonesto publishes no public API and no MCP server (checked 17 Nov 2026). Cotlet runs a hosted Photonesto MCP server with 21 tools that ChatGPT and Claude use in your own photographer panel. Payments, deliveries and anything a client sees wait for your OK.

- Free 7-day trial, no card
- Unofficial, not affiliated with Photonesto
- Page: https://cotlet.dev/integrations/photonesto-api-mcp-server

> Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by Photonesto. Photonesto is a trademark of its owner. If Photonesto's own integrations cover what you need, use them first.

## What can your AI agent do in Photonesto?

- Confirm payments on waiting orders
- Deliver the digital files a client ordered
- Open a proofing gallery with its package
- Start a school or preschool group session
- Read the photos a couple starred for the album
- Publish Christmas mini session slots

## Does Photonesto have an MCP server or an API?

- Photonesto has three gallery types: Photo Album for reportage, Proofing gallery for one client, Group session for many clients.
- Its help center documents its own print and album lab integrations, such as nPhoto and Crystal Albums.
- Session booking runs at booking.photonesto.com and can sync with Google Calendar or iCal.

| What you need | By hand | CSV export | Cotlet |
|---|---|---|---|
| Ask ChatGPT or Claude to do the work | Copy and paste | Paste a file in | Hosted MCP server |
| Confirm payments and deliver files | Order by order | Read only | After your OK |
| Create galleries and booking slots | One screen at a time | Not in a file | 21 tools, writes after your OK |
| Run from n8n or a script | Manual only | Download by hand first | REST, same key |

Checked 17 Nov 2026. Sources: [Photonesto](https://www.photonesto.com/), [Photonesto Help Center](https://help.photonesto.com/en/), [Help: Types of photo galleries](https://help.photonesto.com/en/articles/11197861-types-of-photo-galleries-quick-guide), [Help: Lab integration, nPhoto](https://help.photonesto.com/en/articles/11589338-lab-integration-nphoto-in-photonesto), [Help: Crystal Albums integration](https://help.photonesto.com/pl/articles/11652809-integracja-photonesto-z-crystal-albums-przewodnik-krok-po-kroku), [Help: Calendar sync with booking](https://help.photonesto.com/pl/articles/16997414-jak-polaczyc-kalendarz-google-calendar-ical-z-systemem-rezerwacji-w-photonesto), [Help: Orders](https://help.photonesto.com/en/articles/11098964-explore-orders-selling-photos-in-galleries), [Help: Fulfilling orders](https://help.photonesto.com/pl/articles/15128565-realizacja-zamowien-w-photonesto-od-klikniecia-po-odbitki-w-rekach-klienta), [Help: Photo Album](https://help.photonesto.com/en/articles/11309413-how-to-create-a-photo-album), [Help: Proofing gallery](https://help.photonesto.com/en/articles/11366167-how-to-create-a-proofing-gallery), [Help: Group sessions](https://help.photonesto.com/pl/articles/14994646-sesje-grupowe-w-photonesto-kompendium-wiedzy-dla-profesjonalisty), [Help: Session templates](https://help.photonesto.com/en/articles/11583172-creating-a-session-based-on-a-template), [Help: Album selections](https://help.photonesto.com/en/articles/11425704-how-to-streamline-photo-selection-for-an-album), [Help: Photo folders](https://help.photonesto.com/en/articles/11464072-get-to-know-photo-folders-add-photos-to-thematically-related-groups), [Help: Videos in galleries](https://help.photonesto.com/en/articles/14779615-videos-in-your-galleries-discover-a-new-dimension-of-presentation-in-photonesto), [Help: Custom photo layout](https://help.photonesto.com/en/articles/11747178-custom-photo-layout-in-photonesto), [Help: Hiding photos](https://help.photonesto.com/en/articles/11747914-how-to-hide-photos-in-a-reportage), [Help: Product price lists](https://help.photonesto.com/en/articles/11198854-products-pricings-in-photonesto-your-key-to-selling-physical-products), [Help: Product sales in galleries](https://help.photonesto.com/en/articles/11703169-how-to-enable-the-product-sales-option-in-photonesto-photo-galleries), [Help: Watermark](https://help.photonesto.com/en/articles/11744855-how-to-protect-your-photos-in-photonesto-watermark-and-other-settings), [Help: Music in galleries](https://help.photonesto.com/en/articles/14699624-music-in-photonesto-galleries-take-care-of-your-clients-emotions), [Help: Traffic and Advertising tab](https://help.photonesto.com/en/articles/14802537-measure-effects-and-promote-yourself-more-effectively-the-new-traffic-and-advertising-tab-in-photonesto), [Help: Email all clients](https://help.photonesto.com/en/articles/11739346-how-to-send-an-email-to-all-clients-in-photonesto), [Help: Client zone on your website](https://help.photonesto.com/en/articles/11767435-customer-zone-on-your-own-website), [Help: Session booking](https://help.photonesto.com/pl/articles/12267552-system-rezerwacji-sesji-w-photonesto-poradnik-dla-fotografa), [Help: Booking offer pages](https://help.photonesto.com/pl/articles/13531850-strony-ofertowe-w-bookingu-photonesto-dlaczego-warto-z-nich-korzystac)

## How does the Photonesto MCP server work?

1. **Sign in to Photonesto.** Once, in a browser we host for you.
2. **Connect your AI agent.** One address in its settings.
3. **Hand it the orders.** It lists what waits, you approve each step.

Cotlet never sees or stores your password. Payments, deliveries and anything a client sees wait for your OK.

## How to connect Photonesto to your AI agent

1. **Sign in to Photonesto in a Cloud Browser.** Open galleries.photonesto.com in your Cotlet Cloud Browser and sign in to your photographer panel yourself.
2. **Add the Cotlet address.** Enter https://cotlet.dev/mcp/v1 as the MCP server or connector URL in your agent.
3. **Let the agent in.** Chat apps open a Cotlet sign-in page. Editors, n8n and scripts send an API key made in the console.

Photonesto shares the address `https://cotlet.dev/mcp/v1` with every other app you turn on, so one connector covers your whole studio stack. Enabled Photonesto after connecting? Refresh the connector and its 21 tools show up.

ChatGPT:

```
Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth
```

Claude:

```
Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

Claude Code:
claude mcp add --transport http cotlet \
  https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"
```

Cursor:

```
// ~/.cursor/mcp.json
{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
    }
  }
}
```

Codex:

```
# ~/.codex/config.toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"
```

n8n:

```
MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: photonesto_read
```

## All 21 Photonesto MCP tools

One tool per photographer workflow in the Photonesto help center. Reads run at once; every write asks first.

### Orders and fulfilment

The Orders panel: what clients bought, payment confirmations and delivery of the ordered files.

- **List photo orders** (`list_orders`, read): Read the Orders panel: what each client bought, when, and how much they paid.
- **Confirm payments and order status** (`update_orders`, write, asks first): Confirm a payment on one or more orders, or change their status.
- **Fulfil orders** (`fulfill_order`, write, asks first): Deliver the digital files a client ordered, or move an order on to printing or an album.

### Galleries and sessions

Photo Albums for reportage, proofing galleries for one client, group sessions for a whole class, and templates to repeat them.

- **Create photo albums** (`manage_photo_albums`, write, asks first): List your galleries, or create and publish a password-protected Photo Album.
- **Create proofing galleries** (`create_proofing_gallery`, write, asks first): Create a proofing gallery for one client, with the package they buy and the price of extra photos.
- **Create group sessions** (`create_group_session`, write, asks first): Create a group session where many clients, such as parents of one class, browse and order photos.
- **Create sessions from templates** (`manage_session_templates`, write, asks first): List your session templates, save a session as a template, or start a new session from one.

### Inside a gallery

Folders, uploads of photos and videos, the layout, album selections and the photo-hiding password.

- **Organise photo folders** (`manage_photo_folders`, write, asks first): List, add, rename, reorder or delete the folders inside a gallery.
- **Upload photos and videos** (`upload_media`, write, asks first): Upload photos and videos to a gallery's Photos and videos tab, then publish the change.
- **Design a custom layout** (`set_custom_layout`, write, asks first): Switch a gallery between the automatic layout and a custom one, or have Photonesto generate a starting layout.
- **Set up album selections** (`manage_selections`, write, asks first): Create a selection for a client to star photos for an album, or read the photos they starred.
- **Add a photo-hiding password** (`set_hiding_password`, write, asks first): Add a second gallery password that lets your client hide photos from everyone using the first one.

### Selling prints and albums

Price lists, from scratch or from a lab offer, and the product sales switch of each gallery.

- **Create price lists** (`manage_price_lists`, write, asks first): List your product price lists, create one from scratch or from a lab's offer, or change its prices.
- **Turn on product sales** (`set_product_sales`, write, asks first): Turn the sale of prints, wall art and albums on or off in a gallery and pick its price list.

### Studio settings and clients

Watermark, music, tracking codes, the client list and the client zone code for your website.

- **Set the watermark** (`set_watermark`, write, asks first): Choose a suggested watermark or your own PNG or SVG, and set its size, transparency and position.
- **Build music playlists** (`manage_music_playlists`, write, asks first): Create a playlist from the Photonesto music library and attach it to galleries.
- **Add tracking codes** (`set_tracking_codes`, write, asks first): Enter your Google Analytics measurement ID and Meta Pixel ID for all your galleries.
- **Export the client list** (`export_clients`, read): Read your client list from My clients, the same data as its CSV export.
- **Get the client zone code** (`get_client_zone_code`, read): Read the HTML code Photonesto generates to put your client zone on your own website.

### Session booking

Bookable session types with their schedule, and the offer pages that present them.

- **Set up booking session types** (`manage_booking_session_types`, write, asks first): List or create the session types clients book online, with their schedule, length and breaks.
- **Create booking offer pages** (`manage_offer_pages`, write, asks first): Create an offer page that presents one or more bookable session types to clients.

Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/photonesto-api-mcp-server#tools

## Who can see my Photonesto session, and how do I revoke it?

- **What we store.** Your signed-in Photonesto browser profile, AES-256-GCM encrypted, in Finland. Never your password.
- **What your agent gets.** The 21 Photonesto tools. The session cookie stays in the Cloud Browser.
- **What the session sees.** The galleries, orders and booking settings of the photographer account you signed in with.
- **What no tool touches.** Your Photonesto plan and billing, account profile, payment method setup and lab connections.
- **If Photonesto signs you out.** You sign in again yourself, in the same Cloud Browser.
- **How to cut access.** Disable Photonesto for agents, reset the browser, or change your Photonesto password.

Cotlet never sees or stores your password. You sign in at auth.photonesto.com yourself, and the agent uses only the session that sign-in leaves. Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory ([live results](https://cotlet.dev/security.md)).

## Approvals, undo and mistakes

1. **Read the Orders panel.** list_orders filters orders waiting for a payment.
2. **Show you the amounts.** Order, gallery and sum, before anything changes.
3. **Confirm after your OK.** update_orders records the payment.
4. **Deliver after your OK.** fulfill_order sends the ordered files.

| Action | How to put it right |
|---|---|
| Folders, layout, watermark, music, tracking codes | Call the same tool again with the earlier values |
| Payment confirmation or order status | Check the order in the Orders panel and correct it there |
| Group session currency | Fixed once the session exists: create a new session |
| Delivered digital files | Already with your client: talk to them directly |

All 18 write tools ask first: by default you confirm each call, and you can switch that off per tool. The 3 read tools, the Orders list, the client list and the client zone code, run at once.

MCP call:

```
{
  "name": "create_proofing_gallery",
  "arguments": {
    "name": "Kowalski family session",
    "password": "autumn-park",
    "client_email": "client@example.com",
    "packages": "one_package",
    "package_price": 250,
    "photos_included": 10,
    "extra_photo_price": 15,
    "deposit": 100
  }
}
```

REST:

```
curl -X POST https://cotlet.dev/api/v1/photonesto/proofing-galleries \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Kowalski family session","password":"autumn-park","client_email":"client@example.com","packages":"one_package","package_price":250,"photos_included":10,"extra_photo_price":15,"deposit":100}'
```

Response:

```
{
  "gallery": "Kowalski family session",
  "type": "Proofing gallery",
  "packages": "one_package",
  "package_price": 250,
  "photos_included": 10,
  "extra_photo_price": 15,
  "deposit": 100,
  "currency": "EUR",
  "created": true
}
```

The example opens a proofing gallery with one package: 10 photos for 250 EUR, extra photos at 15 EUR, and a 100 EUR deposit already paid. A cron job or n8n flow can make the same call over REST at `/api/v1/photonesto` with the same key and price, in JSON. Failed calls are free.

## How much does the Photonesto MCP server cost?

**About $15 a month** for a one-person portrait and school studio, 2,580 credits. Your Photonesto plan stays as it is.

| Job | Calls | Credits |
|---|---|---|
| Morning check of the Orders panel | 1 × 30 | 300 |
| Payment confirmations | 1 × 20 | 200 |
| Digital file deliveries | 1 × 20 | 200 |
| New proofing gallery and upload | 2 × 8 | 160 |
| Group session from a template, upload, product sales | 3 × 2 | 60 |
| Reading album selections | 1 × 8 | 80 |
| Booking session types and offer pages | 2 × 4 | 80 |
| Cloud Browser, 30 days |  | 1,500 |
| Total | 108 calls | 2,580 |

The smallest pack, 5,000 credits for $29, covers this month with room for the busy weeks before Christmas or First Communions.

- Free 7-day trial, no card
- 10 credits per successful call, MCP or REST
- 50 credits a day for the Cloud Browser
- Your Photonesto plan and its limits apply as they are

Credit packs are one-time purchases, not a subscription. The month above is an example built from our own assumptions, not measured customer usage.

## Photonesto MCP server: other ways to connect

| Option | What it does | Where it stops |
|---|---|---|
| By hand in the photographer panel | Every gallery, order and booking setting, one screen at a time. | Only while you sit at the desk. |
| Orders and client CSV exports | Photonesto exports orders (CSV or ZIP) and My clients (CSV). | A file you download and read yourself; nothing goes back into Photonesto. |
| Photonesto lab integrations | Send print and album orders to labs such as nPhoto and Crystal Albums. | Set up in Photonesto for production, not a route for an AI agent. |
| Google Calendar or iCal sync | Shows booked sessions in your calendar. | Calendar entries only; galleries and orders stay in Photonesto. |

If an export or a lab integration already covers your job, keep using it. Cotlet fits when you want ChatGPT, Claude or a script to work in Photonesto itself, from your own login, with nothing to host.

## Who runs Cotlet

Cotlet is run by Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273) and in business since 2019. Its founders are Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Write to contact@cotlet.dev with questions about the Photonesto tools.

## Photonesto MCP server: questions

### How do I get access?

Sign up free at https://cotlet.dev/signup?app=photonesto, turn on Photonesto under Integrations in the console and sign in at https://galleries.photonesto.com/ in your Cloud Browser. Then connect your AI agent and ask it about your orders. The trial needs no card.

### Does Photonesto have an API?

Photonesto publishes no public API and no developer documentation (checked 17 Nov 2026). No Photonesto MCP server and no official ChatGPT or Claude connector was found. Cotlet does not need one: it works in your own signed-in Photonesto account.

### Can the agent email all my Photonesto clients?

No Cotlet tool sends email. export_clients reads the list behind Photonesto's My clients CSV export, which its help center imports into a newsletter tool to email every client.

### Does Cotlet connect my print lab or payment methods?

No. Photonesto documents its own lab integrations (such as nPhoto) and payment method setup in its help center; you set those up in Photonesto. The tools use what you have already connected.

### Can the agent work in my Polish or German Photonesto panel?

Yes. Photonesto offers its panel and help center in several languages, and a group session can even have its own language. The tools work in the panel of the account you sign in with, and you can ask your agent in English or your own language.

### Is the MCP server different from the REST API?

Only in how it is called. Both carry the same 21 tools, inputs, answers, API key and price. Agents use MCP; scripts and n8n HTTP steps use REST.

### Is Cotlet affiliated with Photonesto?

No. Cotlet is independent and not affiliated with Photonesto.

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.
