Koskamo

PhotoPrintAgent Narrow MCP

A scoped OAuth connector for browsing products, viewing previews, getting quotes, and tracking saved orders or support requests. It excludes order creation, payment processing, and AI generation tools, requiring users to upload and purchase via the website.

Visit PhotoPrintAgent

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

PhotoPrintAgent Narrow MCP logo, by PhotoPrintAgentVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-01Operated by PhotoPrintAgent
You need:Use an MCP client that supports remote Streamable HTTP and OAuth, guest or bearer-token access.Request read-only access for status; add preparation access for quotes and support.Every grant requires explicit account-holder consent.
MCP endpoint (Streamable HTTP)
https://photoprintagent.com/mcp-narrow
Vendor documentation

What you can do with it

  • Browse public products and check availability
  • Get delivery price quotes and estimates
  • Track saved order status and updates
  • Manage support requests

Source and maintenance

Vendor evidenceRegistry 2.4.0
mcp-registry: com.photoprintagent/mcp-narrow@2.4.0Project website

Protocol and capabilities

Server
PhotoPrintAgent 2.4.0
MCP protocol
2025-06-18
Tools
10 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

PhotoPrintAgent narrow customer connector: browse products, estimate costs, preview existing uploads, save quotes and read saved order status or request support. Upload photos and complete purchases at https://photoprintagent.com. No order creation, payment execution, account administration or AI generation is available here. Saved status can lag processing; unknown is not shipped. Only PhotoPrintAgent product branding and public product codes may appear in customer updates. Never disclose supplier information. A support request is not a completed cancellation or refund.

Tools

10 advertised

list_products — List Products
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Public paginated product catalog, print specifications, and availability. Follow nextOffset until null. availableOnly defaults to true; false includes unavailable public products with explicit available flags. Filters cover query, category, finish, dimensions and known unit price range. capabilities distinguishes API support from current orderability. productCode and sku are PhotoPrintAgent seller codes for customer listings and search; id remains the API identifier for uploads and quotes. Each product supplies artwork dimensions, minimum/maximum image counts, ordered slot labels, bleed and rotation rules. These apply to all active supported products, including multi-image designs. Artwork minimumDpi values are print quality guidance, not an upload rejection threshold: accept smaller valid images, resize them, and treat reduced quality as a nonblocking warning. Admin Only products are never listed. Pass a returned products[].id as productId when uploading and quoting; omission selects the original photo-4x6 product. Price depends on the items and destination; call quote_prints for an authoritative total.

