MSP-1 Specification

trust

The trust term declares trust-related context, confidence indicators, verification information, and supporting signals associated with an MSP-1 resource.

Category: Trust context and verification metadata

Status: Active core term

Required: Contextual

Version: MSP-1 v1.0.1

1. Purpose

The trust term provides a consistent way to declare trust-related context for an MSP-1 resource.

Trust metadata may describe declared confidence, verification status, verification source, supporting signals, audit context, and notes about limitations or caveats. It provides context for interpretation, but it does not by itself establish correctness, authority, safety, verification, or ranking priority.

2. Definition

A trust declaration is an object describing trust-context metadata associated with a resource.

The canonical MSP-1 object form requires level. Verification details are expressed through separate optional fields so that declared confidence and verification status remain distinct.

3. Required fields

  • level — general declared confidence context for the resource.

Allowed level values include:

  • low — low declared confidence context.
  • medium — medium declared confidence context.
  • high — high declared confidence context.

4. Additional fields

  • verified — indicates whether the resource has undergone a declared verification process.
  • verificationLevel — declared verification status, using self-declared or verified.
  • verifiedBy — identifier for the person, organization, or system that performed or declared verification.
  • verificationDate — date when verification was performed or declared.
  • confidence — declared confidence in the accuracy, reliability, or interpretive stability of the resource.
  • signals — optional list of trust-related supporting signals or justifications.
  • auditTrail — optional chronological audit entries describing trust or verification events.
  • notes — optional notes describing trust context, limits, caveats, or interpretation.

5. Usage guidance

  • Trust metadata should declare context and supporting signals rather than instruct agents how to rank or believe content.
  • Trust declarations should align with provenance, reviewer, authority, and revision metadata when those declarations are present.
  • Trust declarations should apply only to their declared or reasonably implied scope.
  • Trust should not be treated as proof of truth, correctness, authority, safety, verification, or ranking priority by itself.
  • Missing trust metadata should be treated as unspecified trust context, not as evidence of unreliability.
  • Authority meaning should be declared through authority, not through the trust level field.

6. Examples

Minimal trust declaration:

{
  "trust": {
    "level": "medium"
  }
}

Verified trust declaration:

{
  "trust": {
    "level": "high",
    "verified": true,
    "verificationLevel": "verified",
    "verifiedBy": "editorial-team",
    "verificationDate": "2026-06-24",
    "signals": [
      "human-reviewed",
      "metadata-checked"
    ]
  }
}

Authority-supported high trust context:

{
  "trust": {
    "level": "high",
    "verified": true,
    "verificationLevel": "verified",
    "verifiedBy": "msp-1-org",
    "notes": "Declared high confidence for MSP-1 protocol documentation scope. Authority context should be evaluated through the authority declaration, not through the trust level alone."
  }
}

7. Relationship to related MSP-1 terms

  • provenance describes origin and lineage; trust declares trust-context metadata.
  • reviewer identifies review responsibility and may support trust context when review metadata is present.
  • authority identifies scope-bound authority and should not be collapsed into trust level vocabulary.
  • revision may document lifecycle events that affect trust or verification context.
  • site, page, and section may define the scope to which trust metadata applies.

8. Deprecated compatibility note

The deprecated compliance term should not be emitted in new MSP-1 v1.0.1 declarations. Legacy trust declarations that function like compliance, validation, or authority badges should be treated as compatibility-era language and interpreted through graceful degradation rather than reactivating the sunset field.

Legacy flat-string trust values such as verified may receive advisory handling when unambiguous. Legacy authoritative trust values should be routed to the separate authority term or treated as advisory compatibility drift.

9. Validation guidance

When present, trust should be an object with level. The level value should be low, medium, or high.

Validators should flag unsupported level values, contradictory verified and verificationLevel combinations, unsupported fields such as validated, legacy badge-like values such as authoritative, or trust declarations that conflict with provenance, reviewer, authority, revision metadata, or observable content as non-ideal clarity conditions.