CloudSpot API and MCP server Let your AI agent run the studio side of your shoots.

ToolWhat it doesAccess

• read_galleries List your Collections and read the Galleries made from each one, with their settings. read

  A Collection is the master set of images for one shoot; CloudSpot lets you make several Galleries from it, for example a Sneak Peek and the full Gallery. For each Gallery this returns its name, URL, the Folders it shows and its expiration date. Nothing changes, so it runs without asking.

  MCP callcloudspot_read → read_galleries

  REST endpointGET https://cotlet.dev/api/v1/cloudspot/galleries/read

  Parameters

  Parameters: read_galleries

  Name	Type	Description
  collection string	string	Collection name. Leave empty to list every Collection.

  Example response

  {
    "collection": "Harper and Lee wedding",
    "galleries": [
      {
        "name": "Sneak Peek",
        "url": "example.cloudspot.io/harper-lee-sneak-peek",
        "folders": [
          "Ceremony"
        ],
        "expires": null
      },
      {
        "name": "Harper and Lee wedding",
        "url": "example.cloudspot.io/harper-lee",
        "folders": [
          "Getting ready",
          "Ceremony",
          "Reception"
        ],
        "expires": "2027-02-01"
      }
    ]
  }

• view_collection_analytics Read the Favorites and Downloads sections of a Collection's Analytics. read

  Favorites lists are the ones clients saved in the Collection's published Galleries and Mobile Apps. Downloads covers single images as well as full Gallery or Folder downloads. Read only, it runs without asking.

  MCP callcloudspot_read → view_collection_analytics

  REST endpointGET https://cotlet.dev/api/v1/cloudspot/collection-analytics/view

  Parameters

  Parameters: view_collection_analytics

  Name	Type	Description
  collection string required	string	Collection name, as read_galleries returns it.
  section string	string	`favorites` or `downloads`. Leave empty for both.

  Example input

  {
    "collection": "collection"
  }

  Example response

  {
    "collection": "Harper and Lee wedding",
    "favorites": [
      {
        "list": "Album picks",
        "by": "client@example.com",
        "images": 42
      }
    ],
    "downloads": [
      {
        "what": "Full Gallery",
        "by": "client@example.com",
        "date": "2026-11-10"
      },
      {
        "what": "IMG_0412.jpg",
        "by": "guest@example.com",
        "date": "2026-11-11"
      }
    ]
  }

• create_collection Create a new Collection, the workspace for one shoot before any Gallery is published. writeAsks first

  Creates the empty Collection with the name, date and tags you give. Images are uploaded afterwards; the agent does not upload photos for you. By default you confirm each call; you can switch that off for this tool.

  MCP callcloudspot_write → create_collection

  REST endpointPOST https://cotlet.dev/api/v1/cloudspot/collections

  Parameters

  Parameters: create_collection

  Name	Type	Description
  name string required	string	Collection name, for example the couple or the event.
  date string	string	ISO date of the shoot. Optional.
  tags array	array	Collection tags. Optional.

  Example input

  {
    "name": "Jane Doe"
  }

  Example response

  {
    "collection": "Rivera family fall session",
    "date": "2026-11-08",
    "tags": [
      "Family"
    ],
    "created": true
  }

• deliver_images Email a Gallery to your client, as an online Gallery or with a Zip download. writeAsks first

  This is CloudSpot's Email button under Galleries & Apps. Without `zip` the client gets a button that opens the Gallery; with it they can also download the images straight from the email, under the Zip settings you set. The email reaches your client, so the agent shows the recipients and the text first. By default you confirm each call; you can switch that off for this tool.

  MCP callcloudspot_write → deliver_images

  REST endpointPOST https://cotlet.dev/api/v1/cloudspot/images/deliver

  Parameters

  Parameters: deliver_images

  Name	Type	Description
  collection string required	string	Collection name, as read_galleries returns it.
  gallery string required	string	Gallery to send, by name.
  to array required	array	Recipient emails, from your saved Clients or typed in.
  zip object	object	Add a Zip file: `folders`, `limit_downloads`, `expires` (ISO date), `image_size` (`full`, `social` or `custom`) and `watermark` (true or false).
  template string	string	Saved Email Template to use. Leave empty and give `message` instead.
  message string	string	Email text when no template is used.
  copy_me boolean	boolean	Send yourself a copy of the email.

  Example input

  {
    "collection": "collection",
    "gallery": "gallery",
    "to": "to"
  }

  Example response

  {
    "gallery": "Harper and Lee wedding",
    "to": [
      "client@example.com"
    ],
    "zip": {
      "image_size": "full",
      "limit_downloads": 3,
      "expires": "2027-01-15",
      "watermark": false
    },
    "sent": true
  }