list_products input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "maxLength": 100
    },
    "finish": {
      "type": "string",
      "maxLength": 80
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "category": {
      "type": "string",
      "maxLength": 80
    },
    "widthInches": {
      "type": "number",
      "maximum": 1000,
      "exclusiveMinimum": 0
    },
    "heightInches": {
      "type": "number",
      "maximum": 1000,
      "exclusiveMinimum": 0
    },
    "availableOnly": {
      "type": "boolean",
      "default": true
    },
    "maxPriceCents": {
      "type": "integer",
      "minimum": 0
    },
    "minPriceCents": {
      "type": "integer",
      "minimum": 0
    }
  },
  "additionalProperties": false
}
list_products output schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "product",
    "orderingAvailable",
    "googleEnabled",
    "xEnabled",
    "x402Available",
    "paymentNetwork",
    "solanaAvailable",
    "x402PayTo",
    "support"
  ],
  "properties": {
    "total": {
      "type": "number"
    },
    "product": {
      "type": "object",
      "required": [
        "id",
        "title",
        "countries",
        "maxPhotos",
        "maxPrints",
        "specs"
      ],
      "properties": {
        "id": {
          "type": "string",
          "const": "photo-4x6"
        },
        "sku": {
          "type": "string"
        },
        "specs": {
          "type": "object",
          "required": [
            "widthInches",
            "heightInches",
            "landscapePixels",
            "portraitPixels",
            "recommendedDpi",
            "minimumDpi",
            "colorSpace",
            "outputFormat",
            "maxFileBytes",
            "maxInputPixels",
            "acceptedMimeTypes",
            "acceptedExtensions",
            "imageHandling",
            "aspectRatio",
            "cropRules",
            "priceMode"
          ],
          "properties": {
            "cropRules": {
              "type": "string"
            },
            "priceMode": {
              "type": "string",
              "const": "quote_required"
            },
            "colorSpace": {
              "type": "string",
              "const": "sRGB"
            },
            "minimumDpi": {
              "type": "number"
            },
            "aspectRatio": {
              "type": "string"
            },
            "widthInches": {
              "type": "number"
            },
            "heightInches": {
              "type": "number"
            },
            "maxFileBytes": {
              "type": "number"
            },
            "outputFormat": {
              "type": "string",
              "const": "image/jpeg"
            },
            "imageHandling": {
              "type": "object",
              "required": [
                "resolutionPolicy",
                "animationPolicy",
                "multipagePolicy",
                "transparencyPolicy",
                "colorPolicy",
                "svgPolicy",
                "unsupportedPolicy",
                "helpUrl"
              ],
              "properties": {
                "helpUrl": {
                  "type": "string"
                },
                "svgPolicy": {
                  "type": "string"
                },
                "colorPolicy": {
                  "type": "string"
                },
                "animationPolicy": {
                  "type": "string"
                },
                "multipagePolicy": {
                  "type": "string"
                },
                "resolutionPolicy": {
                  "type": "string"
                },
                "unsupportedPolicy": {
                  "type": "string"
                },
                "transparencyPolicy": {
                  "type": "string"
                }
              },
              "additionalProperties": false
            },
            "maxInputPixels": {
              "type": "number"
            },
            "portraitPixels": {
              "type": "array",
              "items": {
                "type": "number"
              }
            },
            "recommendedDpi": {
              "type": "number"
            },
            "landscapePixels": {
              "type": "array",
              "items": {
                "type": "number"
              }
            },
            "acceptedMimeTypes": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "acceptedExtensions": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          "additionalProperties": false
        },
        "title": {
          "type": "string"
        },
        "countries": {
          "type": "array",
          "items": {
            "type": "string",
            "const": "US"
          }
        },
        "maxPhotos": {
          "type": "integer"
        },
        "maxPrints": {
          "type": "integer"
        },
        "productCode": {
          "type": "string"
        }
      },
      "additionalProperties": false
    },
    "support": {
      "type": "string"
    },
    "products": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "title",
          "description",
          "widthInches",
          "heightInches"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "sku": {
            "type": "string"
          },
          "size": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "finish": {
            "type": "string"
          },
          "artwork": {
            "type": "object",
            "required": [
              "widthPixels",
              "heightPixels",
              "minImages",
              "maxImages",
              "minimumDpi",
              "allowRotate",
              "labels",
              "bleed",
              "issues"
            ],
            "properties": {
              "bleed": {
                "type": "object",
                "additionalProperties": {
                  "type": "number"
                }
              },
              "issues": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "labels": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "calendar": {
                "type": "object",
                "required": [
                  "layout",
                  "months"
                ],
                "properties": {
                  "layout": {
                    "type": "string",
                    "const": "alternating-photo-grid"
                  },
                  "months": {
                    "enum": [
                      12,
                      18
                    ],
                    "type": "number"
                  }
                },
                "additionalProperties": false
              },
              "maxImages": {
                "type": "integer"
              },
              "minImages": {
                "type": "integer"
              },
              "minimumDpi": {
                "type": "number"
              },
              "allowRotate": {
                "type": "boolean"
              },
              "composition": {
                "type": "object",
                "required": [
                  "id",
                  "width",
                  "height",
                  "background",
                  "slots"
                ],
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "slots": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "x",
                        "y",
                        "width",
                        "height"
                      ],
                      "properties": {
                        "x": {
                          "type": "integer"
                        },
                        "y": {
                          "type": "integer"
                        },
                        "width": {
                          "type": "integer"
                        },
                        "height": {
                          "type": "integer"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "width": {
                    "type": "integer"
                  },
                  "height": {
                    "type": "integer"
                  },
                  "background": {
                    "type": "string"
                  }
                },
                "additionalProperties": false
              },
              "widthPixels": {
                "type": "integer"
              },
              "heightPixels": {
                "type": "integer"
              },
              "qualityGuidance": {
                "type": "object",
                "required": [
                  "recommendedDpi",
                  "minimumDpiIsRejectionThreshold",
                  "fitModes",
                  "fitDescription"
                ],
                "properties": {
                  "fitModes": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "fitDescription": {
                    "type": "string"
                  },
                  "recommendedDpi": {
                    "type": "number"
                  },
                  "minimumDpiIsRejectionThreshold": {
                    "type": "boolean"
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          },
          "preview": {
            "type": "object",
            "additionalProperties": {}
          },
          "category": {
            "type": "string"
          },
          "shipping": {
            "type": "object",
            "required": [
              "mode"
            ],
            "properties": {
              "mode": {
                "enum": [
                  "provider",
                  "flat",
                  "per_item"
                ],
                "type": "string"
              },
              "amountCents": {
                "type": "integer",
                "default": 0,
                "maximum": 100000,
                "minimum": 0
              },
              "multipleItemAmountCents": {
                "anyOf": [
                  {
                    "$ref": "#/properties/products/items/properties/shipping/properties/amountCents"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null
              }
            },
            "additionalProperties": false
          },
          "adminOnly": {
            "type": "boolean"
          },
          "available": {
            "type": "boolean"
          },
          "description": {
            "type": "string"
          },
          "productCode": {
            "type": "string",
            "pattern": "^PPA[A-F0-9]{12}$"
          },
          "widthInches": {
            "type": "number"
          },
          "heightInches": {
            "type": "number"
          },
          "unitPriceCents": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0,
                "description": "Integer USD cents"
              },
              {
                "type": "null"
              }
            ],
            "description": "Integer USD cents"
          },
          "unavailableReason": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "xEnabled": {
      "type": "boolean"
    },
    "x402PayTo": {
      "type": [
        "string",
        "null"
      ]
    },
    "nextOffset": {
      "type": [
        "number",
        "null"
      ]
    },
    "capabilities": {
      "type": "object",
      "additionalProperties": {
        "type": "object",
        "required": [
          "supported",
          "availableToOrder",
          "productCount"
        ],
        "properties": {
          "supported": {
            "type": "boolean"
          },
          "productCount": {
            "type": "number"
          },
          "availableToOrder": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      }
    },
    "googleEnabled": {
      "type": "boolean"
    },
    "x402Available": {
      "type": "boolean"
    },
    "paymentNetwork": {
      "type": "string"
    },
    "catalogProducts": {
      "type": "array",
      "items": {
        "$ref": "#/properties/products/items"
      }
    },
    "solanaAvailable": {
      "type": "boolean"
    },
    "deliveryEstimate": {
      "type": "string"
    },
    "priceFilterBasis": {
      "type": "string"
    },
    "orderingAvailable": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}
list_products annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
list_photos — List Photos
Advertised by the server during the last successful anonymous check.
Advertised read-only

List your unexpired, unlocked uploaded photos. Use their IDs in slot order. Photos reserved by an order cannot be deleted.

list_photos input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {},
  "additionalProperties": false
}
list_photos output schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "photos"
  ],
  "properties": {
    "photos": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "productId",
          "artworkKey",
          "width",
          "height",
          "quality",
          "orientation"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "width": {
            "type": "integer"
          },
          "height": {
            "type": "integer"
          },
          "quality": {
            "anyOf": [
              {
                "enum": [
                  "high",
                  "reduced"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "productId": {
            "type": "string"
          },
          "artworkKey": {
            "type": "string"
          },
          "orientation": {
            "enum": [
              "portrait",
              "landscape"
            ],
            "type": "string"
          }
        },
        "additionalProperties": false
      }
    }
  },
  "additionalProperties": false
}
list_photos annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
preview_print_item — Preview Print Item
Advertised by the server during the last successful anonymous check.
Advertised read-only

Preview one complete design using owned uploaded photoIds in product slot order. Reviewed compositions (including photobooth strips) render the same assembly used for fulfillment. For artwork.calendar, include calendar:{startYear,startMonth}; previews include the generated date grids in print page order. Other products return ordered flat artwork pages, not a physical mockup. JPEG thumbnails appear as MCP image content after the JSON metadata. Page with offset/limit; no order or external photo link is created.

preview_print_item input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "photoIds"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 4,
      "maximum": 4,
      "minimum": 1
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "calendar": {
      "type": "object",
      "required": [
        "startYear",
        "startMonth"
      ],
      "properties": {
        "startYear": {
          "type": "integer",
          "maximum": 2100,
          "minimum": 2000
        },
        "startMonth": {
          "type": "integer",
          "maximum": 12,
          "minimum": 1
        }
      },
      "additionalProperties": false
    },
    "photoIds": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid"
      },
      "maxItems": 200,
      "minItems": 1
    },
    "productId": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9-]{1,63}$"
    }
  },
  "additionalProperties": false
}
preview_print_item output schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "productId",
    "kind",
    "layoutId",
    "totalPages",
    "nextOffset",
    "pages"
  ],
  "properties": {
    "kind": {
      "enum": [
        "composition",
        "artwork_pages",
        "calendar"
      ],
      "type": "string"
    },
    "pages": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "index",
          "label",
          "width",
          "height"
        ],
        "properties": {
          "index": {
            "type": "integer"
          },
          "label": {
            "type": "string"
          },
          "width": {
            "type": "integer"
          },
          "height": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      }
    },
    "layoutId": {
      "type": [
        "string",
        "null"
      ]
    },
    "productId": {
      "type": "string"
    },
    "nextOffset": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ]
    },
    "totalPages": {
      "type": "integer"
    }
  },
  "additionalProperties": false
}
preview_print_item annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
estimate_print_price — Estimate Print Price
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Estimate configured product and shipping charges using only product, quantity, ZIP and state. No photos or contact details required. Unknown tax or charges remain null; this is not a payable quote.

estimate_print_price input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "productId",
    "quantity",
    "zip",
    "state"
  ],
  "properties": {
    "zip": {
      "type": "string",
      "pattern": "^\\d{5}$"
    },
    "state": {
      "type": "string",
      "pattern": "^[A-Z]{2}$"
    },
    "quantity": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1
    },
    "productId": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1
    }
  },
  "additionalProperties": false
}
estimate_print_price output schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "estimate",
    "currency",
    "productId",
    "quantity",
    "subtotal",
    "shipping",
    "tax",
    "total",
    "knownAmount",
    "unknownComponents",
    "requiresFinalQuote",
    "message"
  ],
  "properties": {
    "tax": {
      "type": [
        "number",
        "null"
      ]
    },
    "total": {
      "type": [
        "number",
        "null"
      ]
    },
    "message": {
      "type": "string"
    },
    "currency": {
      "type": "string",
      "const": "USD"
    },
    "estimate": {
      "type": "boolean",
      "const": true
    },
    "quantity": {
      "type": "number"
    },
    "shipping": {
      "type": [
        "number",
        "null"
      ]
    },
    "subtotal": {
      "type": [
        "number",
        "null"
      ]
    },
    "productId": {
      "type": "string"
    },
    "knownAmount": {
      "type": "number"
    },
    "unknownComponents": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "requiresFinalQuote": {
      "type": "boolean",
      "const": true
    }
  },
  "additionalProperties": false
}
estimate_print_price annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
preview_print_price — Preview Print Price
Advertised by the server during the last successful anonymous check.
Open-world

