MVR API - Minimum Viable Relationships

Check evidence before MVR scoring

mvr_decision_check

Read-only

Use after evidence completeness to route a structurally complete pack toward licensed MVR scoring or abstain on missing proof. This public tool does not compute market, pilot, or scale readiness. Use when: Use after evidence completeness to determine whether the pack can be routed to licensed MVR scoring or still requires proof. Do not use when: Do not use as readiness, pilot, credit, legal, regulatory, or scale authorization. Submit only consented, data-minimized, redacted or aggregated evidence; never secrets, credentials, or personal identifiers. Evidence input location: arguments.payload. Full replacement evidence_pack: object array; retain workflow context. String fields: id, claim, evidence_type, source_class, stakeholder_class, verification_status, geography, source_date, source_doc_id. geography: source-country string; evidence_geography: {country,city?,region?}, all strings. source_date: YYYY-MM-DD or ISO timestamp with timezone. Omit unknown dates/references, never null or invented. Unchecked: verification_status: unverified. Keep adverse facts in claim; formatting is not verification.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`payload`	Yes	Decision question, resolved subject, market scope, and evidence for a bounded recommendation or abstention.

Output Schema

TableJSON Schema

Name	Required	Description
`reason`	No
`status`	No
`next_steps`	No
`workflow_id`	No
`claim_review`	No
`evidence_fit`	No
`evidence_gaps`	No
`mcp_next_call`	No
`mcp_next_tool`	No
`not_a_verdict`	No
`response_meta`	No
`source_review`	No
`recommendation`	No
`evidence_intake`	No
`workflow_status`	No
`decision_domains`	No
`safe_next_action`	No
`verification_basis`	No
`workflow_expires_at`	No
`domain_routing_basis`	No	Routing basis, not a verified classification.
`evidence_field_guide`	No	Self-contained public evidence field types and unknown-metadata policy. Formatting guidance, not verification or authority.
`mvr_response_receipt`	No
`required_user_inputs`	No
`evidence_requirements`	No
`evidence_input_feedback`	No
`continuation_disposition`	No
`sandbox_evaluation_scope`	No
`live_mvr_scoring_executed`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedSep 12, 2026

addedOutput schema / properties / evidence_field_guide

Added value: +{
+  "description": "Self-contained public evidence field types and unknown-metadata policy. Formatting guidance, not verification or authority.",
+  "type": "string"
+}

Changed1 schema field changedSep 12, 2026

addedOutput schema / properties / evidence_intake

Added value: +{
+  "properties": {
+    "boundary": {
+      "description": "Intake format is not evidence assessment.",
+      "type": "string"
+    },
+    "content_assessment_performed": {
+      "type": "boolean"
+    },
+    "contract_version": {
+      "description": "Intake disclosure version.",
+      "type": "string"
+    },
+    "evidence_count_semantics": {
+      "description": "Counts submitted entries, not underlying records or verified sources.",
+      "type": "string"
+    },
+    "source_authenticity_verified": {
+      "type": "boolean"
+    },
+    "status": {
+      "enum": [
+        "invalid_submission",
+        "described_not_structured",
+        "no_evidence_supplied",
+        "structured_items_supplied",
+        "mixed_descriptions_and_structured_items"
+      ],
+      "type": "string"
+    },
+    "structured_item_count": {
+      "type": "integer"
+    },
+    "underlying_records_checked": {
+      "type": "boolean"
+    },
+    "unstructured_description_count": {
+      "type": "integer"
+    }
+  },
+  "type": "object"
+}

Changed4 schema fields changedSep 7, 2026

addedOutput schema / properties / claim_review / properties / content_item_count
```
Added value: +{
+  "type": "integer"
+}
```

addedOutput schema / properties / claim_review / properties / linkage_gaps

