Skip to main content
Glama

Check Photo Compatibility

check_photo_compatibility
Read-onlyIdempotent

Check whether supplied pixel dimensions meet the print-contract 120 DPI hard gate used by upload. Returns per-size required_px. Crop and artefacts are still reviewed in the configurator. With a delivery country, also lists market-visible wall formats. If width/height are omitted, reports that suitability cannot be verified without dimensions.

Input Schema

NameRequiredDescriptionDefault
widthNoPhoto width in pixels
formatNoImage format (e.g. 'jpeg', 'png', 'heic', 'webp')
heightNoPhoto height in pixels
countryNoDelivery country as ISO alpha-2 or alpha-3. Required before market-visible print formats can be shown.

Output Schema

NameRequiredDescriptionDefault
errorNo
photoNo
marketNo
countryNo
messageNo
format_noteNo
launch_gateNo
recommendationNo
review_factorsNo
_response_budgetNo
assessment_statusNo
configurator_noteNo
resolution_statusNo
recommended_formatNo
resolution_by_sizeNo
available_print_formatsNo
compatibility_determinedNo
supported_upload_formatsNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed10 schema fields changed
    • removedOutput schema / properties / country / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / country / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / format_note / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / format_note / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / market / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / market / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / photo / properties / format / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / photo / properties / format / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / recommendation / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / recommendation / type
      Added value: +[
      +  "string",
      +  "null"
      +]
  2. Changed7 schema fields changed
    • removedInput schema / required
      Removed value: -[
      -  "width",
      -  "height"
      -]
    • changedOutput schema / properties / assessment_status / enum
      Previous value: -[
      -  "destination_required",
      -  "requires_configurator_review",
      -  "product_unavailable"
      -]New value: +[
      +  "destination_required",
      +  "dimensions_required",
      +  "requires_configurator_review",
      +  "product_unavailable",
      +  "incompatible",
      +  "too_large"
      +]
    • addedOutput schema / properties / available_print_formats / items / properties / required_px
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "landscape": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "h": {
      +          "type": "number"
      +        },
      +        "w": {
      +          "type": "number"
      +        }
      +      },
      +      "required": [
      +        "w",
      +        "h"
      +      ],
      +      "type": "object"
      +    },
      +    "portrait": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "h": {
      +          "type": "number"
      +        },
      +        "w": {
      +          "type": "number"
      +        }
      +      },
      +      "required": [
      +        "w",
      +        "h"
      +      ],
      +      "type": "object"
      +    }
      +  },
      +  "required": [
      +    "landscape",
      +    "portrait"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / available_print_formats / items / properties / resolution
      Added value: +{
      +  "enum": [
      +    "ok",
      +    "warn",
      +    "fail"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / available_print_formats / items / properties / technical_size
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / resolution_by_size
      Added value: +{
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "orientation": {
      +        "enum": [
      +          "landscape",
      +          "portrait"
      +        ],
      +        "type": "string"
      +      },
      +      "recommended_px": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "h": {
      +            "type": "number"
      +          },
      +          "w": {
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "w",
      +          "h"
      +        ],
      +        "type": "object"
      +      },
      +      "required_px": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "h": {
      +            "type": "number"
      +          },
      +          "w": {
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "w",
      +          "h"
      +        ],
      +        "type": "object"
      +      },
      +      "size": {
      +        "type": "string"
      +      },
      +      "status": {
      +        "enum": [
      +          "ok",
      +          "warn",
      +          "fail"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "size",
      +      "orientation",
      +      "status",
      +      "required_px",
      +      "recommended_px"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / resolution_status
      Added value: +{
      +  "enum": [
      +    "compatible",
      +    "incompatible",
      +    "mixed",
      +    "too_large",
      +    "unknown"
      +  ],
      +  "type": "string"
      +}
  3. Changed1 schema field changed
    • addedOutput schema / properties / _response_budget
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "dropped": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "limit_bytes": {
      +      "type": "number"
      +    },
      +    "note": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "dropped",
      +    "limit_bytes",
      +    "note"
      +  ],
      +  "type": "object"
      +}
  4. Changed15 schema fields changed
    • addedInput schema / properties / country
      Added value: +{
      +  "description": "Delivery country as ISO alpha-2 or alpha-3. Required before market-visible print formats can be shown.",
      +  "maxLength": 3,
      +  "type": "string"
      +}
    • addedOutput schema / properties / assessment_status
      Added value: +{
      +  "enum": [
      +    "destination_required",
      +    "requires_configurator_review",
      +    "product_unavailable"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / available_print_formats
      Added value: +{
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "dimensions_cm": {
      +        "type": "string"
      +      },
      +      "label": {
      +        "type": "string"
      +      },
      +      "product": {
      +        "type": "string"
      +      },
      +      "size": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "product",
      +      "size",
      +      "label",
      +      "dimensions_cm"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / compatibility_determined
      Added value: +{
      +  "type": "boolean"
      +}
    • removedOutput schema / properties / compatible_count
      Removed value: -{
      -  "type": "number"
      -}
    • addedOutput schema / properties / country
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / properties / launch_gate
      Added value: +{
      +  "additionalProperties": {},
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / market
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / properties / recommendation / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedOutput schema / properties / recommendation / type
      Removed value: -"string"
    • addedOutput schema / properties / recommended_format
      Added value: +{
      +  "type": "null"
      +}
    • removedOutput schema / properties / recommended_size
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "additionalProperties": false,
      -      "properties": {
      -        "label": {
      -          "type": "string"
      -        },
      -        "quality": {
      -          "enum": [
      -            "excellent",
      -            "good",
      -            "minimum",
      -            "too_low"
      -          ],
      -          "type": "string"
      -        },
      -        "size": {
      -          "type": "string"
      -        },
      -        "size_cm": {
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "size",
      -        "label",
      -        "size_cm",
      -        "quality"
      -      ],
      -      "type": "object"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ]
      -}
    • addedOutput schema / properties / review_factors
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • removedOutput schema / properties / sizes
      Removed value: -{
      -  "items": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "compatible": {
      -        "type": "boolean"
      -      },
      -      "label": {
      -        "type": "string"
      -      },
      -      "min_height": {
      -        "type": "number"
      -      },
      -      "min_width": {
      -        "type": "number"
      -      },
      -      "quality": {
      -        "enum": [
      -          "excellent",
      -          "good",
      -          "minimum",
      -          "too_low"
      -        ],
      -        "type": "string"
      -      },
      -      "size": {
      -        "type": "string"
      -      },
      -      "size_cm": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "size",
      -      "label",
      -      "size_cm",
      -      "min_width",
      -      "min_height",
      -      "compatible",
      -      "quality"
      -    ],
      -    "type": "object"
      -  },
      -  "type": "array"
      -}
    • addedOutput schema / properties / supported_upload_formats
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
  5. First observed

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly/idempotent/closed-world, and the description adds substantive domain behavior beyond them: the 120 DPI hard gate, per-size required_px output, country-gated market-visible formats, and the explicit fallback when dimensions are omitted. The remaining gap is that the role of 'format' on the outcome is never described.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Four tight sentences, front-loaded with the gate and the return payoff, with the degradation case last. Dense terminology ('per-size required_px', 'print-contract') is compact but still readable; nothing is padding.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present, the description need not enumerate return values, and annotations cover the safety profile, so coverage is strong. The only hole is the unaddressed 'format' parameter, leaving one input's effect on the compatibility verdict unexplained.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so baseline is 3; the description goes further by explaining that width/height are gating inputs and that omitting them yields an 'cannot be verified' result, and that country unlocks market-visible wall formats. It doesn't explain what the format parameter affects, so it isn't fully additive.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb and resource ('Check whether supplied pixel dimensions meet the print-contract 120 DPI hard gate') and scopes it precisely. It also distinguishes itself from the configurator sibling by noting that crop and artefacts are reviewed there, so an agent can separate this from the start_configuration/upload flow.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives clear context for use (pre-upload gate check) and states what is out of scope ('crop and artefacts are still reviewed in the configurator'), plus a conditional path for supplying country. It does not explicitly name a named alternative tool to call instead, which keeps it below a 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources