Skip to main content
Glama

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.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
payloadYesDecision question, resolved subject, market scope, and evidence for a bounded recommendation or abstention.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
reasonNo
statusNo
next_stepsNo
workflow_idNo
evidence_gapsNo
mcp_next_callNo
mcp_next_toolNo
not_a_verdictNo
response_metaNo
recommendationNo
workflow_statusNo
safe_next_actionNo
verification_basisNo
workflow_expires_atNo
mvr_response_receiptNo
required_user_inputsNo
continuation_dispositionNo
sandbox_evaluation_scopeNo
live_mvr_scoring_executedNo

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. Changed1 schema field changed
    • 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"
      +}
  2. Changed7 schema fields changed
    • 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"
      +}
  3. Changed2 schema fields changed
    • 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"
      +]
  4. Changed1 schema field changed
    • 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"
      +}
  5. Changed4 schema fields changed
    • 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"
      +}
  6. Changed4 schema fields changed
    • 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"
      +]
  7. Changed2 schema fields changed
    • 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"
      +  }
      +}
  8. Changed1 schema field changed
    • removedInput schema / properties / api_key
      Removed value: -{
      -  "type": "string"
      -}
  9. Changed1 schema field changed
    • 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"
      +}
  10. First observed

TDQS

A4.2/5.0
Behavior4/5

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

Annotations already declare read-only and non-destructive behavior. The description adds useful context beyond that: it is a public tool, it does not compute market/pilot/scale readiness, and it requires consented, data-minimized, redacted or aggregated evidence. This goes beyond the annotation minimum without contradicting it.

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 reasonably compact and uses clear sections, but the 'Use when' sentence largely repeats the opening sentence. The redundancy adds noise without adding information, though the overall structure remains helpful.

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?

Given the rich input schema, output schema, and annotations, the description covers the essential workflow context, exclusions, and data-privacy requirements. It does not explain what MVR scoring is internally, but that is not necessary for invoking the tool correctly.

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 100%, so the payload and its nested properties are already well documented. The description adds no field-specific parameter semantics beyond the general routing and evidence conditions, so the baseline score of 3 is appropriate.

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 states a specific action: route a structurally complete evidence pack toward licensed MVR scoring or abstain when proof is missing. It also positions itself relative to the workflow ('Use after evidence completeness') and explicitly excludes readiness computation, which helps distinguish it from related MVR tools.

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?

The description provides explicit 'Use when' and 'Do not use when' guidance. It tells the agent to invoke it after evidence completeness and warns against using it as readiness, pilot, credit, legal, regulatory, or scale authorization, making selection behavior clear.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A4.1/5.0
Disambiguation4/5

Each tool occupies a distinct workflow stage: preflight, entity resolution, evidence completeness, context compilation, and decision routing. However, evidence gaps are checked by both mvr_first_call and mvr_evidence_completeness, and mvr_decision_check also references missing proof, creating mild boundary overlap.

Naming Consistency4/5

All tools share a consistent mvr_ prefix and snake_case style, which aids recognition. The suffix pattern is slightly inconsistent—some are noun_verb (entity_resolve, context_compile, decision_check) while first_call and evidence_completeness use different grammatical forms—but the overall pattern remains predictable.

Tool Count5/5

Five tools is well-scoped for a public decision-governance preflight workflow. Each tool maps to a necessary phase and none feel redundant or extraneous.

Completeness5/5

The tool set covers the entire public preflight lifecycle: initial governance check, entity resolution, evidence completeness verification, context compilation, and final routing to licensed scoring or abstention. The licensed scoring step is intentionally external, so no critical operation appears missing for the stated purpose.