Estimate product and destination pricing before using the customer’s photos for an order. Uses placeholder artwork and does not create an order or a payable quote. Call quote_prints with buyer consent before checkout.

preview_print_price input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "items",
    "shipping"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "quantity"
        ],
        "properties": {
          "photoId": {
            "type": "string",
            "format": "uuid"
          },
          "calendar": {
            "type": "object",
            "required": [
              "startYear",
              "startMonth"
            ],
            "properties": {
              "startYear": {
                "type": "integer",
                "maximum": 2100,
                "minimum": 2000
              },
              "startMonth": {
                "type": "integer",
                "maximum": 12,
                "minimum": 1
              }
            },
            "additionalProperties": false
          },
          "photoIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "maxItems": 200,
            "minItems": 1
          },
          "quantity": {
            "type": "integer",
            "maximum": 99,
            "minimum": 1
          },
          "productId": {
            "type": "string",
            "pattern": "^[a-z0-9][a-z0-9-]{1,63}$"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50,
      "minItems": 1
    },
    "shipping": {
      "type": "object",
      "required": [
        "firstName",
        "lastName",
        "email",
        "phone",
        "line1",
        "city",
        "state",
        "zip",
        "country"
      ],
      "properties": {
        "zip": {
          "type": "string",
          "pattern": "^\\d{5}(-\\d{4})?$"
        },
        "city": {
          "$ref": "#/properties/shipping/properties/firstName"
        },
        "email": {
          "type": "string",
          "format": "email",
          "maxLength": 254
        },
        "line1": {
          "$ref": "#/properties/shipping/properties/firstName"
        },
        "line2": {
          "type": "string",
          "default": "",
          "maxLength": 150
        },
        "phone": {
          "type": "string"
        },
        "state": {
          "type": "string",
          "pattern": "^[A-Z]{2}$"
        },
        "country": {
          "type": "string",
          "const": "US"
        },
        "lastName": {
          "$ref": "#/properties/shipping/properties/firstName"
        },
        "firstName": {
          "type": "string",
          "maxLength": 150,
          "minLength": 1
        }
      },
      "additionalProperties": false
    },
    "productId": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9-]{1,63}$"
    },
    "campaignId": {
      "type": "string",
      "pattern": "^[a-f0-9]{16}$"
    },
    "couponCode": {
      "type": "string",
      "maxLength": 64
    }
  },
  "additionalProperties": false
}
preview_print_price output schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "preview",
    "price",
    "validUntil",
    "expiresAt",
    "lineItems"
  ],
  "properties": {
    "price": {
      "type": "object",
      "required": [
        "currency",
        "subtotal",
        "shipping",
        "tax",
        "total"
      ],
      "properties": {
        "tax": {
          "$ref": "#/properties/price/properties/subtotal"
        },
        "total": {
          "$ref": "#/properties/price/properties/subtotal"
        },
        "coupon": {
          "type": "object",
          "required": [
            "code",
            "name",
            "printDiscount",
            "shippingDiscount",
            "taxCredit"
          ],
          "properties": {
            "code": {
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "taxCredit": {
              "$ref": "#/properties/price/properties/subtotal"
            },
            "printDiscount": {
              "$ref": "#/properties/price/properties/subtotal"
            },
            "shippingDiscount": {
              "$ref": "#/properties/price/properties/subtotal"
            }
          },
          "additionalProperties": false
        },
        "currency": {
          "type": "string",
          "const": "USD"
        },
        "discount": {
          "$ref": "#/properties/price/properties/subtotal",
          "description": "Integer USD cents"
        },
        "shipping": {
          "$ref": "#/properties/price/properties/subtotal"
        },
        "subtotal": {
          "type": "integer",
          "minimum": 0,
          "description": "Integer USD cents"
        },
        "originalTotal": {
          "$ref": "#/properties/price/properties/subtotal",
          "description": "Integer USD cents"
        }
      },
      "additionalProperties": false
    },
    "preview": {
      "type": "boolean",
      "const": true
    },
    "expiresAt": {
      "$ref": "#/properties/validUntil"
    },
    "lineItems": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "productId",
          "quantity"
        ],
        "properties": {
          "photoId": {
            "type": "string",
            "format": "uuid"
          },
          "calendar": {
            "type": "object",
            "required": [
              "startYear",
              "startMonth"
            ],
            "properties": {
              "startYear": {
                "type": "integer",
                "maximum": 2100,
                "minimum": 2000
              },
              "startMonth": {
                "type": "integer",
                "maximum": 12,
                "minimum": 1
              }
            },
            "additionalProperties": false
          },
          "photoIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            }
          },
          "quantity": {
            "type": "integer"
          },
          "productId": {
            "type": "string"
          }
        },
        "additionalProperties": false
      }
    },
    "validUntil": {
      "type": "integer",
      "minimum": 0,
      "description": "Unix time in milliseconds"
    }
  },
  "additionalProperties": false
}
preview_print_price annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
quote_prints — Quote Prints
Advertised by the server during the last successful anonymous check.
Open-world