• set_gallery_expiration Set, change or remove a Gallery's expiration date and its reminder email. writeAsks first

  This is the Expiration Date setting on the Gallery's Access tab. An expired Gallery stays in your account, but the client sees only the cover photo and a note to contact you. The reminder reaches clients, so the change waits for your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callcloudspot_write → set_gallery_expiration

  REST endpointPUT https://cotlet.dev/api/v1/cloudspot/gallery-expiration

  Parameters

  Parameters: set_gallery_expiration

  Name	Type	Description
  collection string required	string	Collection name, as read_galleries returns it.
  gallery string required	string	Gallery name.
  expires string	string	ISO date. Leave empty to remove the date and reactivate the Gallery.
  reminder_days integer	integer	Days before expiration to send the reminder. Needs an expiration date at least two days away.
  reminder_to array	array	Specific emails for the reminder. Leave empty to use all Gallery visitors when Email Capture is on.

  Example input

  {
    "collection": "collection",
    "gallery": "gallery"
  }

  Example response

  {
    "gallery": "Harper and Lee wedding",
    "expires": "2027-02-01",
    "reminder_days": 7,
    "reminder_to": "all visitors",
    "saved": true
  }

ToolWhat it doesAccess

• manage_leads List and read inquiries from your Lead Forms, email a lead, archive it or convert it to a Project. writeAsks first

  A lead reads as New until it is opened, then Reviewed. `convert_to_project` saves the lead as a Client and creates a Project assigned to them. The agent never uses Delete Lead, which CloudSpot cannot undo. By default you confirm each call; you can switch that off for this tool.

  MCP callcloudspot_write → manage_leads

  REST endpointPOST https://cotlet.dev/api/v1/cloudspot/leads/manage

  Parameters

  Parameters: manage_leads

  Name	Type	Description
  action string required	string	One of `list`, `get`, `email`, `archive`, `convert_to_project`. `list` and `get` only read.
  lead string	string	Lead name or email, for every action except `list`.
  status string	string	For `list`: `new`, `reviewed` or `archived`.
  message string	string	For `email`: the email text.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "leads": [
      {
        "name": "Example Bride",
        "email": "bride@example.com",
        "status": "New",
        "answers": {
          "event_date": "2027-06-12",
          "venue": "Example Barn"
        }
      },
      {
        "name": "Sample Family",
        "email": "family@example.com",
        "status": "Reviewed"
      }
    ]
  }

• manage_clients List or read your saved Clients, add a new one or add a client note. writeAsks first

  This is Studio's Clients page. Run `list` first so the same client is not saved twice; once saved, a client can be assigned to Projects, documents and Galleries. By default you confirm each call; you can switch that off for this tool.

  MCP callcloudspot_write → manage_clients

  REST endpointPOST https://cotlet.dev/api/v1/cloudspot/clients/manage

  Parameters

  Parameters: manage_clients

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`, `add_note`. `list` and `get` only read.
  client string	string	Client name or email, as manage_clients `list` returns it.
  fields object	object	For `create`: first_name, last_name and email (required), phone and address (optional).
  note object	object	For `add_note`: title and text.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "client": "Example Bride",
    "email": "bride@example.com",
    "phone": "+1 555 0100",
    "saved": true
  }

• manage_projects List or read Studio Projects with their activity, create one or add a document to it. writeAsks first

  A Project keeps every document of one event or client together. `get` returns its documents and its Activity History: when the client viewed documents, signed contracts, paid and completed questionnaires. Documents added here are saved to the Project, not sent; send them with the contract, questionnaire or invoice tool. By default you confirm each call; you can switch that off for this tool.

  MCP callcloudspot_write → manage_projects

  REST endpointPOST https://cotlet.dev/api/v1/cloudspot/projects/manage

  Parameters

  Parameters: manage_projects

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`, `add_document`. `list` and `get` only read.
  project string	string	Project name, as manage_projects `list` returns it.
  fields object	object	For `create`: name, date, client and an optional description, which clients do not see.
  document object	object	For `add_document`: type (`contract`, `questionnaire` or `invoice`) and the template to start from.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "project": "Example Bride wedding",
    "date": "2027-06-12",
    "client": "Example Bride",
    "documents": [
      "Wedding contract",
      "Wedding questionnaire",
      "Wedding invoice"
    ],
    "activity": [
      {
        "event": "Contract signed",
        "at": "2026-11-12T18:04"
      }
    ]
  }

• manage_to_dos List, add, rename, complete or delete items on your CloudSpot Dashboard To Do List. writeAsks first

  A deleted to-do cannot be restored in CloudSpot; a completed one can be moved back to Active. By default you confirm each call; you can switch that off for this tool.

  MCP callcloudspot_write → manage_to_dos

  REST endpointPOST https://cotlet.dev/api/v1/cloudspot/dos/manage

  Parameters

  Parameters: manage_to_dos

  Name	Type	Description
  action string required	string	One of `list`, `create`, `update`, `complete`, `delete`. `list` and `get` only read.
  to_do string	string	The task text, for every action except `list`.
  new_text string	string	For `update`: the new task text.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "active": [
      "Cull the Rivera session",
      "Order album proofs for Harper and Lee"
    ],
    "completed": 4
  }

