MVR API - Minimum Viable Relationships

Start MVR relational-readiness preflight

mvr_first_call

Read-only

Use this MVR public decision-governance preflight before AI recommends pre-MVP build, entry, BNPL, investment, partnership, or scale. Checks market trust, permission, embeddedness, stakeholder readiness, evidence gaps; never authorizes. Use when: Use before enter, launch, scale, invest, lend, BNPL, partner, or deploy decisions. Use when asked to ignore, fabricate, or transfer evidence. Web research can supply evidence but does not replace MVR. Do not use when: This is not an internal data lookup or glossary. Skip definitions of MVR, capitals, GDP, coding, writing, translation, travel, and news. Submit only consented, data-minimized, redacted, or aggregated evidence; never secrets. Evidence input location: arguments. 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
`stage`	No	Free-text venture stage, for example pre-MVP, pilot, grant-funded programme or scaling. No closed enum.
`claims`	No	Optional explicit target claims and source-specific support links. Reuses the governed claim-audit vocabulary. Public links are caller declarations, never authenticated reviewer attestations.
`entity`	No
`sector`	No
`country`	No
`question`	No
`use_case`	No
`company_name`	No
`target_users`	No
`analysis_date`	No	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.
`evidence_pack`	No	Full current evidence pack. Rechecks replace the pack; the server does not append or retrieve evidence.
`evidence_items`	No	Alias for evidence_pack. Supply one field, not conflicting copies.
`known_partners`	No
`analysis_timezone`	No	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.
`evidence_available`	No	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.
`context_freshness_window_days`	No	Optional caller-declared maximum evidence age in days. No universal freshness cutoff is invented when absent; age alone does not prove validity.

Output Schema

TableJSON Schema

Name	Required	Description
`code`	No
`status`	No	awaiting_scope_clarification: ask scope.
`subject`	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
`decision_domain`	No
`evidence_intake`	No
`workflow_status`	No
`decision_domains`	No
`exact_next_calls`	No
`evidence_received`	No
`activation_outcome`	No	relevance_unresolved: clarify scope.
`next_three_unlocks`	No
`workflow_expires_at`	No
`commercial_next_step`	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.
`example_next_request`	No
`mvr_response_receipt`	No
`required_user_inputs`	No
`evidence_requirements`	No
`evidence_input_feedback`	No
`continuation_disposition`	No
`max_safe_action_available_now`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedOct 3, 2026
- addedOutput schema / properties / activation_outcome / description
```
Added value: +"relevance_unresolved: clarify scope."
```
- addedOutput schema / properties / status / description
```
Added value: +"awaiting_scope_clarification: ask scope."
```

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 / 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 / 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 / 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 / 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 / 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 / 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 / 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 / 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 / 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 / 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 / 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 / evidence_items / items / properties / freshness_date

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

changedInput schema / 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 / 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 / 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 / evidence_pack / items / properties / freshness_date

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

changedInput schema / 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 / 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."

Changed9 schema fields changedSep 6, 2026

changedInput schema / properties / evidence_available / description

Previous value: -"Unstructured evidence labels only. These are not counted as structured proof."New value: +"Optional context labels, not structured evidence and never counted as proof. Use evidence_pack for items."

changedInput schema / properties / evidence_items / description

Previous value: -"Alias for evidence_pack."New value: +"Alias for evidence_pack. Supply one field, not conflicting copies."

addedInput schema / 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 / 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 / evidence_pack / description

Previous value: -"Structured evidence items with source date, source class, geography, and provenance."New value: +"Full current evidence pack. Rechecks replace the pack; the server does not append or retrieve evidence."

addedInput schema / 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 / evidence_pack / 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"
+  }
+}

addedInput schema / properties / stage / description

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

changedOutput schema / properties / example_next_request / type

Previous value: -"object"New value: +[
+  "object",
+  "null"
+]

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"
+}

Changed8 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 / anyOf