Quote private uploaded photo IDs and a US destination for an optional productId from list_products (defaults to photo-4x6). Items may specify productId to mix products using the same print service; omitted item productId uses the order productId. For a single image use items:[{photoId,productId,quantity}]. For a multi-image design use items:[{photoIds:[frontId,backId,...],quantity}]; array order is print order and quantity counts complete products, not individual images. Follow artwork.minImages/maxImages and labels. For artwork.calendar, upload a cover plus one photo per month and include calendar:{startYear,startMonth} on the item; the server generates and interleaves the date grids. Do not upload date grids. For artwork.composition, upload each source photo at the per-image dimensions; the server assembles the ordered photos into the single print file shown by the layout. Never precompose those photos or send each side as a separate item. Up to 200 uploaded images and 500 product units per order. Shipping follows the product’s configured pricing; flat rates can differ for 1 versus 2+ prints. Use the returned shipping and total; never multiply flat shipping by quantity. Requires consent for PhotoPrintAgent to process these photos and address for printing and delivery. Unique photos, at most 500 total prints. Optional couponCode is validated here; price.total is the discounted buyer amount and price.discount is the savings in USD cents.

quote_prints input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "items",
    "shipping",
    "consent"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "quantity"
        ],
        "properties": {
          "photoId": {
            "type": "string",
            "format": "uuid"
          },
          "calendar": {
            "type": "object",
            "required": [
              "startYear",
              "startMonth"
            ],
            "properties": {
              "startYear": {
                "type": "integer",
                "maximum": 2100,
                "minimum": 2000
              },
              "startMonth": {
                "type": "integer",
                "maximum": 12,
                "minimum": 1
              }
            },
            "additionalProperties": false
          },
          "photoIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "maxItems": 200,
            "minItems": 1
          },
          "quantity": {
            "type": "integer",
            "maximum": 99,
            "minimum": 1
          },
          "productId": {
            "type": "string",
            "pattern": "^[a-z0-9][a-z0-9-]{1,63}$"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50,
      "minItems": 1
    },
    "consent": {
      "type": "boolean",
      "const": true
    },
    "shipping": {
      "type": "object",
      "required": [
        "firstName",
        "lastName",
        "email",
        "phone",
        "line1",
        "city",
        "state",
        "zip",
        "country"
      ],
      "properties": {
        "zip": {
          "type": "string",
          "pattern": "^\\d{5}(-\\d{4})?$"
        },
        "city": {
          "$ref": "#/properties/shipping/properties/firstName"
        },
        "email": {
          "type": "string",
          "format": "email",
          "maxLength": 254
        },
        "line1": {
          "$ref": "#/properties/shipping/properties/firstName"
        },
        "line2": {
          "type": "string",
          "default": "",
          "maxLength": 150
        },
        "phone": {
          "type": "string"
        },
        "state": {
          "type": "string",
          "pattern": "^[A-Z]{2}$"
        },
        "country": {
          "type": "string",
          "const": "US"
        },
        "lastName": {
          "$ref": "#/properties/shipping/properties/firstName"
        },
        "firstName": {
          "type": "string",
          "maxLength": 150,
          "minLength": 1
        }
      },
      "additionalProperties": false
    },
    "productId": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9-]{1,63}$"
    },
    "campaignId": {
      "type": "string",
      "pattern": "^[a-f0-9]{16}$"
    },
    "couponCode": {
      "type": "string",
      "maxLength": 64
    }
  },
  "additionalProperties": false
}
quote_prints output schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id",
    "price",
    "validUntil",
    "expiresAt",
    "lineItems"
  ],
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid"
    },
    "price": {
      "type": "object",
      "required": [
        "currency",
        "subtotal",
        "shipping",
        "tax",
        "total"
      ],
      "properties": {
        "tax": {
          "$ref": "#/properties/price/properties/subtotal"
        },
        "total": {
          "$ref": "#/properties/price/properties/subtotal"
        },
        "coupon": {
          "type": "object",
          "required": [
            "code",
            "name",
            "printDiscount",
            "shippingDiscount",
            "taxCredit"
          ],
          "properties": {
            "code": {
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "taxCredit": {
              "$ref": "#/properties/price/properties/subtotal"
            },
            "printDiscount": {
              "$ref": "#/properties/price/properties/subtotal"
            },
            "shippingDiscount": {
              "$ref": "#/properties/price/properties/subtotal"
            }
          },
          "additionalProperties": false
        },
        "currency": {
          "type": "string",
          "const": "USD"
        },
        "discount": {
          "$ref": "#/properties/price/properties/subtotal",
          "description": "Integer USD cents"
        },
        "shipping": {
          "$ref": "#/properties/price/properties/subtotal"
        },
        "subtotal": {
          "type": "integer",
          "minimum": 0,
          "description": "Integer USD cents"
        },
        "originalTotal": {
          "$ref": "#/properties/price/properties/subtotal",
          "description": "Integer USD cents"
        }
      },
      "additionalProperties": false
    },
    "expiresAt": {
      "$ref": "#/properties/validUntil"
    },
    "lineItems": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "productId",
          "quantity"
        ],
        "properties": {
          "photoId": {
            "type": "string",
            "format": "uuid"
          },
          "calendar": {
            "type": "object",
            "required": [
              "startYear",
              "startMonth"
            ],
            "properties": {
              "startYear": {
                "type": "integer",
                "maximum": 2100,
                "minimum": 2000
              },
              "startMonth": {
                "type": "integer",
                "maximum": 12,
                "minimum": 1
              }
            },
            "additionalProperties": false
          },
          "photoIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            }
          },
          "quantity": {
            "type": "integer"
          },
          "productId": {
            "type": "string"
          }
        },
        "additionalProperties": false
      }
    },
    "validUntil": {
      "type": "integer",
      "minimum": 0,
      "description": "Unix time in milliseconds"
    }
  },
  "additionalProperties": false
}
quote_prints annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
list_orders — List Orders
Advertised by the server during the last successful anonymous check.
Advertised read-only

