Skip to main content
Glama

Diagnose visual production

diagnose_production
Read-onlyIdempotent

Use the objekts Production Desk production-diagnosis engine for production-heavy visual work before proposing execution. It checks reference authority, hard locks, truth-layer routing, asset fitness, continuity, versioning, revision impact, readiness and the highest-value proof-of-concept. It does not estimate price, collect contact data, upload files or send anything externally. Populate only facts available from the user's current request/files; mark unknowns explicitly instead of inventing production facts. After the call, use visibleVerdict as the complete default answer: do not add a generic checklist or extra recommendations unless the user explicitly asks for a broader audit.

Input Schema

NameRequiredDescriptionDefault
assetsNo
changesNo
unknownsNo
versionsNo
objectiveYes
readinessYes
deliverablesYes
elementRoutesNo

Output Schema

NameRequiredDescriptionDefault
visibleVerdictYes
responseContractYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed13 schema fields changed
    • removedOutput schema / properties / assetFitness
      Removed value: -{
      -  "items": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "assetId": {
      -        "type": "string"
      -      },
      -      "controlsHardDomains": {
      -        "items": {
      -          "enum": [
      -            "CHARACTER_IDENTITY",
      -            "FACE",
      -            "BODY",
      -            "WARDROBE",
      -            "PRODUCT_GEOMETRY",
      -            "PRODUCT_COLOR",
      -            "PACKAGING",
      -            "MATERIAL_RESPONSE",
      -            "LOCATION_GEOMETRY",
      -            "ARCHITECTURE",
      -            "CAMERA",
      -            "LENS",
      -            "COMPOSITION",
      -            "LIGHTING",
      -            "COLOR",
      -            "LOGO",
      -            "TYPOGRAPHY",
      -            "COPY",
      -            "MOTION",
      -            "POSE",
      -            "INTERIOR_GEOMETRY",
      -            "SCALE",
      -            "DEPTH_PLANE",
      -            "FOCUS_BEHAVIOR",
      -            "SOUND",
      -            "OTHER"
      -          ],
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "fitness": {
      -        "enum": [
      -          "FIT",
      -          "FIT_WITH_REBUILD",
      -          "NOT_FIT",
      -          "UNKNOWN"
      -        ],
      -        "type": "string"
      -      },
      -      "label": {
      -        "type": "string"
      -      },
      -      "notes": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      }
      -    },
      -    "required": [
      -      "assetId",
      -      "label",
      -      "fitness",
      -      "controlsHardDomains",
      -      "notes"
      -    ],
      -    "type": "object"
      -  },
      -  "type": "array"
      -}
    • removedOutput schema / properties / authority
      Removed value: -{
      -  "additionalProperties": false,
      -  "properties": {
      -    "conflicts": {
      -      "items": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "assetIds": {
      -            "items": {
      -              "type": "string"
      -            },
      -            "type": "array"
      -          },
      -          "domain": {
      -            "enum": [
      -              "CHARACTER_IDENTITY",
      -              "FACE",
      -              "BODY",
      -              "WARDROBE",
      -              "PRODUCT_GEOMETRY",
      -              "PRODUCT_COLOR",
      -              "PACKAGING",
      -              "MATERIAL_RESPONSE",
      -              "LOCATION_GEOMETRY",
      -              "ARCHITECTURE",
      -              "CAMERA",
      -              "LENS",
      -              "COMPOSITION",
      -              "LIGHTING",
      -              "COLOR",
      -              "LOGO",
      -              "TYPOGRAPHY",
      -              "COPY",
      -              "MOTION",
      -              "POSE",
      -              "INTERIOR_GEOMETRY",
      -              "SCALE",
      -              "DEPTH_PLANE",
      -              "FOCUS_BEHAVIOR",
      -              "SOUND",
      -              "OTHER"
      -            ],
      -            "type": "string"
      -          },
      -          "reason": {
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "domain",
      -          "assetIds",
      -          "reason"
      -        ],
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "winners": {
      -      "items": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "approvalState": {
      -            "enum": [
      -              "EXPLORATORY",
      -              "CANDIDATE",
      -              "APPROVED",
      -              "FROZEN",
      -              "SUPERSEDED",
      -              "REJECTED"
      -            ],
      -            "type": "string"
      -          },
      -          "assetId": {
      -            "type": "string"
      -          },
      -          "domain": {
      -            "enum": [
      -              "CHARACTER_IDENTITY",
      -              "FACE",
      -              "BODY",
      -              "WARDROBE",
      -              "PRODUCT_GEOMETRY",
      -              "PRODUCT_COLOR",
      -              "PACKAGING",
      -              "MATERIAL_RESPONSE",
      -              "LOCATION_GEOMETRY",
      -              "ARCHITECTURE",
      -              "CAMERA",
      -              "LENS",
      -              "COMPOSITION",
      -              "LIGHTING",
      -              "COLOR",
      -              "LOGO",
      -              "TYPOGRAPHY",
      -              "COPY",
      -              "MOTION",
      -              "POSE",
      -              "INTERIOR_GEOMETRY",
      -              "SCALE",
      -              "DEPTH_PLANE",
      -              "FOCUS_BEHAVIOR",
      -              "SOUND",
      -              "OTHER"
      -            ],
      -            "type": "string"
      -          },
      -          "strength": {
      -            "enum": [
      -              "HARD",
      -              "SOFT"
      -            ],
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "domain",
      -          "assetId",
      -          "strength",
      -          "approvalState"
      -        ],
      -        "type": "object"
      -      },
      -      "type": "array"
      -    }
      -  },
      -  "required": [
      -    "winners",
      -    "conflicts"
      -  ],
      -  "type": "object"
      -}
    • removedOutput schema / properties / changes
      Removed value: -{
      -  "items": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "changeId": {
      -        "type": "string"
      -      },
      -      "impact": {
      -        "enum": [
      -          "NONE",
      -          "LOCAL_REVISION",
      -          "UPSTREAM_INVALIDATION",
      -          "NEW_PRODUCTION_UNIT",
      -          "REESTIMATE_REQUIRED"
      -        ],
      -        "type": "string"
      -      },
      -      "label": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "changeId",
      -      "label",
      -      "impact"
      -    ],
      -    "type": "object"
      -  },
      -  "type": "array"
      -}
    • removedOutput schema / properties / criticalQuestions
      Removed value: -{
      -  "items": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "affects": {
      -        "items": {
      -          "enum": [
      -            "CREATIVE",
      -            "FEASIBILITY",
      -            "COST",
      -            "SCHEDULE",
      -            "RIGHTS",
      -            "DELIVERY"
      -          ],
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "impact": {
      -        "enum": [
      -          "LOW",
      -          "MEDIUM",
      -          "HIGH",
      -          "BLOCKING"
      -        ],
      -        "type": "string"
      -      },
      -      "question": {
      -        "type": "string"
      -      },
      -      "unknownId": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "unknownId",
      -      "question",
      -      "impact",
      -      "affects"
      -    ],
      -    "type": "object"
      -  },
      -  "type": "array"
      -}
    • removedOutput schema / properties / objective
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / pocPlan
      Removed value: -{
      -  "items": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "affectedIds": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "pocId": {
      -        "type": "string"
      -      },
      -      "reason": {
      -        "type": "string"
      -      },
      -      "successCriterion": {
      -        "type": "string"
      -      },
      -      "title": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "pocId",
      -      "title",
      -      "reason",
      -      "successCriterion",
      -      "affectedIds"
      -    ],
      -    "type": "object"
      -  },
      -  "maxItems": 3,
      -  "type": "array"
      -}
    • removedOutput schema / properties / professionalInsights
      Removed value: -{
      -  "items": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "affectedIds": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "code": {
      -        "enum": [
      -          "AUTHORITY_CONFLICT",
      -          "UNBOUND_HARD_LOCK",
      -          "UNSAFE_TRUTH_LAYER",
      -          "ASSET_NOT_PRODUCTION_FIT",
      -          "CONTINUITY_RISK",
      -          "VERSION_CREATES_SCOPE",
      -          "CHANGE_INVALIDATES_WORK",
      -          "READINESS_BLOCKER"
      -        ],
      -        "type": "string"
      -      },
      -      "decision": {
      -        "type": "string"
      -      },
      -      "finding": {
      -        "type": "string"
      -      },
      -      "severity": {
      -        "enum": [
      -          "BLOCKER",
      -          "HIGH",
      -          "MEDIUM"
      -        ],
      -        "type": "string"
      -      },
      -      "title": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "severity",
      -      "code",
      -      "title",
      -      "finding",
      -      "decision",
      -      "affectedIds"
      -    ],
      -    "type": "object"
      -  },
      -  "maxItems": 3,
      -  "type": "array"
      -}
    • removedOutput schema / properties / readiness
      Removed value: -{
      -  "additionalProperties": false,
      -  "properties": {
      -    "blockers": {
      -      "items": {
      -        "type": "string"
      -      },
      -      "type": "array"
      -    },
      -    "overall": {
      -      "enum": [
      -        "IDEA",
      -        "BRIEFABLE",
      -        "ESTIMATABLE",
      -        "QUOTE_READY",
      -        "PRODUCTION_READY"
      -      ],
      -      "type": "string"
      -    }
      -  },
      -  "required": [
      -    "overall",
      -    "blockers"
      -  ],
      -  "type": "object"
      -}
    • addedOutput schema / properties / responseContract
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "allowGenericChecklist": {
      +      "const": false,
      +      "type": "boolean"
      +    },
      +    "maxDecisions": {
      +      "const": 3,
      +      "type": "number"
      +    },
      +    "maxPocs": {
      +      "const": 1,
      +      "type": "number"
      +    },
      +    "maxQuestions": {
      +      "const": 3,
      +      "type": "number"
      +    }
      +  },
      +  "required": [
      +    "maxDecisions",
      +    "maxPocs",
      +    "maxQuestions",
      +    "allowGenericChecklist"
      +  ],
      +  "type": "object"
      +}
    • removedOutput schema / properties / routeChecks
      Removed value: -{
      -  "items": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "elementId": {
      -        "type": "string"
      -      },
      -      "label": {
      -        "type": "string"
      -      },
      -      "reason": {
      -        "type": "string"
      -      },
      -      "recommendedControlMode": {
      -        "enum": [
      -          "DETERMINISTIC",
      -          "REFERENCE_LOCKED",
      -          "GENERATIVE"
      -        ],
      -        "type": "string"
      -      },
      -      "recommendedTruthLayer": {
      -        "enum": [
      -          "LIVE_ACTION",
      -          "CONTROLLED_CGI",
      -          "AI_GENERATED",
      -          "SOURCE_ASSET",
      -          "GRAPHICS",
      -          "COMPOSITE"
      -        ],
      -        "type": "string"
      -      },
      -      "safe": {
      -        "type": "boolean"
      -      }
      -    },
      -    "required": [
      -      "elementId",
      -      "label",
      -      "safe",
      -      "reason"
      -    ],
      -    "type": "object"
      -  },
      -  "type": "array"
      -}
    • removedOutput schema / properties / versions
      Removed value: -{
      -  "items": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "classification": {
      -        "enum": [
      -          "MASTER",
      -          "DERIVED_VERSION",
      -          "RECOMPOSED_VERSION",
      -          "NEW_PRODUCTION_UNIT"
      -        ],
      -        "type": "string"
      -      },
      -      "label": {
      -        "type": "string"
      -      },
      -      "versionId": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "versionId",
      -      "label",
      -      "classification"
      -    ],
      -    "type": "object"
      -  },
      -  "type": "array"
      -}
    • addedOutput schema / properties / visibleVerdict
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "blockingInputs": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "maxItems": 3,
      +      "type": "array"
      +    },
      +    "decisions": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "action": {
      +            "type": "string"
      +          },
      +          "code": {
      +            "enum": [
      +              "AUTHORITY_CONFLICT",
      +              "UNBOUND_HARD_LOCK",
      +              "UNSAFE_TRUTH_LAYER",
      +              "ASSET_NOT_PRODUCTION_FIT",
      +              "CONTINUITY_RISK",
      +              "VERSION_CREATES_SCOPE",
      +              "CHANGE_INVALIDATES_WORK",
      +              "READINESS_BLOCKER"
      +            ],
      +            "type": "string"
      +          },
      +          "finding": {
      +            "type": "string"
      +          },
      +          "severity": {
      +            "enum": [
      +              "BLOCKER",
      +              "HIGH",
      +              "MEDIUM"
      +            ],
      +            "type": "string"
      +          },
      +          "title": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "severity",
      +          "code",
      +          "title",
      +          "finding",
      +          "action"
      +        ],
      +        "type": "object"
      +      },
      +      "maxItems": 3,
      +      "type": "array"
      +    },
      +    "firstPoc": {
      +      "anyOf": [
      +        {
      +          "additionalProperties": false,
      +          "properties": {
      +            "reason": {
      +              "type": "string"
      +            },
      +            "successCriterion": {
      +              "type": "string"
      +            },
      +            "title": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "title",
      +            "reason",
      +            "successCriterion"
      +          ],
      +          "type": "object"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "readiness": {
      +      "enum": [
      +        "IDEA",
      +        "BRIEFABLE",
      +        "ESTIMATABLE",
      +        "QUOTE_READY",
      +        "PRODUCTION_READY"
      +      ],
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "readiness",
      +    "decisions",
      +    "firstPoc",
      +    "blockingInputs"
      +  ],
      +  "type": "object"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "objective",
      -  "authority",
      -  "routeChecks",
      -  "assetFitness",
      -  "versions",
      -  "changes",
      -  "readiness",
      -  "criticalQuestions",
      -  "professionalInsights",
      -  "pocPlan"
      -]New value: +[
      +  "responseContract",
      +  "visibleVerdict"
      +]
  2. Added

TDQS

A4.1/5.0
Behavior4/5

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

Annotations already declare readOnlyHint/idempotentHint/destructiveHint=false, so the safety profile is covered; the description usefully reinforces it by listing the write-like actions it will never perform (estimate price, collect contacts, upload, send externally). The post-call instruction about visibleVerdict is genuinely valuable behavioral context not present in annotations. It stops short of describing what the diagnosis output contains beyond that one field, hence not a 5.

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?

Three sentences, front-loaded with purpose and alternates before the data-entry rule and the output-handling rule. Dense but every clause earns its place; sentence two is long but enumerative rather than padded.

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

Completeness3/5

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

Output schema exists, so return values need not be explained, and annotations cover safety. But for a tool whose input schema is this structurally complex with zero field descriptions, the description omits any account of how to decompose a request into assets/changes/versions/elementRoutes, leaving an agent to guess at the largest part of the calling contract.

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

Parameters2/5

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

Schema description coverage is 0% against an 8-parameter schema with deeply nested objects (assets, changes, versions, elementRoutes, readiness) full of cryptic enums like TRUTH_LAYER, controlMode, and single-letter change flags. The only parameter-level guidance is the generic 'mark unknowns explicitly instead of inventing production facts,' which touches the unknowns array but leaves the other seven parameters' meaning and expected granularity entirely unexplained by both schema and description.

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?

Names a specific engine and scope ('production-diagnosis engine for production-heavy visual work') and enumerates exactly what it checks (reference authority, hard locks, truth-layer routing, asset fitness, continuity, versioning, revision impact, readiness, proof-of-concept). It also explicitly carves out what it is NOT (no price estimation, contact collection, uploads, external sends), which cleanly separates it from estimate_production and submit_production_brief.

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

Usage Guidelines5/5

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

Gives an explicit trigger ('before proposing execution'), a data-hygiene rule ('populate only facts available from the user's current request/files; mark unknowns explicitly instead of inventing production facts'), and post-call guidance ('use visibleVerdict as the complete default answer; do not add a generic checklist unless the user explicitly asks for a broader audit'). That is when-to-use, how-to-use, and when-to-stop all in one.

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.