ToolWhat it doesAccess

• manage_contracts List or read Contracts with their activity, draft one from a template or send it to the client. writeAsks first

  `create` saves a draft; `send` emails it, so you can read the contract before your client does. `get` includes the Activity Feed: when the contract was created, viewed and signed. By default you confirm each call; you can switch that off for this tool.

  MCP callcloudspot_write → manage_contracts

  REST endpointPOST https://cotlet.dev/api/v1/cloudspot/contracts/manage

  Parameters

  Parameters: manage_contracts

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`, `send`. `list` and `get` only read.
  contract string	string	Contract name, for `get` and `send`.
  client string	string	Client name or email, as manage_clients `list` returns it.
  template string	string	For `create`: Contract Template to start from.
  email string	string	For `send`: Email Template name or the email text.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "contract": "Wedding contract",
    "client": "Example Bride",
    "status": "Viewed",
    "activity": [
      {
        "event": "Created",
        "at": "2026-11-10T09:12"
      },
      {
        "event": "Viewed",
        "at": "2026-11-11T20:31"
      }
    ]
  }

• manage_questionnaires List or read Questionnaires, draft one from a template or send it to the client. writeAsks first

  Questionnaires go out on their own or through a Project; to link one to a Project, its client must match the Project's client. `send` reaches your client, so it waits for your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callcloudspot_write → manage_questionnaires

  REST endpointPOST https://cotlet.dev/api/v1/cloudspot/questionnaires/manage

  Parameters

  Parameters: manage_questionnaires

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`, `send`. `list` and `get` only read.
  questionnaire string	string	Questionnaire name, for `get` and `send`.
  client string	string	Client name or email, as manage_clients `list` returns it.
  template string	string	For `create`: template to start from.
  questions array	array	For `create` from scratch: each with text, type (`short_answer`, `long_answer`, `dropdown`, `radio`, `checkboxes` or `date`) and `required`.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "questionnaire": "Wedding questionnaire",
    "client": "Example Bride",
    "questions": 12,
    "status": "Draft"
  }

• manage_invoices List or read Invoices, create one with a payment schedule, send it or send a payment reminder. writeAsks first

  CloudSpot already emails automatic payment reminders before and after each due date; `remind` sends the extra reminder from the Invoice's Quick Actions menu. `create` saves a draft and `send` emails it, so you can check the amounts first. By default you confirm each call; you can switch that off for this tool.

  MCP callcloudspot_write → manage_invoices

  REST endpointPOST https://cotlet.dev/api/v1/cloudspot/invoices/manage

  Parameters

  Parameters: manage_invoices

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`, `send`, `remind`. `list` and `get` only read.
  invoice string	string	Invoice name, for `get`, `send` and `remind`.
  client string	string	Client name or email, as manage_clients `list` returns it.
  template string	string	For `create`: Invoice Template to start from.
  lines array	array	For `create`: description and price per line item.
  payments array	array	For `create`: the payment schedule, amount and ISO due date per payment. CloudSpot splits the total equally until you set amounts.

  Example input

  {
    "action": "create",
    "client": "Example Bride",
    "template": "Wedding collection",
    "lines": [
      {
        "description": "Wedding day coverage, 8 hours",
        "price": 2800
      },
      {
        "description": "Engagement session",
        "price": 400
      }
    ],
    "payments": [
      {
        "amount": 1000,
        "due": "2026-11-20"
      },
      {
        "amount": 2200,
        "due": "2027-05-29"
      }
    ]
  }

  Example response

  {
    "invoice": "Wedding invoice",
    "client": "Example Bride",
    "total": 3200,
    "payments": [
      {
        "amount": 1000,
        "due": "2026-11-20",
        "status": "Due"
      },
      {
        "amount": 2200,
        "due": "2027-05-29",
        "status": "Scheduled"
      }
    ],
    "status": "Draft"
  }

• record_manual_payment Record a check, cash or other offline payment on a Studio Invoice. writeAsks first

  This is Add Manual Payment in the Invoice's Quick Actions; CloudSpot offers it on upgraded plans. The payment appears in Payment History and updates the Invoice status. It moves no money; a refund of a manual payment also happens outside CloudSpot. By default you confirm each call; you can switch that off for this tool.

  MCP callcloudspot_write → record_manual_payment

  REST endpointPOST https://cotlet.dev/api/v1/cloudspot/manual-payments

  Parameters

  Parameters: record_manual_payment

  Name	Type	Description
  invoice string required	string	Invoice name.
  date string required	string	ISO date the client paid.
  amount number required	number	Amount paid.
  method string required	string	Payment method, as CloudSpot lists it, for example Check or Cash.
  description string	string	Short note on the payment.
  transaction_id string	string	Reference for you and your client.
  send_confirmation boolean	boolean	Email your client a confirmation.

  Example input

  {
    "invoice": "invoice",
    "date": "date",
    "amount": 1,
    "method": "method"
  }

  Example response

  {
    "invoice": "Wedding invoice",
    "amount": 1000,
    "method": "Check",
    "date": "2026-11-18",
    "status": "Partially paid",
    "saved": true
  }

ToolWhat it doesAccess

• manage_mini_sessions List or read your mini-sessions and their bookings, or create a new one with time slots. writeAsks first

  This is New Mini-Session in Studio's Booking section. Sample photos (up to 6) are added by hand. `get` lists every time slot with the client who booked it and the payment, if one was required. By default you confirm each call; you can switch that off for this tool.

  MCP callcloudspot_write → manage_mini_sessions

  REST endpointPOST https://cotlet.dev/api/v1/cloudspot/mini-sessions/manage

  Parameters

  Parameters: manage_mini_sessions

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`. `list` and `get` only read.
  mini_session string	string	Mini-session name, for `get`.
  fields object	object	For `create`: name, description, date, time_slots (with AM or PM), location, require_payment, price and terms.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "mini_session": "Fall minis at Example Park",
    "date": "2026-11-22",
    "slots": [
      {
        "time": "9:00 AM",
        "client": "Sample Family",
        "paid": 150
      },
      {
        "time": "9:30 AM",
        "client": null
      }
    ],
    "price": 150
  }