List your most recent orders, newest first, up to 50. Does not reconcile payments; use get_order for a specific order. Unpaid Admin Only orders require a verified admin session.

list_orders input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 50,
      "minimum": 1
    }
  },
  "additionalProperties": false
}
list_orders output schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "orders"
  ],
  "properties": {
    "orders": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "status",
          "price",
          "pricingVersion",
          "paymentDeadline",
          "quantity",
          "createdAt",
          "paidAt",
          "paymentStatus",
          "fulfillmentStatus",
          "trackingUrls",
          "message"
        ],
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[a-zA-Z0-9_-]{1,100}$"
          },
          "price": {
            "type": "object",
            "required": [
              "currency",
              "subtotal",
              "shipping",
              "tax",
              "total"
            ],
            "properties": {
              "tax": {
                "$ref": "#/properties/orders/items/properties/price/properties/subtotal"
              },
              "total": {
                "$ref": "#/properties/orders/items/properties/price/properties/subtotal"
              },
              "coupon": {
                "type": "object",
                "required": [
                  "code",
                  "name",
                  "printDiscount",
                  "shippingDiscount",
                  "taxCredit"
                ],
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "taxCredit": {
                    "$ref": "#/properties/orders/items/properties/price/properties/subtotal"
                  },
                  "printDiscount": {
                    "$ref": "#/properties/orders/items/properties/price/properties/subtotal"
                  },
                  "shippingDiscount": {
                    "$ref": "#/properties/orders/items/properties/price/properties/subtotal"
                  }
                },
                "additionalProperties": false
              },
              "currency": {
                "type": "string",
                "const": "USD"
              },
              "discount": {
                "$ref": "#/properties/orders/items/properties/price/properties/subtotal",
                "description": "Integer USD cents"
              },
              "shipping": {
                "$ref": "#/properties/orders/items/properties/price/properties/subtotal"
              },
              "subtotal": {
                "type": "integer",
                "minimum": 0,
                "description": "Integer USD cents"
              },
              "originalTotal": {
                "$ref": "#/properties/orders/items/properties/price/properties/subtotal",
                "description": "Integer USD cents"
              }
            },
            "additionalProperties": false
          },
          "paidAt": {
            "anyOf": [
              {
                "$ref": "#/properties/orders/items/properties/paymentDeadline"
              },
              {
                "type": "null"
              }
            ],
            "description": "Unix time in milliseconds"
          },
          "status": {
            "enum": [
              "creating_checkout",
              "awaiting_payment",
              "verifying_payment",
              "settling_payment",
              "paid",
              "submitting",
              "processing",
              "needs_review",
              "expired"
            ],
            "type": "string"
          },
          "message": {
            "type": [
              "string",
              "null"
            ]
          },
          "progress": {
            "type": "object",
            "required": [
              "productionStatus",
              "shipmentStatus",
              "lastUpdatedAt",
              "trackingUrls",
              "supportStatus",
              "canRequestCancellation",
              "canRequestChange",
              "canRequestRefund",
              "cancellationGuaranteed"
            ],
            "properties": {
              "trackingUrls": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "lastUpdatedAt": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "supportStatus": {
                "enum": [
                  "none",
                  "open",
                  "waiting_customer",
                  "under_review",
                  "resolved"
                ],
                "type": "string"
              },
              "shipmentStatus": {
                "enum": [
                  "unknown",
                  "shipped",
                  "delivered"
                ],
                "type": "string"
              },
              "canRequestChange": {
                "type": "boolean"
              },
              "canRequestRefund": {
                "type": "boolean"
              },
              "productionStatus": {
                "enum": [
                  "not_submitted",
                  "queued",
                  "submitting",
                  "accepted",
                  "printing",
                  "shipped",
                  "delivered",
                  "cancelled",
                  "on_hold",
                  "needs_review",
                  "unknown"
                ],
                "type": "string"
              },
              "canRequestCancellation": {
                "type": "boolean"
              },
              "cancellationGuaranteed": {
                "type": "boolean",
                "const": false
              }
            },
            "additionalProperties": false
          },
          "quantity": {
            "type": "integer"
          },
          "createdAt": {
            "$ref": "#/properties/orders/items/properties/paymentDeadline"
          },
          "imageCount": {
            "type": "integer"
          },
          "productName": {
            "type": "string"
          },
          "trackingUrls": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uri"
            }
          },
          "paymentStatus": {
            "enum": [
              "unpaid",
              "pending",
              "paid",
              "refunded",
              "not_required",
              "needs_review",
              "expired"
            ],
            "type": "string"
          },
          "pricingVersion": {
            "type": "integer",
            "minimum": 0
          },
          "paymentDeadline": {
            "type": "integer",
            "minimum": 0,
            "description": "Unix time in milliseconds"
          },
          "fulfillmentStatus": {
            "enum": [
              "not_submitted",
              "submitting",
              "accepted",
              "needs_review"
            ],
            "type": "string"
          }
        },
        "additionalProperties": false
      }
    }
  },
  "additionalProperties": false
}
list_orders annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_order — Get Order
Advertised by the server during the last successful anonymous check.
Advertised read-only

