impeccable
The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, catch AI slop before it ships.
Add products to Bring! from a photo — MCP for AI recognition, catalog matching, and verified writes.
Skills that teach the AI this kind of work; they work alongside this one
The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, catch AI slop before it ships.
Editorial diagram design for Claude Code, Codex, GitHub Copilot, Cursor, Factory Droid, Qoder, and Pi. 45 diagram types. Self-contained HTML + SVG. No shadows. No Mermaid slop.
Create beautiful slides on the web using a coding agent's frontend skills
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 4/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 12/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 16/100 |
Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install Bring Photo MCP. Follow https://mcp.popnx.com/i/schnueck-bring-photo-mcp.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude, with some setup first
You need a Bring Photo MCP key (create it on the maker’s site) · 5 setting(s) to fill in (BRING_ENV, BRING_EMAIL, BRING_DEFAULT_LIST, BRING_ALLOWED_LISTS, BRING_TEST_ITEM_PREFIX) · Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Bring Photo MCP for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "bring-photo": { "command": "npx", "args": [ "-y", "bring-photo-mcp" ], "env": { "BRING_ENV": "your-value", "BRING_EMAIL": "your-value", "BRING_PASSWORD": "your-value", "BRING_DEFAULT_LIST": "your-value", "BRING_ALLOWED_LISTS": "your-value", "BRING_TEST_ITEM_PREFIX": "MCP-TEST-" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For BRING_PASSWORD, BRING_ENV, BRING_EMAIL, BRING_DEFAULT_LIST, BRING_ALLOWED_LISTS, BRING_TEST_ITEM_PREFIX, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Bring Photo MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
BRING_ENV Runtime boundary: use test for dedicated test lists or prod for explicitly allowlisted production lists.BRING_EMAIL Email address of the Bring account.BRING_DEFAULT_LIST Exact name of the default Bring list.BRING_ALLOWED_LISTS Comma-separated exact names of every Bring list the server may access.BRING_TEST_ITEM_PREFIX Required non-empty item-name prefix for opt-in live E2E runs in test mode. · default MCP-TEST-Descriptions are as written by the maker.
SettingsDeveloperEdit Config
{
"mcpServers": {
"bring-photo": {
"command": "npx",
"args": [
"-y",
"bring-photo-mcp"
],
"env": {
"BRING_ENV": "your-value",
"BRING_EMAIL": "your-value",
"BRING_PASSWORD": "your-value",
"BRING_DEFAULT_LIST": "your-value",
"BRING_ALLOWED_LISTS": "your-value",
"BRING_TEST_ITEM_PREFIX": "MCP-TEST-"
}
}
}
}Paste the key only into the app’s field, never into a chat or to anyone
Use Bring Photo MCP and tell me what you can do for me, then show me one thing✓ If Claude says it is using Bring Photo MCP or shows a Bring Photo MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
BRING_LOCALE Bring catalog locale. · default de-DEBRING_TEST_SECOND_LIST Optional exact name of a second dedicated test list for copy, move, and multi-list E2E checks.Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect Bring Photo MCP yet
Bring Photo MCP runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect Bring Photo MCP
B · Others in Design, images & audio that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
Works with Claude Code, with some setup first
You need a Bring Photo MCP key (create it on the maker’s site) · 5 setting(s) to fill in (BRING_ENV, BRING_EMAIL, BRING_DEFAULT_LIST, BRING_ALLOWED_LISTS, BRING_TEST_ITEM_PREFIX) · Install Node.js on your computer first (one time)
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Bring Photo MCP for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user bring-photo --env BRING_ENV=your-value --env BRING_EMAIL=your-value --env BRING_PASSWORD=your-value --env BRING_DEFAULT_LIST=your-value --env BRING_ALLOWED_LISTS=your-value --env BRING_TEST_ITEM_PREFIX=MCP-TEST- -- npx -y bring-photo-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For BRING_PASSWORD, BRING_ENV, BRING_EMAIL, BRING_DEFAULT_LIST, BRING_ALLOWED_LISTS, BRING_TEST_ITEM_PREFIX, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Bring Photo MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
BRING_ENV Runtime boundary: use test for dedicated test lists or prod for explicitly allowlisted production lists.BRING_EMAIL Email address of the Bring account.BRING_DEFAULT_LIST Exact name of the default Bring list.BRING_ALLOWED_LISTS Comma-separated exact names of every Bring list the server may access.BRING_TEST_ITEM_PREFIX Required non-empty item-name prefix for opt-in live E2E runs in test mode. · default MCP-TEST-Descriptions are as written by the maker.
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --scope user bring-photo --env BRING_ENV=your-value --env BRING_EMAIL=your-value --env BRING_PASSWORD=your-value --env BRING_DEFAULT_LIST=your-value --env BRING_ALLOWED_LISTS=your-value --env BRING_TEST_ITEM_PREFIX=MCP-TEST- -- npx -y bring-photo-mcpReplace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
You should see Bring Photo MCP listed as connected
Use Bring Photo MCP and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using Bring Photo MCP or shows a Bring Photo MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
BRING_LOCALE Bring catalog locale. · default de-DEBRING_TEST_SECOND_LIST Optional exact name of a second dedicated test list for copy, move, and multi-list E2E checks.Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
You need a Bring Photo MCP key (create it on the maker’s site) · 5 setting(s) to fill in (BRING_ENV, BRING_EMAIL, BRING_DEFAULT_LIST, BRING_ALLOWED_LISTS, BRING_TEST_ITEM_PREFIX) · Install Node.js on your computer first (one time)
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Bring Photo MCP for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "bring-photo": { "command": "npx", "args": [ "-y", "bring-photo-mcp" ], "env": { "BRING_ENV": "your-value", "BRING_EMAIL": "your-value", "BRING_PASSWORD": "your-value", "BRING_DEFAULT_LIST": "your-value", "BRING_ALLOWED_LISTS": "your-value", "BRING_TEST_ITEM_PREFIX": "MCP-TEST-" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For BRING_PASSWORD, BRING_ENV, BRING_EMAIL, BRING_DEFAULT_LIST, BRING_ALLOWED_LISTS, BRING_TEST_ITEM_PREFIX, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Bring Photo MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
BRING_ENV Runtime boundary: use test for dedicated test lists or prod for explicitly allowlisted production lists.BRING_EMAIL Email address of the Bring account.BRING_DEFAULT_LIST Exact name of the default Bring list.BRING_ALLOWED_LISTS Comma-separated exact names of every Bring list the server may access.BRING_TEST_ITEM_PREFIX Required non-empty item-name prefix for opt-in live E2E runs in test mode. · default MCP-TEST-Descriptions are as written by the maker.
In the Bring Photo MCP settings, BRING_PASSWORD, BRING_ENV, BRING_EMAIL, BRING_DEFAULT_LIST, BRING_ALLOWED_LISTS, BRING_TEST_ITEM_PREFIX is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use Bring Photo MCP and tell me what you can do for me, then show me one thing✓ If Cursor says it is using Bring Photo MCP or shows a Bring Photo MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
BRING_LOCALE Bring catalog locale. · default de-DEBRING_TEST_SECOND_LIST Optional exact name of a second dedicated test list for copy, move, and multi-list E2E checks.Descriptions are as written by the maker.
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
You need a Bring Photo MCP key (create it on the maker’s site) · 5 setting(s) to fill in (BRING_ENV, BRING_EMAIL, BRING_DEFAULT_LIST, BRING_ALLOWED_LISTS, BRING_TEST_ITEM_PREFIX) · Install Node.js on your computer first (one time)
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Bring Photo MCP for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "bring-photo": { "type": "stdio", "command": "npx", "args": [ "-y", "bring-photo-mcp" ], "env": { "BRING_ENV": "your-value", "BRING_EMAIL": "your-value", "BRING_PASSWORD": "your-value", "BRING_DEFAULT_LIST": "your-value", "BRING_ALLOWED_LISTS": "your-value", "BRING_TEST_ITEM_PREFIX": "MCP-TEST-" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For BRING_PASSWORD, BRING_ENV, BRING_EMAIL, BRING_DEFAULT_LIST, BRING_ALLOWED_LISTS, BRING_TEST_ITEM_PREFIX, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Bring Photo MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
BRING_ENV Runtime boundary: use test for dedicated test lists or prod for explicitly allowlisted production lists.BRING_EMAIL Email address of the Bring account.BRING_DEFAULT_LIST Exact name of the default Bring list.BRING_ALLOWED_LISTS Comma-separated exact names of every Bring list the server may access.BRING_TEST_ITEM_PREFIX Required non-empty item-name prefix for opt-in live E2E runs in test mode. · default MCP-TEST-Descriptions are as written by the maker.
In the Bring Photo MCP settings, BRING_PASSWORD, BRING_ENV, BRING_EMAIL, BRING_DEFAULT_LIST, BRING_ALLOWED_LISTS, BRING_TEST_ITEM_PREFIX is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use Bring Photo MCP and tell me what you can do for me, then show me one thing✓ If VS Code says it is using Bring Photo MCP or shows a Bring Photo MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
BRING_LOCALE Bring catalog locale. · default de-DEBRING_TEST_SECOND_LIST Optional exact name of a second dedicated test list for copy, move, and multi-list E2E checks.Descriptions are as written by the maker.
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
JSON settings are under “For developers” below
Claude Code
claude mcp add --scope user bring-photo --env BRING_ENV=your-value --env BRING_EMAIL=your-value --env BRING_PASSWORD=your-value --env BRING_DEFAULT_LIST=your-value --env BRING_ALLOWED_LISTS=your-value --env BRING_TEST_ITEM_PREFIX=MCP-TEST- -- npx -y bring-photo-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"bring-photo": {
"command": "npx",
"args": [
"-y",
"bring-photo-mcp"
],
"env": {
"BRING_ENV": "your-value",
"BRING_EMAIL": "your-value",
"BRING_PASSWORD": "your-value",
"BRING_DEFAULT_LIST": "your-value",
"BRING_ALLOWED_LISTS": "your-value",
"BRING_TEST_ITEM_PREFIX": "MCP-TEST-"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"bring-photo": {
"command": "npx",
"args": [
"-y",
"bring-photo-mcp"
],
"env": {
"BRING_ENV": "your-value",
"BRING_EMAIL": "your-value",
"BRING_PASSWORD": "your-value",
"BRING_DEFAULT_LIST": "your-value",
"BRING_ALLOWED_LISTS": "your-value",
"BRING_TEST_ITEM_PREFIX": "MCP-TEST-"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"bring-photo": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"bring-photo-mcp"
],
"env": {
"BRING_ENV": "your-value",
"BRING_EMAIL": "your-value",
"BRING_PASSWORD": "your-value",
"BRING_DEFAULT_LIST": "your-value",
"BRING_ALLOWED_LISTS": "your-value",
"BRING_TEST_ITEM_PREFIX": "MCP-TEST-"
}
}
}
}BRING_ENV required envBRING_EMAIL required envBRING_PASSWORD secret required envBRING_DEFAULT_LIST required envBRING_ALLOWED_LISTS required envBRING_LOCALE envBRING_TEST_ITEM_PREFIX required envBRING_TEST_SECOND_LIST envDescriptions are as written by the maker.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
npm: bring-photo-mcpBased on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026
The registry name was verified with the GitHub account schnueck, which owns the repo
Code last changed 17 days ago
Uses MIT
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
No entries on OSV.dev for bring-photo-mcp@1.0.3
Checks only this package version, not every dependency · checked Nov 15, 2026
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/schnueck-bring-photo-mcp)Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: BRING_PASSWORD
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed 17 days ago, and the latest version (1.0.3) reached the registry 17 days ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.
In the same category: HyperFrames by HeyGen, Pascal 3D Editor, draw.io, Figma MCP Server, Remocn: Remotion MCP server
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Official HyperFrames by HeyGen: the best AI video editor in chat. Captions, motion graphics, MP4.
Create, inspect, validate, and save editable 3D building scenes with Pascal's MCP server.
Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.
Figma’s official server gives AI your design data so it can turn designs into code or describe them accurately. Connects to Figma’s cloud.
Hosted MCP for Remotion videos: search Remocn components, read docs, plan a video, preview it.
| This one Bring Photo MCP | HyperFrames by HeyGen | Pascal 3D Editor | draw.io | Figma MCP Server | Remocn: Remotion MCP server | |
|---|---|---|---|---|---|---|
| Runs where | Installs on your computer | Runs in the cloud, nothing to install | Cloud or install on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install |
| Needs a key | Yes | No | No | No | No | No |
| Add with + in Claude | No | Yes | No | No | Yes | No |
| Basic checks | 3/3 | 4/4 | 5/5 | 4/4 | 4/4 | 4/4 |
| License | MIT | Apache-2.0 | MIT | Apache-2.0 | – | MIT |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
English | Deutsch
Turn product photos into Bring! shopping-list items.
Show your AI agent a package, label, or product photo and say: “Add this to my shopping list.” Bring Photo MCP lets the agent identify the product, match it with the Bring! catalog, select the right category and icon, attach the photo, and add the verified result to your Bring! list.
It also provides the usual list operations—searching, adding, checking, moving, copying, and removing items—but the photo-first workflow is the point: less typing, fewer ambiguous product names, and the original product image directly on the list.
Bring Photo MCP is a local, agent-neutral TypeScript MCP server. The executable stdio entrypoint starts only with locally validated environment variables; this repository contains no Hermes or client runtime configuration.
Requirements: Node.js 20+ and npm.
npm install
npm run typecheck npm run lint npm test npm run build
The official MCP TypeScript SDK (@modelcontextprotocol/sdk) is used. npm start builds the project and starts dist/index.js as a stdio server. Startup validates the configuration and authenticates with Bring only afterwards; this repository intentionally contains no Hermes or client runtime configuration.
The package is prepared for public npm publication, constrained by an explicit files allowlist, and includes a bring-photo-mcp stdio binary entrypoint. The public thin-skill guidance is in SKILL.md; tested client templates are in docs/MCP-CLIENT-CONFIGURATION.md. Migration and rollback without runtime cutover are specified in docs/MIGRATION-ROLLBACK.md.
Never commit .env with real values. The configuration model expects:
BRING_ENV=test|prodBRING_EMAIL, BRING_PASSWORDBRING_DEFAULT_LISTBRING_ALLOWED_LISTS (comma-separated)BRING_LOCALE (default de-DE)BRING_TEST_ITEM_PREFIX (default MCP-TEST-)BRING_TEST_SECOND_LIST exclusively for the multi-list E2Esrc/config.ts validates the values. In PROD, the service accepts only allowlisted lists; the production runtime must additionally point to a pinned release tag. TEST uses a dedicated allowlisted list and temporary prefixed test items only.
Long-running sessions automatically reauthenticate with the configured account after an explicit Bring HTTP 401. Concurrent failures share one renewal, and the account identity must remain unchanged. Read requests may retry once; writes are never automatically replayed. If a write reports an authentication failure, inspect the list before deciding whether to submit a new operation. Failed renewal stops cleanly rather than looping; reconnect the MCP after resolving the cause. Public catalog and image downloads never receive authentication headers.
To update, pin bring-photo-mcp@1.0.3 in your MCP client configuration and restart or reconnect that MCP server. No new credentials or configuration fields are required. See the changelog for the fix details.
npm run test:e2e is deliberately not part of npm test and was not run here. It starts only with a fully configured environment and rejects anything other than BRING_ENV=test. BRING_ALLOWED_LISTS must contain exactly BRING_DEFAULT_LIST; with BRING_TEST_SECOND_LIST, it must contain exactly both named configured TEST lists. A non-empty BRING_TEST_ITEM_PREFIX is required.
The harness creates two synthetic PNG files in the temporary directory, verifies add/read-back as well as photo replace/remove, and removes all of its own prefixed items in finally, followed by an absence check. Copy, move, and multi-list operations run only with an explicit BRING_TEST_SECOND_LIST; without it, the harness reports an honest skip.
src/bring-adapter.ts: deterministic Bring gateway interface and HTTP protocol adapter. Legacy item bodies are generated only with URLSearchParams; details are read through bringlists/{listUuid}/details; the catalog is loaded from https://web.getbring.com/locale/catalog.{locale}.json; detail metadata uses ISO-8859-1 multipart; photos use native FormData with the imageData field. An explicit transferImage gateway capability downloads source image bytes without Bring authentication and uploads them only to the target.src/bring-service.ts: business rules, list allowlisting, classification and duplicate rules, read-back verification, copy-before-delete for moves, and per-list results.src/mcp-server.ts: 15 Zod-validated MCP tools; no transport layer.src/redaction.ts: redacts password/token fields, UUID-like IDs, and local paths from error text.Write operations are successful only after the item and detail have been read again. The detail must contain a UUID, userIconItemId, and userSectionId; photos additionally require imageUrl. Broken/orphan details are not used unless itemId matches exactly.
Read: bring_list_lists, bring_list_items, bring_search_catalog, bring_list_categories, bring_suggest_classification, bring_get_item.
Write: bring_add_item, bring_attach_photo, bring_replace_photo, bring_remove_photo, bring_copy_item, bring_move_item, bring_check_item, bring_uncheck_item, bring_remove_item.
bring_add_item always requires icon_item_id and category_id; both must match within the loaded catalog. The default for duplicate_policy is fail; update_exact changes only the exact same identity. Multi-list calls always return one result per target list and use status: "partial" for partial failures.
CONFIGURATION, LIST_NOT_ALLOWED, LIST_NOT_FOUND, ITEM_NOT_FOUND, INVALID_CLASSIFICATION, DUPLICATE_AMBIGUOUS, VERIFICATION_FAILED, UPSTREAM_FAILURE, IMAGE_INVALID, CLASSIFICATION_UNCERTAIN.
Error text contains no credentials, UUIDs, or image paths.
This project was developed with AI-assisted coding and documentation tools under human direction and review. Its automated tests, isolated live E2E checks, and release artifacts were independently verified before publication. Thomas Schnuecker remains the project maintainer and is responsible for releases.
Credentials, real list UUIDs, and product photos do not belong in Git, fixtures, or logs. This repository triggers no login or live operation. The existing bring-safe solution remains unchanged as the rollback until an explicitly approved cutover.
TEST E2E and the eight-photo regression are intentionally not active automatically: they require an approved dedicated TEST list, temporary prefixed items, and supplied test images. Afterwards, remove every generated TEST item and photo through read-back and verify their absence.