The Lupa MCP server connects your Lupa account to AI assistants such as Claude. Share a folder of photos, and the assistant creates a Lupa album, uploads the photos, suggests a name, size, layout and theme, and starts generating a print-ready photo book. It all happens in conversation.
What you can do
- Create a photo book from a folder. Point the assistant at a folder of photos (for example, a trip or an event). It creates the album and uploads the photos, or gives you a link to drop them into the Lupa app.
- Get a complete proposal in one message. The assistant looks at a sample of your photos and suggests a name, format, layout density, reading direction and theme. Confirm once and generation starts.
- Track generation. The assistant reports progress and gives you a link to open the finished book in the Lupa app.
- Manage your existing albums. List and search your albums, see their details, rename them, duplicate them, change a book's theme, or change its format, density or direction.
Printing and payment stay in the Lupa app. The MCP server never places orders or charges you.
Requirements
- A Lupa account. You can sign up for free at lupa.co.il.
- An AI client that supports remote MCP servers with OAuth, such as Claude (web, desktop or mobile), Claude Code, or another MCP-compatible client.
- Photos on your computer or phone. To upload straight from a local folder, the assistant must be able to run commands (for example, Claude Code or Claude desktop with file access). Otherwise you upload through a link to the Lupa app.
Connect Lupa to Claude
From the Claude connectors directory
- In Claude, open Settings → Connectors and select Browse connectors.
- Search for Lupa and select Connect.
- Sign in to your Lupa account and approve access.
- Start a new conversation and ask Claude to make a photo book.
As a custom connector (any MCP client)
Add a remote MCP server with this URL:
https://mcp.lupa.co.il/mcp
The client discovers the sign-in flow automatically through standard OAuth 2.0 protected-resource metadata. Approve access when prompted.
For Claude Code:
claude mcp add --transport http lupa https://mcp.lupa.co.il/mcp
How it works
-
Start. The assistant calls
start_album, which creates an album with a temporary name. -
Upload. If the assistant can read your local folder, it uploads the photos directly. Otherwise it sends you a link to the album's photo page in the Lupa app and waits until the upload finishes (
wait_for_upload). You don't need to say "done". -
Review. The assistant looks at up to 16 thumbnails taken from across the album (
get_album_photos), checks the available formats and themes, and proposes the whole book in one message. - Confirm. Reply "yes", or ask for changes. Nothing is finalized until you confirm.
-
Generate. The assistant calls
finish_album, follows progress withget_album_status, and gives you the link to the finished book. - Edit and order in the Lupa app. Open the link to fine-tune pages and order your printed book.
Example prompts
Tools reference
Read tools only read data. Write tools create or change data. Destructive tools can discard work, so the assistant must explain the impact and get your explicit confirmation first.
Create a book
| Tool | Type | What it does |
|---|---|---|
start_album |
Write | Creates a new album with a temporary name. Returns the upload link, a short-lived upload ticket and the book type's rules. |
get_upload_link |
Read | Returns a fresh upload link and ticket for an existing album. Tickets expire after 5 minutes. |
wait_for_upload |
Read | Waits until photos arrive and the photo count stops growing. |
get_album_photos |
Read | Returns the photo count, the current album name and up to 16 thumbnails spread across the album. |
list_formats |
Read | Lists the sizes and covers, layout densities and reading directions available for this album. |
list_themes |
Read | Lists the themes valid for the chosen format, direction and density. |
finish_album |
Write | Names and closes the album with the confirmed settings and starts generating the book. Called only after you confirm. |
get_album_status |
Read | Reports generation progress and returns the link to the finished book. |
Manage albums
| Tool | Type | What it does |
|---|---|---|
list_my_albums |
Read | Lists your albums, most recently updated first. You can filter by status (open or closed) or search by name. |
get_album |
Read | Returns one album's details: status, photo and page counts, format, direction, generation status and its link in the Lupa app. |
rename_album |
Write | Renames an album (2–28 characters). On a closed book, the cover is updated with the new title. |
duplicate_album |
Write | Copies an album, including its photos and, for a closed book, its design, into a new album. |
change_theme |
Write | Gives a closed book a different theme while keeping its photos and layout. |
change_book_type |
Write | Changes the book type of an open album (Regular, Mini Lupa or Haggadah). |
change_book_settings |
Destructive | Changes a closed book's direction, layout density or format. The book is regenerated, so manual edits made in the editor are lost. The assistant must warn you and get explicit confirmation first. |
Uploading photos
- Accepted formats: JPG, JPEG, PNG, WebP, GIF, BMP, TIF/TIFF, HEIC, HEIF and AVIF. Other files are skipped.
- Maximum file size: 15 MB per photo. When it can, the assistant compresses larger photos before uploading them. If it can't, it tells you which files were skipped so you can upload them in the Lupa app.
-
Two ways to upload:
- From a local folder: when the assistant can run commands, it uploads directly using a short-lived ticket that works only for that one album.
- Through the Lupa app: otherwise, the assistant sends you a link to the album's photo page. You upload there, signed in with your Lupa account, through the same upload process the app always uses.
Book types
| Type | Description |
|---|---|
| Regular | The classic Lupa photo book. You choose the size, density, direction and theme. |
| Mini Lupa | A small-format book with a fixed cover and density. Up to 144 photos. |
| Haggadah | A personalized Passover Haggadah. Up to 60 photos, with no opening or closing pages. |
Some settings are fixed by the book type, and the assistant uses those values automatically instead of asking you about them.
Confirmations and safety
- The assistant always proposes the complete book and waits for your explicit "yes" before calling
finish_album. - Renaming an album and changing its theme require your confirmation.
-
change_book_settingsregenerates the book and discards manual edits. It is marked as destructive, and the assistant must explain this and get your explicit confirmation first. - Every setting is validated before anything changes. If a request isn't allowed (for example, too many photos for a Mini Lupa), it is refused and nothing changes.
- The server cannot delete albums, place orders or make payments.
Authentication, security and privacy
Authentication
- You sign in with OAuth 2.0 through Lupa's own sign-in service. Your password is never shared with the AI client.
- The server works only with your albums and has the same permissions you have in the Lupa web app.
- Access tokens are never logged, never returned by a tool and never placed in a URL. The AI client's token is exchanged on the server for a separate internal token, so a token leaked from the client side cannot be used against Lupa's APIs directly.
- Upload tickets expire after 5 minutes and work for a single album only.
What data is used
- Album data: names, settings and photo thumbnails, read from your Lupa account only when a tool needs them. Thumbnails are shown to the AI assistant so it can propose a name and theme.
- Product analytics: for each tool call, Lupa records the tool name, its identifier arguments (such as album id, cover, theme and direction), and an optional short description of what you are trying to do. Free text is redacted before it is stored: emails, phone numbers, tokens and similar details are removed. Album names, search text, tool results, photos and error messages are not collected.
- Lupa does not sell your data or use your photos to train AI models.
Read the full Lupa Privacy Policy.
Disconnect
To revoke access, remove the Lupa connector in your AI client (in Claude: Settings → Connectors → Lupa → Disconnect). Your albums stay in your Lupa account.
Limits
- Album names: 2–28 characters.
- Photos: up to 15 MB each. Up to 144 photos for Mini Lupa and 60 for Haggadah.
- Album copies: up to 35 per day.
- The assistant reviews up to 16 thumbnails per album.
Troubleshooting
| Problem | What to do |
|---|---|
| "Please reconnect" or authentication errors | Disconnect and reconnect the Lupa connector, then sign in again. |
| Upload fails with an expired ticket | Ask the assistant to continue. It gets a fresh link with get_upload_link. |
| Some photos were skipped | They were larger than 15 MB or not an image format. Compress them, or upload them in the Lupa app. |
| "Temporarily unavailable" | Wait a minute and try again. If it continues, contact support and include the request_id from the message. |
| The album stays open after confirming | Ask the assistant to check the album's status. A setting may not be valid for the book type. |
Support
For help with the Lupa MCP server or your albums, contact support@lupa.co.il.
הערות
0 הערות
המאמר סגור להערות.