Read your saved order status without payment reconciliation or print submission. Status may lag processing; report unknown explicitly. Complete checkout on the website.

get_order input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "orderId"
  ],
  "properties": {
    "orderId": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9_-]{1,100}$"
    }
  },
  "additionalProperties": false
}
get_order output schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id",
    "status",
    "price",
    "pricingVersion",
    "paymentDeadline",
    "quantity",
    "createdAt",
    "paidAt",
    "paymentStatus",
    "fulfillmentStatus",
    "trackingUrls",
    "message"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9_-]{1,100}$"
    },
    "price": {
      "type": "object",
      "required": [
        "currency",
        "subtotal",
        "shipping",
        "tax",
        "total"
      ],
      "properties": {
        "tax": {
          "$ref": "#/properties/price/properties/subtotal"
        },
        "total": {
          "$ref": "#/properties/price/properties/subtotal"
        },
        "coupon": {
          "type": "object",
          "required": [
            "code",
            "name",
            "printDiscount",
            "shippingDiscount",
            "taxCredit"
          ],
          "properties": {
            "code": {
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "taxCredit": {
              "$ref": "#/properties/price/properties/subtotal"
            },
            "printDiscount": {
              "$ref": "#/properties/price/properties/subtotal"
            },
            "shippingDiscount": {
              "$ref": "#/properties/price/properties/subtotal"
            }
          },
          "additionalProperties": false
        },
        "currency": {
          "type": "string",
          "const": "USD"
        },
        "discount": {
          "$ref": "#/properties/price/properties/subtotal",
          "description": "Integer USD cents"
        },
        "shipping": {
          "$ref": "#/properties/price/properties/subtotal"
        },
        "subtotal": {
          "type": "integer",
          "minimum": 0,
          "description": "Integer USD cents"
        },
        "originalTotal": {
          "$ref": "#/properties/price/properties/subtotal",
          "description": "Integer USD cents"
        }
      },
      "additionalProperties": false
    },
    "paidAt": {
      "anyOf": [
        {
          "$ref": "#/properties/paymentDeadline"
        },
        {
          "type": "null"
        }
      ],
      "description": "Unix time in milliseconds"
    },
    "status": {
      "enum": [
        "creating_checkout",
        "awaiting_payment",
        "verifying_payment",
        "settling_payment",
        "paid",
        "submitting",
        "processing",
        "needs_review",
        "expired"
      ],
      "type": "string"
    },
    "message": {
      "type": [
        "string",
        "null"
      ]
    },
    "progress": {
      "type": "object",
      "required": [
        "productionStatus",
        "shipmentStatus",
        "lastUpdatedAt",
        "trackingUrls",
        "supportStatus",
        "canRequestCancellation",
        "canRequestChange",
        "canRequestRefund",
        "cancellationGuaranteed"
      ],
      "properties": {
        "trackingUrls": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "lastUpdatedAt": {
          "type": [
            "number",
            "null"
          ]
        },
        "supportStatus": {
          "enum": [
            "none",
            "open",
            "waiting_customer",
            "under_review",
            "resolved"
          ],
          "type": "string"
        },
        "shipmentStatus": {
          "enum": [
            "unknown",
            "shipped",
            "delivered"
          ],
          "type": "string"
        },
        "canRequestChange": {
          "type": "boolean"
        },
        "canRequestRefund": {
          "type": "boolean"
        },
        "productionStatus": {
          "enum": [
            "not_submitted",
            "queued",
            "submitting",
            "accepted",
            "printing",
            "shipped",
            "delivered",
            "cancelled",
            "on_hold",
            "needs_review",
            "unknown"
          ],
          "type": "string"
        },
        "canRequestCancellation": {
          "type": "boolean"
        },
        "cancellationGuaranteed": {
          "type": "boolean",
          "const": false
        }
      },
      "additionalProperties": false
    },
    "quantity": {
      "type": "integer"
    },
    "createdAt": {
      "$ref": "#/properties/paymentDeadline"
    },
    "imageCount": {
      "type": "integer"
    },
    "productName": {
      "type": "string"
    },
    "trackingUrls": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      }
    },
    "paymentStatus": {
      "enum": [
        "unpaid",
        "pending",
        "paid",
        "refunded",
        "not_required",
        "needs_review",
        "expired"
      ],
      "type": "string"
    },
    "pricingVersion": {
      "type": "integer",
      "minimum": 0
    },
    "paymentDeadline": {
      "type": "integer",
      "minimum": 0,
      "description": "Unix time in milliseconds"
    },
    "fulfillmentStatus": {
      "enum": [
        "not_submitted",
        "submitting",
        "accepted",
        "needs_review"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}
get_order annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_order_events — Get Order Events
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Read your customer-safe order events in sequence. Save the last sequence as after for incremental recovery; duplicate events must be deduplicated by orderId and sequence.

get_order_events input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "orderId"
  ],
  "properties": {
    "after": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "orderId": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9_-]{1,100}$"
    }
  },
  "additionalProperties": false
}
get_order_events output schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "events",
    "nextCursor"
  ],
  "properties": {
    "events": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "orderId",
          "sequence",
          "type",
          "occurredAt",
          "data"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "data": {
            "type": "object",
            "required": [
              "productionStatus",
              "shipmentStatus",
              "lastUpdatedAt",
              "trackingUrls",
              "supportStatus",
              "canRequestCancellation",
              "canRequestChange",
              "canRequestRefund",
              "cancellationGuaranteed",
              "paymentStatus"
            ],
            "properties": {
              "trackingUrls": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "lastUpdatedAt": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "paymentStatus": {
                "enum": [
                  "refunded",
                  "not_required",
                  "paid",
                  "unpaid"
                ],
                "type": "string"
              },
              "supportStatus": {
                "enum": [
                  "none",
                  "open",
                  "waiting_customer",
                  "under_review",
                  "resolved"
                ],
                "type": "string"
              },
              "shipmentStatus": {
                "enum": [
                  "unknown",
                  "shipped",
                  "delivered"
                ],
                "type": "string"
              },
              "canRequestChange": {
                "type": "boolean"
              },
              "canRequestRefund": {
                "type": "boolean"
              },
              "productionStatus": {
                "enum": [
                  "not_submitted",
                  "queued",
                  "submitting",
                  "accepted",
                  "printing",
                  "shipped",
                  "delivered",
                  "cancelled",
                  "on_hold",
                  "needs_review",
                  "unknown"
                ],
                "type": "string"
              },
              "canRequestCancellation": {
                "type": "boolean"
              },
              "cancellationGuaranteed": {
                "type": "boolean",
                "const": false
              }
            },
            "additionalProperties": false
          },
          "type": {
            "type": "string",
            "const": "order.updated"
          },
          "orderId": {
            "type": "string",
            "pattern": "^[a-zA-Z0-9_-]{1,100}$"
          },
          "sequence": {
            "type": "integer"
          },
          "occurredAt": {
            "type": "integer",
            "minimum": 0,
            "description": "Unix time in milliseconds"
          }
        },
        "additionalProperties": false
      }
    },
    "nextCursor": {
      "type": [
        "number",
        "null"
      ]
    }
  },
  "additionalProperties": false
}
get_order_events annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
request_order_help — Request Order Help
Advertised by the server during the last successful anonymous check.
Open-world