Added value: +{
+  "items": {
+    "properties": {
+      "blocking": {
+        "type": "boolean"
+      },
+      "code": {
+        "description": "Stable correction code.",
+        "type": "string"
+      },
+      "message": {
+        "description": "Correction without echoing source content.",
+        "type": "string"
+      },
+      "path": {
+        "description": "Indexed submitted payload path.",
+        "type": "string"
+      },
+      "severity": {
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / claim_review / properties / linkage_gaps_truncated
```
Added value: +{
+  "type": "boolean"
+}
```
addedOutput schema / properties / claim_review / properties / unlinked_evidence_count
```
Added value: +{
+  "type": "integer"
+}
```

Changed8 schema fields changedSep 7, 2026

addedInput schema / properties / payload / properties / claims

Added value: +{
+  "description": "Optional explicit target claims and source-specific support links. Reuses the governed claim-audit vocabulary. Public links are caller declarations, never authenticated reviewer attestations.",
+  "items": {
+    "properties": {
+      "claim": {
+        "description": "Minimal public-safe target proposition.",
+        "type": "string"
+      },
+      "claim_id": {
+        "description": "Opaque claim identifier.",
+        "type": "string"
+      },
+      "support_links": {
+        "items": {
+          "properties": {
+            "claim_id": {
+              "description": "Must match the containing claim.",
+              "type": "string"
+            },
+            "evidence_id": {
+              "description": "Must identify an item in this complete evidence pack.",
+              "type": "string"
+            },
+            "locator": {
+              "description": "Specific page, cell or section. A locator is not proof.",
+              "type": "string"
+            },
+            "relationship": {
+              "enum": [
+                "direct_support",
+                "qualifies",
+                "contradicts",
+                "context_only"
+              ],
+              "type": "string"
+            },
+            "review_event_id": {
+              "description": "Only the licensed review service can check this event; ignored as authority by public preflight.",
+              "type": "string"
+            }
+          },
+          "required": [
+            "claim_id",
+            "evidence_id",
+            "relationship",
+            "locator"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "claim_id",
+      "claim"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / claim_review

Added value: +{
+  "properties": {
+    "blocking": {
+      "type": "boolean"
+    },
+    "boundary": {
+      "type": "string"
+    },
+    "claim_count": {
+      "type": "integer"
+    },
+    "content_assessment_performed": {
+      "type": "boolean"
+    },
+    "declared_contradiction_count": {
+      "type": "integer"
+    },
+    "declared_qualification_count": {
+      "type": "integer"
+    },
+    "issues": {
+      "items": {
+        "properties": {
+          "blocking": {
+            "type": "boolean"
+          },
+          "code": {
+            "description": "Stable correction code.",
+            "type": "string"
+          },
+          "message": {
+            "description": "Correction without echoing source content.",
+            "type": "string"
+          },
+          "path": {
+            "description": "Indexed submitted payload path.",
+            "type": "string"
+          },
+          "severity": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "links": {
+      "items": {
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "source_authenticity_verified": {
+      "type": "boolean"
+    },
+    "status": {
+      "type": "string"
+    },
+    "unlinked_claim_count": {
+      "type": "integer"
+    }
+  },
+  "type": "object"
+}

addedOutput schema / properties / decision_domains

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / domain_routing_basis

Added value: +{
+  "description": "Routing basis, not a verified classification.",
+  "type": "string"
+}

addedOutput schema / properties / evidence_fit

Added value: +{
+  "properties": {
+    "analysis_date": {
+      "type": "string"
+    },
+    "analysis_timezone": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "blocking": {
+      "type": "boolean"
+    },
+    "coverage_exclusion_count": {
+      "type": "integer"
+    },
+    "issues": {
+      "items": {
+        "properties": {
+          "blocking": {
+            "type": "boolean"
+          },
+          "code": {
+            "description": "Stable correction code.",
+            "type": "string"
+          },
+          "message": {
+            "description": "Correction without echoing source content.",
+            "type": "string"
+          },
+          "path": {
+            "description": "Indexed submitted payload path.",
+            "type": "string"
+          },
+          "severity": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "source_authenticity_verified": {
+      "type": "boolean"
+    }
+  },
+  "type": "object"
+}

addedOutput schema / properties / evidence_input_feedback

Added value: +{
+  "properties": {
+    "contract_version": {
+      "description": "Feedback version.",
+      "type": "string"
+    },
+    "error_count": {
+      "type": "integer"
+    },
+    "issues": {
+      "items": {
+        "properties": {
+          "blocking": {
+            "type": "boolean"
+          },
+          "code": {
+            "description": "Stable correction code.",
+            "type": "string"
+          },
+          "message": {
+            "description": "Correction without echoing source content.",
+            "type": "string"
+          },
+          "path": {
+            "description": "Indexed submitted payload path.",
+            "type": "string"
+          },
+          "severity": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "issues_truncated": {
+      "type": "boolean"
+    },
+    "warning_count": {
+      "type": "integer"
+    }
+  },
+  "type": "object"
+}

addedOutput schema / properties / evidence_requirements

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / source_review

Added value: +{
+  "properties": {
+    "evidence_strength": {
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "required_before_consequential_reliance": {
+      "type": "boolean"
+    },
+    "status": {
+      "type": "string"
+    },
+    "tasks": {
+      "items": {
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "type": "object"
+}

Changed6 schema fields changedSep 6, 2026

changedInput schema / properties / payload / properties / analysis_date / description

Previous value: -"Optional YYYY-MM-DD or ISO timestamp with timezone, no later than today; defaults to the server UTC date. Carried through the public handoff."New value: +"Optional YYYY-MM-DD or ISO timestamp with timezone, no later than today in analysis_timezone (UTC by default). Defaults to the current date in that calendar. Carried through the public handoff."

addedInput schema / properties / payload / properties / analysis_timezone

Added value: +{
+  "description": "Optional IANA timezone, for example Africa/Nairobi, for the analysis calendar. Defaults to UTC; never inferred from country or IP. Date-only values keep their declared calendar day.",
+  "type": "string"
+}

changed

Input schema / properties / payload / properties / evidence_items / items / properties / provenance_ledger / properties / source_locator / description

Previous value: -"Redacted, reviewable document locator. Shared references count together."New value: +"Redacted document-specific locator, not the shared folder holding unrelated documents. Never invent a locator. Genuine shared upstream references count together."

changedInput schema / properties / payload / properties / evidence_items / items / properties / source_locator / description

Previous value: -"Redacted, reviewable document locator. Shared references count together."New value: +"Redacted document-specific locator, not the shared folder holding unrelated documents. Never invent a locator. Genuine shared upstream references count together."

changed

Input schema / properties / payload / properties / evidence_pack / items / properties / provenance_ledger / properties / source_locator / description

Previous value: -"Redacted, reviewable document locator. Shared references count together."New value: +"Redacted document-specific locator, not the shared folder holding unrelated documents. Never invent a locator. Genuine shared upstream references count together."

changedInput schema / properties / payload / properties / evidence_pack / items / properties / source_locator / description

Previous value: -"Redacted, reviewable document locator. Shared references count together."New value: +"Redacted document-specific locator, not the shared folder holding unrelated documents. Never invent a locator. Genuine shared upstream references count together."

Changed11 schema fields changedSep 6, 2026

addedInput schema / properties / payload / properties / analysis_date

Added value: +{
+  "description": "Optional YYYY-MM-DD or ISO timestamp with timezone, no later than today; defaults to the server UTC date. Carried through the public handoff.",
+  "type": "string"
+}

addedInput schema / properties / payload / properties / context_freshness_window_days

Added value: +{
+  "description": "Optional caller-declared maximum evidence age in days. No universal freshness cutoff is invented when absent; age alone does not prove validity.",
+  "minimum": 1,
+  "type": "integer"
+}

changedInput schema / properties / payload / properties / evidence_available / description

Previous value: -"Optional context labels, not structured evidence and never counted as proof. Use evidence_pack for items."New value: +"Short optional context labels, not proof. For supplied document summaries use incomplete evidence_pack items instead; do not mark claims verified merely because a document exists."

addedInput schema / properties / payload / properties / evidence_items / items / properties / evidence_geography

Added value: +{
+  "additionalProperties": true,
+  "properties": {
+    "city": {
+      "description": "Declared source city.",
+      "type": "string"
+    },
+    "country": {
+      "description": "Declared source country, not the target country.",
+      "type": "string"
+    },
+    "region": {
+      "description": "Declared source region.",
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

addedInput schema / properties / payload / properties / evidence_items / items / properties / freshness_date

Added value: +{
+  "description": "Compatibility alias for source_date; conflicting supplied dates require correction.",
+  "type": "string"
+}

changedInput schema / properties / payload / properties / evidence_items / items / properties / geography / description

Previous value: -"Geography represented by this source. Public preflight does not verify geographic relevance."New value: +"Source country name/code or broader geographic description. Known country conflicts are flagged; local applicability is not authenticated."

changedInput schema / properties / payload / properties / evidence_items / items / properties / source_date / description

Previous value: -"Source date, preferably YYYY-MM-DD. Public preflight does not assess freshness or date validity."New value: +"Declared source date, YYYY-MM-DD or ISO timestamp with timezone. Date validity and age can be checked; the source and current applicability remain unverified."

addedInput schema / properties / payload / properties / evidence_pack / items / properties / evidence_geography

Added value: +{
+  "additionalProperties": true,
+  "properties": {
+    "city": {
+      "description": "Declared source city.",
+      "type": "string"
+    },
+    "country": {
+      "description": "Declared source country, not the target country.",
+      "type": "string"
+    },
+    "region": {
+      "description": "Declared source region.",
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

addedInput schema / properties / payload / properties / evidence_pack / items / properties / freshness_date

Added value: +{
+  "description": "Compatibility alias for source_date; conflicting supplied dates require correction.",
+  "type": "string"
+}

changedInput schema / properties / payload / properties / evidence_pack / items / properties / geography / description

Previous value: -"Geography represented by this source. Public preflight does not verify geographic relevance."New value: +"Source country name/code or broader geographic description. Known country conflicts are flagged; local applicability is not authenticated."

changedInput schema / properties / payload / properties / evidence_pack / items / properties / source_date / description

Previous value: -"Source date, preferably YYYY-MM-DD. Public preflight does not assess freshness or date validity."New value: +"Declared source date, YYYY-MM-DD or ISO timestamp with timezone. Date validity and age can be checked; the source and current applicability remain unverified."

Changed34 schema fields changedSep 6, 2026

addedInput schema / properties / payload / properties / evidence_available

Added value: +{
+  "description": "Optional context labels, not structured evidence and never counted as proof. Use evidence_pack for items.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

changedInput schema / properties / payload / properties / evidence_items / description

Previous value: -"Alias for evidence_pack when the host already uses this field name."New value: +"Alias for evidence_pack. Supply one field, not conflicting copies."

addedInput schema / properties / payload / properties / evidence_items / items / description

Added value: +"A caller-declared, consented and redacted evidence item. No required fields at intake: incomplete items receive correction feedback. Passing coverage never verifies truth, permission or readiness."

addedInput schema / properties / payload / properties / evidence_items / items / properties

Added value: +{
+  "claim": {
+    "description": "Minimal, non-confidential claim supported by the item; do not send raw private interviews.",
+    "type": "string"
+  },
+  "evidence_origin": {
+    "description": "Alias for source_class. Source-class precedence: source_class, evidence_origin, source_family, then evidence_type.",
+    "type": "string"
+  },
+  "evidence_type": {
+    "description": "What was collected, for example interview, field observation or licence record. Not merely the conclusion.",
+    "type": "string"
+  },
+  "geography": {
+    "description": "Geography represented by this source. Public preflight does not verify geographic relevance.",
+    "type": "string"
+  },
+  "id": {
+    "description": "Optional item identifier. Does not establish a distinct source.",
+    "type": "string"
+  },
+  "is_load_bearing": {
+    "description": "Compatibility alias for load_bearing.",
+    "type": "boolean"
+  },
+  "load_bearing": {
+    "description": "True if the target recommendation materially depends on this item.",
+    "type": "boolean"
+  },
+  "parent_source_ids": {
+    "items": {
+      "type": "string"
+    },
+    "type": "array"
+  },
+  "provenance_ledger": {
+    "additionalProperties": true,
+    "properties": {
+      "parent_source_ids": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "source_doc_id": {
+        "description": "Opaque source-document reference, not an evidence-item ID or personal identifier.",
+        "type": "string"
+      },
+      "source_locator": {
+        "description": "Redacted, reviewable document locator. Shared references count together.",
+        "type": "string"
+      },
+      "source_url": {
+        "description": "Source reference only; the sandbox does not fetch or authenticate it.",
+        "type": "string"
+      },
+      "synthetic_fields": {
+        "description": "Source-reference fields that were generated rather than observed; these do not establish lineage.",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "upstream_source_ids": {
+        "description": "Disclose shared upstream sources; distinct identifiers do not prove independence.",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "type": "object"
+  },
+  "source_class": {
+    "description": "Origin label, for example entity_reported, regulator_published, structured_field_research, operational_data or counterparty_reference. Not a claim of independence.",
+    "type": "string"
+  },
+  "source_date": {
+    "description": "Source date, preferably YYYY-MM-DD. Public preflight does not assess freshness or date validity.",
+    "type": "string"
+  },
+  "source_doc_id": {
+    "description": "Opaque source-document reference, not an evidence-item ID or personal identifier.",
+    "type": "string"
+  },
+  "source_family": {
+    "description": "Compatibility origin label; source_class takes precedence.",
+    "type": "string"
+  },
+  "source_grade": {
+    "description": "Caller-supplied grade. Not a substitute for verification or source lineage.",
+    "type": "string"
+  },
+  "source_hash": {
+    "description": "Optional SHA-256 source hash, 64 hexadecimal characters; a hash does not authenticate its origin.",
+    "type": "string"
+  },
+  "source_locator": {
+    "description": "Redacted, reviewable document locator. Shared references count together.",
+    "type": "string"
+  },
+  "source_url": {
+    "description": "Source reference only; the sandbox does not fetch or authenticate it.",
+    "type": "string"
+  },
+  "stakeholder_class": {
+    "description": "Role represented, for example guardian, customer, supplier or partner. Do not submit a person identifier.",
+    "type": "string"
+  },
+  "status": {
+    "description": "Legacy alias for verification_status.",
+    "type": "string"
+  },
+  "upstream_source_ids": {
+    "description": "Disclose shared upstream sources; distinct identifiers do not prove independence.",
+    "items": {
+      "type": "string"
+    },
+    "type": "array"
+  },
+  "verification_status": {
+    "description": "Caller label. verified, independently_verified, corroborated, attested, confirmed and validated count for the structural prefilter only. self_attested, unverified, missing and other labels do not. Do not change labels without actually checking the source.",
+    "type": "string"
+  }
+}

changedInput schema / properties / payload / properties / evidence_pack / description

Previous value: -"Evidence items supporting or challenging the target claim."New value: +"Full current evidence pack. Rechecks replace the pack; the server does not append or retrieve evidence."

addedInput schema / properties / payload / properties / evidence_pack / items / description

Added value: +"A caller-declared, consented and redacted evidence item. No required fields at intake: incomplete items receive correction feedback. Passing coverage never verifies truth, permission or readiness."

addedInput schema / properties / payload / properties / evidence_pack / items / properties / claim / description
```
Added value: +"Minimal, non-confidential claim supported by the item; do not send raw private interviews."
```

changedInput schema / properties / payload / properties / evidence_pack / items / properties / evidence_origin / description

Previous value: -"Alias for source_class."New value: +"Alias for source_class. Source-class precedence: source_class, evidence_origin, source_family, then evidence_type."

addedInput schema / properties / payload / properties / evidence_pack / items / properties / evidence_type / description

Added value: +"What was collected, for example interview, field observation or licence record. Not merely the conclusion."

addedInput schema / properties / payload / properties / evidence_pack / items / properties / geography

Added value: +{
+  "description": "Geography represented by this source. Public preflight does not verify geographic relevance.",
+  "type": "string"
+}

addedInput schema / properties / payload / properties / evidence_pack / items / properties / id / description
```
Added value: +"Optional item identifier. Does not establish a distinct source."
```
addedInput schema / properties / payload / properties / evidence_pack / items / properties / is_load_bearing
```
Added value: +{
+  "description": "Compatibility alias for load_bearing.",
+  "type": "boolean"
+}
```
addedInput schema / properties / payload / properties / evidence_pack / items / properties / load_bearing / description
```
Added value: +"True if the target recommendation materially depends on this item."
```
addedInput schema / properties / payload / properties / evidence_pack / items / properties / parent_source_ids
```
Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}
```
addedInput schema / properties / payload / properties / evidence_pack / items / properties / provenance_ledger / properties / parent_source_ids
```
Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}
```
addedInput schema / properties / payload / properties / evidence_pack / items / properties / provenance_ledger / properties / source_doc_id / description
```
Added value: +"Opaque source-document reference, not an evidence-item ID or personal identifier."
```
addedInput schema / properties / payload / properties / evidence_pack / items / properties / provenance_ledger / properties / source_locator / description
```
Added value: +"Redacted, reviewable document locator. Shared references count together."
```
addedInput schema / properties / payload / properties / evidence_pack / items / properties / provenance_ledger / properties / source_url / description
```
Added value: +"Source reference only; the sandbox does not fetch or authenticate it."
```

added

Input schema / properties / payload / properties / evidence_pack / items / properties / provenance_ledger / properties / synthetic_fields

Added value: +{
+  "description": "Source-reference fields that were generated rather than observed; these do not establish lineage.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedInput schema / properties / payload / properties / evidence_pack / items / properties / provenance_ledger / properties / upstream_source_ids / description
```
Added value: +"Disclose shared upstream sources; distinct identifiers do not prove independence."
```

changedInput schema / properties / payload / properties / evidence_pack / items / properties / source_class / description

Previous value: -"Evidence origin family."New value: +"Origin label, for example entity_reported, regulator_published, structured_field_research, operational_data or counterparty_reference. Not a claim of independence."

addedInput schema / properties / payload / properties / evidence_pack / items / properties / source_date / description
```
Added value: +"Source date, preferably YYYY-MM-DD. Public preflight does not assess freshness or date validity."
```
addedInput schema / properties / payload / properties / evidence_pack / items / properties / source_doc_id / description
```
Added value: +"Opaque source-document reference, not an evidence-item ID or personal identifier."
```

addedInput schema / properties / payload / properties / evidence_pack / items / properties / source_family

Added value: +{
+  "description": "Compatibility origin label; source_class takes precedence.",
+  "type": "string"
+}

addedInput schema / properties / payload / properties / evidence_pack / items / properties / source_grade / description
```
Added value: +"Caller-supplied grade. Not a substitute for verification or source lineage."
```

addedInput schema / properties / payload / properties / evidence_pack / items / properties / source_hash

Added value: +{
+  "description": "Optional SHA-256 source hash, 64 hexadecimal characters; a hash does not authenticate its origin.",
+  "type": "string"
+}

addedInput schema / properties / payload / properties / evidence_pack / items / properties / source_locator

Added value: +{
+  "description": "Redacted, reviewable document locator. Shared references count together.",
+  "type": "string"
+}

changedInput schema / properties / payload / properties / evidence_pack / items / properties / source_url / description

Previous value: -"Source document reference. Shared references count together; a distinct URL does not prove source truth or independence."New value: +"Source reference only; the sandbox does not fetch or authenticate it."

addedInput schema / properties / payload / properties / evidence_pack / items / properties / stakeholder_class / description

Added value: +"Role represented, for example guardian, customer, supplier or partner. Do not submit a person identifier."

addedInput schema / properties / payload / properties / evidence_pack / items / properties / status

Added value: +{
+  "description": "Legacy alias for verification_status.",
+  "type": "string"
+}

addedInput schema / properties / payload / properties / evidence_pack / items / properties / upstream_source_ids

Added value: +{
+  "description": "Disclose shared upstream sources; distinct identifiers do not prove independence.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

added

Input schema / properties / payload / properties / evidence_pack / items / properties / verification_status / description

Added value: +"Caller label. verified, independently_verified, corroborated, attested, confirmed and validated count for the structural prefilter only. self_attested, unverified, missing and other labels do not. Do not change labels without actually checking the source."

removedInput schema / properties / payload / properties / evidence_pack / items / properties / verification_status / enum

Removed value: -[
-  "unverified",
-  "verified",
-  "independently_verified",
-  "corroborated",
-  "attested",
-  "confirmed",
-  "validated"
-]

addedInput schema / properties / payload / properties / stage

Added value: +{
+  "description": "Free-text venture stage, for example pre-MVP, pilot, grant-funded programme or scaling. No closed enum.",
+  "type": "string"
+}

Changed3 schema fields changedSep 6, 2026

addedInput schema / properties / payload / properties / evidence_pack / items / properties / provenance_ledger

Added value: +{
+  "additionalProperties": true,
+  "properties": {
+    "source_doc_id": {
+      "type": "string"
+    },
+    "source_locator": {
+      "type": "string"
+    },
+    "source_url": {
+      "type": "string"
+    },
+    "upstream_source_ids": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    }
+  },
+  "type": "object"
+}

addedInput schema / properties / payload / properties / evidence_pack / items / properties / source_doc_id
```
Added value: +{
+  "type": "string"
+}
```

addedInput schema / properties / payload / properties / evidence_pack / items / properties / source_url / description

Added value: +"Source document reference. Shared references count together; a distinct URL does not prove source truth or independence."

Changed1 schema field changedSep 5, 2026

addedOutput schema / properties / next_steps

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "automatic_action_authorized": {
+      "const": false,
+      "type": "boolean"
+    },
+    "boundary": {
+      "type": "string"
+    },
+    "offer_registry": {
+      "format": "uri",
+      "type": "string"
+    },
+    "options": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "label": {
+            "type": "string"
+          },
+          "url": {
+            "format": "uri",
+            "type": "string"
+          },
+          "when_to_use": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "label",
+          "url",
+          "when_to_use"
+        ],
+        "type": "object"
+      },
+      "maxItems": 3,
+      "type": "array"
+    },
+    "purpose": {
+      "const": "optional_routing_not_recommendation",
+      "type": "string"
+    },
+    "schema_version": {
+      "const": "mvr-optional-routing@1.0",
+      "type": "string"
+    }
+  },
+  "required": [
+    "schema_version",
+    "purpose",
+    "automatic_action_authorized",
+    "boundary",
+    "offer_registry",
+    "options"
+  ],
+  "type": "object"
+}

Changed7 schema fields changedAug 11, 2026

addedOutput schema / properties / continuation_disposition

Added value: +{
+  "enum": [
+    "call_now",
+    "await_input",
+    "terminal"
+  ],
+  "type": "string"
+}

addedOutput schema / properties / mcp_next_call

Added value: +{
+  "anyOf": [
+    {
+      "type": "null"
+    },
+    {
+      "additionalProperties": false,
+      "properties": {
+        "arguments": {
+          "additionalProperties": false,
+          "properties": {
+            "payload": {
+              "additionalProperties": true,
+              "type": "object"
+            }
+          },
+          "required": [
+            "payload"
+          ],
+          "type": "object"
+        },
+        "name": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "name",
+        "arguments"
+      ],
+      "type": "object"
+    }
+  ]
+}

addedOutput schema / properties / mcp_next_tool

Added value: +{
+  "anyOf": [
+    {
+      "type": "null"
+    },
+    {
+      "additionalProperties": false,
+      "properties": {
+        "arguments": {
+          "additionalProperties": false,
+          "properties": {
+            "payload": {
+              "additionalProperties": true,
+              "type": "object"
+            }
+          },
+          "required": [
+            "payload"
+          ],
+          "type": "object"
+        },
+        "tool_name": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "tool_name",
+        "arguments"
+      ],
+      "type": "object"
+    }
+  ]
+}

addedOutput schema / properties / required_user_inputs

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / workflow_expires_at

Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / workflow_id

Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / workflow_status
```
Added value: +{
+  "type": "string"
+}
```

Changed2 schema fields changedJul 29, 2026

addedOutput schema / properties / mvr_response_receipt / properties / mcp_protocol_versions
```
Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}
```

changedOutput schema / properties / mvr_response_receipt / required

Previous value: -[
-  "receipt_schema_version",
-  "mcp_tool",
-  "core_api_version",
-  "mcp_contract_version",
-  "tool_profile_version",
-  "sdk_version",
-  "policy_version",
-  "calibration_version",
-  "deployment_revision",
-  "host_recipe_version",
-  "authority_boundary"
-]New value: +[
+  "receipt_schema_version",
+  "mcp_tool",
+  "core_api_version",
+  "mcp_protocol_versions",
+  "mcp_contract_version",
+  "tool_profile_version",
+  "sdk_version",
+  "policy_version",
+  "calibration_version",
+  "deployment_revision",
+  "host_recipe_version",
+  "authority_boundary"
+]

Changed1 schema field changedJul 27, 2026

addedOutput schema / properties / mvr_response_receipt

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "authority_boundary": {
+      "type": "string"
+    },
+    "calibration_version": {
+      "type": "string"
+    },
+    "core_api_version": {
+      "type": "string"
+    },
+    "deployment_revision": {
+      "type": "string"
+    },
+    "host_recipe_version": {
+      "type": "string"
+    },
+    "mcp_contract_version": {
+      "type": "string"
+    },
+    "mcp_tool": {
+      "type": "string"
+    },
+    "policy_version": {
+      "type": "string"
+    },
+    "receipt_schema_version": {
+      "type": "string"
+    },
+    "sdk_version": {
+      "type": "string"
+    },
+    "tool_profile_version": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "receipt_schema_version",
+    "mcp_tool",
+    "core_api_version",
+    "mcp_contract_version",
+    "tool_profile_version",
+    "sdk_version",
+    "policy_version",
+    "calibration_version",
+    "deployment_revision",
+    "host_recipe_version",
+    "authority_boundary"
+  ],
+  "type": "object"
+}

Changed4 schema fields changedJul 15, 2026
- addedOutput schema / properties / live_mvr_scoring_executed
```
Added value: +{
+  "type": "boolean"
+}
```
- addedOutput schema / properties / not_a_verdict
```
Added value: +{
+  "type": "boolean"
+}
```
- addedOutput schema / properties / sandbox_evaluation_scope
```
Added value: +{
+  "type": "object"
+}
```
- addedOutput schema / properties / verification_basis
```
Added value: +{
+  "type": "string"
+}
```
Changed4 schema fields changedJul 12, 2026
- addedInput schema / properties / payload / properties / evidence_pack / items / properties / evidence_origin
```
Added value: +{
+  "description": "Alias for source_class.",
+  "type": "string"
+}
```
- addedInput schema / properties / payload / properties / evidence_pack / items / properties / load_bearing
```
Added value: +{
+  "type": "boolean"
+}
```
- addedInput schema / properties / payload / properties / evidence_pack / items / properties / source_class
```
Added value: +{
+  "description": "Evidence origin family.",
+  "type": "string"
+}
```
- addedInput schema / properties / payload / properties / evidence_pack / items / properties / verification_status / enum
```
Added value: +[
+  "unverified",
+  "verified",
+  "independently_verified",
+  "corroborated",
+  "attested",
+  "confirmed",
+  "validated"
+]
```

Changed2 schema fields changedJul 12, 2026

changedInput schema / properties / payload / description

Previous value: -"Decision-check request body."New value: +"Decision question, resolved subject, market scope, and evidence for a bounded recommendation or abstention."

addedInput schema / properties / payload / properties

Added value: +{
+  "decision_stage": {
+    "description": "Idea, pre-entry, pilot, launch, expansion, or scale stage.",
+    "type": "string"
+  },
+  "evidence_items": {
+    "description": "Alias for evidence_pack when the host already uses this field name.",
+    "items": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "type": "array"
+  },
+  "evidence_pack": {
+    "description": "Evidence items supporting or challenging the target claim.",
+    "items": {
+      "additionalProperties": true,
+      "properties": {
+        "claim": {
+          "type": "string"
+        },
+        "evidence_type": {
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "source_date": {
+          "type": "string"
+        },
+        "source_grade": {
+          "type": "string"
+        },
+        "source_url": {
+          "type": "string"
+        },
+        "stakeholder_class": {
+          "type": "string"
+        },
+        "verification_status": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "type": "array"
+  },
+  "market_scope": {
+    "additionalProperties": true,
+    "description": "Geography for the proposed decision.",
+    "properties": {
+      "city": {
+        "type": "string"
+      },
+      "corridor": {
+        "type": "string"
+      },
+      "country": {
+        "type": "string"
+      },
+      "region": {
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "subject": {
+    "additionalProperties": true,
+    "description": "Resolved or supplied entity under assessment.",
+    "properties": {
+      "entity_archetype": {
+        "type": "string"
+      },
+      "entity_name": {
+        "type": "string"
+      },
+      "sector": {
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "target_claim": {
+    "description": "Exact claim or readiness question to authorize, limit, or abstain on.",
+    "type": "string"
+  },
+  "target_use": {
+    "description": "Internal planning, pilot design, customer-facing, investor-facing, or rollout use.",
+    "type": "string"
+  }
+}

Changed1 schema field changedJul 11, 2026
- removedInput schema / properties / api_key
```
Removed value: -{
-  "type": "string"
-}
```

Changed1 schema field changedMay 27, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "properties": {
+    "evidence_gaps": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "reason": {
+      "type": "string"
+    },
+    "recommendation": {
+      "type": "string"
+    },
+    "response_meta": {
+      "type": "object"
+    },
+    "safe_next_action": {
+      "type": "string"
+    },
+    "status": {
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

First observedMay 24, 2026

TDQS

A3.9/5.0

Behavior4/5

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

Annotations already establish readOnlyHint=true, destructiveHint=false and a closed-world sandbox, so the safety profile is covered. The description adds real context beyond that: it is a preflight gate that never verifies truth, permission or readiness, it carries strict data-handling constraints (consented, data-minimized, redacted; no secrets, credentials or personal identifiers), and evidence_pack is a full replacement. This meaningfully exceeds the annotation bar.

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

Conciseness3/5

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

Labeled sections (Use when / Do not use when / Evidence input location) give useful structure, but the opening sentence and the 'Use when' block restate the same routing rule almost verbatim, and the run-on formatting instructions bloat the text. Two sentences do the work of one.

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?

An output schema exists, so return values need not be explained. The description covers the gating semantics, privacy constraints, replacement behavior, accepted date/geography formats and abstention posture, leaving little an agent needs that is missing. It does not clarify what 'licensed MVR scoring' entails or how abstention is signalled.

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 description coverage is 100%, so the baseline is 3, but the description adds operational rules the schema does not: evidence lives at arguments.payload, evidence_pack is a full replacement (not append/retrieve), unknown dates/references must be omitted rather than nulled or invented, and unverified is the default verification_status. Field-name enumeration largely duplicates the schema.

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

Purpose4/5

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

States a concrete verb and resource: route a structurally complete evidence pack toward licensed MVR scoring, or abstain on missing proof, and explicitly disclaims computing market/pilot/scale readiness. It is distinguishable from mvr_evidence_completeness by its 'use after' positioning. The undefined acronym 'MVR' and jargon keep it from a 5, but the action is discernible.

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?

Explicit 'Use when' / 'Do not use when' blocks name the prerequisite step (evidence completeness) and enumerate clear exclusions (not readiness, pilot, credit, legal, regulatory, or scale authorization). Alternatives are referenced by workflow stage rather than by sibling tool name, so routing is implied rather than named.

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

All MVR API - Minimum Viable Relationships tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.