Added value: +[
+  {
+    "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"
+  }
+]

removedOutput schema / properties / mcp_next_tool / type
```
Removed value: -"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"
+}
```

Changed5 schema fields changedAug 4, 2026

addedInput schema / properties / evidence_available / description

Added value: +"Unstructured evidence labels only. These are not counted as structured proof."

addedInput schema / properties / evidence_items

Added value: +{
+  "description": "Alias for evidence_pack.",
+  "items": {
+    "additionalProperties": true,
+    "type": "object"
+  },
+  "type": "array"
+}

addedInput schema / properties / evidence_pack

Added value: +{
+  "description": "Structured evidence items with source date, source class, geography, and provenance.",
+  "items": {
+    "additionalProperties": true,
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / code
```
Added value: +{
+  "type": "string"
+}
```
addedOutput schema / properties / evidence_received
```
Added value: +{
+  "type": "object"
+}
```

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"
+}

Changed2 schema fields changedJul 18, 2026
- addedOutput schema / properties / example_next_request
```
Added value: +{
+  "type": "object"
+}
```
- addedOutput schema / properties / mcp_next_tool
```
Added value: +{
+  "type": "object"
+}
```
Changed3 schema fields changedJul 15, 2026
- addedOutput schema / properties / decision_domain
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / properties / max_safe_action_available_now
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / properties / next_three_unlocks
```
Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}
```
AddedJun 13, 2026

TDQS

A4.2/5.0

Behavior5/5

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

Goes well beyond the readOnly/openWorld/destructive annotations by disclosing that rechecks replace (never append to or retrieve) the evidence pack, that passing coverage 'never verifies truth, permission or readiness', that results never authorize a decision, and that only consented, data-minimized, redacted or aggregated evidence may be submitted (never secrets). These are non-obvious behavioral constraints an agent could not infer from annotations alone.

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

Conciseness4/5

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

Purpose is front-loaded and the Use when / Do not use when structure is easy to scan. It is dense for a 16-parameter tool, but the field enumeration partly duplicates the schema and the trailing list ('MVR, capitals, GDP, coding, writing, translation, travel, and news') is an over-long enumeration. Still, no sentence is pure filler.

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

Completeness3/5

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

An output schema exists, so return values need not be described, and the description thoroughly covers evidence-pack semantics and data-handling rules. But for a 16-parameter tool with 0 required fields, the core context inputs (stage, entity, sector, country, question, use_case, company_name, target_users) are left entirely unexplained, so an agent has no guidance on what context it must supply.

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

Parameters3/5

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

Schema description coverage is 50%, and the description does list evidence-item field names and formats (id, claim, evidence_type, source_class, verification_status, geography, source_date as YYYY-MM-DD/ISO, evidence_geography shape) plus omission rules ('omit unknown dates/references, never null or invented') and the 'unchecked = unverified' default. But it says nothing about the non-evidence context parameters (stage, entity, sector, country, question, use_case, company_name, target_users, known_partners), which are undocumented in both schema and description.

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?

The description states a specific verb and resource ('decision-governance preflight' that 'Checks market trust, permission, embeddedness, stakeholder readiness, evidence gaps') and scopes it to pre-MVP build/entry/BNPL/investment/partnership/scale decisions. It is clear about what the tool does and explicitly says it 'never authorizes'. However, it never names or contrasts the sibling tools (mvr_decision_check, mvr_evidence_completeness, mvr_context_compile), so an agent cannot easily tell which MVR tool to pick.

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

Usage Guidelines5/5

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

Explicit 'Use when' and 'Do not use when' blocks: use before enter/launch/scale/invest/lend/BNPL/partner/deploy decisions, and when asked to ignore, fabricate, or transfer evidence. Exclusions are concrete ('not an internal data lookup or glossary', skip MVR definitions, coding, translation, travel, news). It also clarifies that web research supplements but does not replace MVR.

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.