Create an order-bound support, address-change, cancellation or refund REQUEST. Requires buyer authorization. No cancellation, refund or change is executed or guaranteed. Reuse idempotencyKey when retrying the same request; read progress capability flags first.

request_order_help input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "orderId",
    "type",
    "message",
    "idempotencyKey"
  ],
  "properties": {
    "type": {
      "enum": [
        "general",
        "address",
        "cancellation",
        "refund",
        "damaged_prints",
        "late_delivery"
      ],
      "type": "string"
    },
    "message": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 10
    },
    "orderId": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9_-]{1,100}$"
    },
    "idempotencyKey": {
      "type": "string",
      "pattern": "^[\\w-]{16,100}$"
    }
  },
  "additionalProperties": false
}
request_order_help output schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "reference",
    "status",
    "type",
    "createdAt",
    "message"
  ],
  "properties": {
    "type": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "const": "requested"
    },
    "message": {
      "type": "string"
    },
    "createdAt": {
      "type": "integer",
      "minimum": 0,
      "description": "Unix time in milliseconds"
    },
    "reference": {
      "type": "string"
    }
  },
  "additionalProperties": false
}
request_order_help annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
662 ms
95th percentile latency
662 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 662 ms · metadata changed · 10 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http photoprintagent-narrow-mcp https://photoprintagent.com/mcp-narrow

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add photoprintagent-narrow-mcp --url https://photoprintagent.com/mcp-narrow

Cursor

Merge this server into .cursor/mcp.json in your project, then enable photoprintagent-narrow-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "photoprintagent-narrow-mcp": {
      "url": "https://photoprintagent.com/mcp-narrow"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "photoprintagent-narrow-mcp": {
      "type": "streamableHttp",
      "url": "https://photoprintagent.com/mcp-narrow",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start photoprintagent-narrow-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "photoprintagent-narrow-mcp": {
      "type": "http",
      "url": "https://photoprintagent.com/mcp-narrow"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http photoprintagent-narrow-mcp https://photoprintagent.com/mcp-narrow

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.
Claude Desktop configuration
{
  "mcpServers": {
    "photoprintagent-narrow-mcp": {
      "url": "https://photoprintagent.com/mcp-narrow"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "photoprintagent-narrow-mcp": {
      "serverUrl": "https://photoprintagent.com/mcp-narrow"
    }
  }
}

Let your agent find its tools

Find servers like PhotoPrintAgent Narrow MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 1,166

Do you run PhotoPrintAgent Narrow MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing