MVR API - Minimum Viable Relationships

Check evidence completeness

mvr_evidence_completeness

Read-only

Use after entity resolution and before any readiness claim to check verification status, source-family diversity, stakeholder coverage, and missing proof. Do not treat completeness as authorization. Use when: Use after entity resolution and before any verdict when evidence may be incomplete or one-sided. Do not use when: Do not treat completeness as readiness or authorization. Submit only consented, data-minimized, redacted or aggregated evidence; never raw private interviews, 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	Evidence pack and decision context to test for missing proof.

Output Schema

TableJSON Schema

Name	Required	Description
`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
`response_meta`	No
`source_review`	No
`evidence_count`	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
`stakeholder_coverage`	No
`evidence_requirements`	No
`evidence_input_feedback`	No
`verified_evidence_count`	No
`continuation_disposition`	No
`verified_source_families`	No
`unverified_evidence_count`	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 available for the decision."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 when the host uses evidence-origin terminology."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"
+}
```

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

Previous value: -"True when this item materially supports the target recommendation."New 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: -"Origin family, for example entity_reported, structured_field_research, regulator_published, or counterparty_reference."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"
+}

Changed1 schema field changedJul 15, 2026
- addedOutput schema / properties / verification_basis
```
Added value: +{
+  "type": "string"
+}
```

Changed7 schema fields changedJul 12, 2026

addedInput schema / properties / payload / properties / evidence_pack / items / properties / evidence_origin

Added value: +{
+  "description": "Alias for source_class when the host uses evidence-origin terminology.",
+  "type": "string"
+}

addedInput schema / properties / payload / properties / evidence_pack / items / properties / load_bearing

Added value: +{
+  "description": "True when this item materially supports the target recommendation.",
+  "type": "boolean"
+}

addedInput schema / properties / payload / properties / evidence_pack / items / properties / source_class

Added value: +{
+  "description": "Origin family, for example entity_reported, structured_field_research, regulator_published, or counterparty_reference.",
+  "type": "string"
+}

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

Added value: +[
+  "unverified",
+  "verified",
+  "independently_verified",
+  "corroborated",
+  "attested",
+  "confirmed",
+  "validated"
+]

addedOutput schema / properties / unverified_evidence_count
```
Added value: +{
+  "type": "number"
+}
```
addedOutput schema / properties / verified_evidence_count
```
Added value: +{
+  "type": "number"
+}
```

addedOutput schema / properties / verified_source_families

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

Changed2 schema fields changedJul 12, 2026

changedInput schema / properties / payload / description

Previous value: -"Evidence-completeness request body."New value: +"Evidence pack and decision context to test for missing proof."

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 available for the decision.",
+    "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 in which the evidence must be valid.",
+    "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": "Claim or readiness question the evidence is meant to support.",
+    "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_count": {
+      "type": "number"
+    },
+    "evidence_gaps": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "response_meta": {
+      "type": "object"
+    },
+    "safe_next_action": {
+      "type": "string"
+    },
+    "stakeholder_coverage": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "status": {
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

First observedMay 24, 2026

TDQS

A4.5/5.0

Behavior5/5

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

Beyond the readOnly, non-destructive annotations, the description discloses important behavioral constraints: only consented, data-minimized, redacted/aggregated evidence may be submitted; raw interviews, secrets, credentials, and personal identifiers are prohibited. It also warns that completeness is not authorization and that formatting is not verification, adding substantial context beyond structured fields.

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?

The description is front-loaded with purpose and workflow, but it repeats key points: 'Do not treat completeness as authorization/readiness' is stated multiple times, and the labeled 'Use when' section largely restates the opening sentence. It is organized but unnecessarily verbose.

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

Completeness5/5

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

Given the nested evidence-pack schema, the high schema coverage, and the presence of an output schema, the description supplies what an agent needs: purpose, workflow position, privacy constraints, replacement semantics, and key field-handling cautions. Return values are covered by the output schema, so the definition is complete enough for correct invocation.

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 the schema already documents most parameters. The description adds some value by specifying that evidence goes in arguments.payload, that evidence_pack is a full replacement array rather than an append, and by reinforcing rules like omitting unknown dates/references rather than sending nulls or invented values.

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 uses a specific verb ('check') and enumerates the exact dimensions checked: verification status, source-family diversity, stakeholder coverage, and missing proof. It also places the tool in the workflow ('after entity resolution and before any readiness claim'), which distinguishes it from siblings like mvr_entity_resolve and mvr_decision_check.

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 when-to-use guidance: after entity resolution and before any verdict when evidence may be incomplete or one-sided. The 'Do not use when' section is not a true exclusion condition but a caution against treating completeness as authorization, and no explicit alternatives are 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.