• manage_bookings Move a mini-session booking to another open slot, delete it, or refund its payment. writeAsks first

  CloudSpot sends the client no email when a booking is edited or deleted, so the agent reminds you to tell them; a refund does send them an email. The freed slot opens for other clients. A refund cannot be pulled back. By default you confirm each call; you can switch that off for this tool.

  MCP callcloudspot_write → manage_bookings

  REST endpointPOST https://cotlet.dev/api/v1/cloudspot/bookings/manage

  Parameters

  Parameters: manage_bookings

  Name	Type	Description
  action string required	string	One of `reschedule`, `delete`, `refund`. `list` and `get` only read.
  mini_session string required	string	Mini-session name.
  client string required	string	Client who booked.
  new_time string	string	For `reschedule`: one of the open time slots.

  Example input

  {
    "action": "action",
    "mini_session": "mini session",
    "client": "client"
  }

  Example response

  {
    "mini_session": "Fall minis at Example Park",
    "client": "Sample Family",
    "from": "9:00 AM",
    "to": "10:30 AM",
    "rescheduled": true
  }

ToolWhat it doesAccess

• manage_discount_codes List your Store discount codes or create one for prints, digital products or shipping. writeAsks first

  Discount codes live in the Discount Codes section of your Store and need a card on file. If a client's payment does not cover the lab's cost of goods, CloudSpot charges your card the difference, so the agent shows the amount and the minimum order before saving. By default you confirm each call; you can switch that off for this tool.

  MCP callcloudspot_write → manage_discount_codes

  REST endpointPOST https://cotlet.dev/api/v1/cloudspot/discount-codes/manage

  Parameters

  Parameters: manage_discount_codes

  Name	Type	Description
  action string required	string	One of `list`, `create`. `list` and `get` only read.
  fields object	object	For `create`: name (only you see it), code, apply_to (`subtotal`, `shipping` or `digital`), a percentage or fixed amount, expires (ISO date), minimum_order and max_uses.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "name": "Holiday print sale",
    "code": "HOLIDAY20",
    "apply_to": "subtotal",
    "percent_off": 20,
    "minimum_order": 50,
    "expires": "2026-12-15",
    "created": true
  }

• review_pending_orders List Store orders waiting in review, or submit one to the lab. writeAsks first

  Orders wait in Pending Orders when the Catalog has Approve Orders Before Fulfillment on, until you submit them or the hold window ends. A submitted order cannot be undone, so the agent shows the order before it goes to the lab. Crop edits stay with you in CloudSpot. By default you confirm each call; you can switch that off for this tool.

  MCP callcloudspot_write → review_pending_orders

  REST endpointPOST https://cotlet.dev/api/v1/cloudspot/pending-orders/review

  Parameters

  Parameters: review_pending_orders

  Name	Type	Description
  action string required	string	One of `list`, `submit`. `list` and `get` only read.
  order string	string	Order number, for `submit`.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "pending_orders": [
      {
        "order": "10482",
        "client": "Sample Family",
        "items": 3,
        "total": 86,
        "auto_submits": "2026-11-16"
      }
    ]
  }