Omneum

Overview Schema Source Related Servers Discussions Admin

evaluate_context

Evaluate source reliability and claim support from caller-prepared graphs of opaque linkage tokens and evidence dependencies to detect conflicting claims and redundant support for context selection.

Instructions

Evaluate relative source reliability and claim support from a caller-prepared graph of opaque linkage tokens and pairwise evidence dependencies. Use the Omneum SDK to prepare canonically ordered inputs and map returned tokens back to local context. Returns source reliability, claim support, conflicting claims, and estimated independent support for context selection. The server does not inspect source text, fetch sources, or independently determine factual truth or freshness. Graphs are evaluated without persistence; failures return isError=true with message and omneum_code.

Input Schema

TableJSON Schema

Name	Required	Description
`assertions`	Yes	1-4096 unique assertion triples, sorted lexicographically by (source_id, attribute_id, claim_id). Each source may assert at most one claim per attribute; each claim belongs to exactly one attribute. At most 64 distinct sources, 2048 attributes, and 4096 claims. The sum of k*(k-1) across attributes, where k is the attribute's distinct claim count, must not exceed 16384 conflicting-claim entries.
`voprf_mode`	Yes	VOPRF mode. Must be voprf.
`source_pairs`	Yes	Complete unordered source-pair matrix: exactly n*(n-1)/2 entries for the n distinct sources in assertions, at most 2016 entries. Sort lexicographically by (source_a_id, source_b_id); use an empty array for one source. No duplicate, diagonal, reversed, or unknown-source pairs.
`deployment_id`	Yes	Deployment identifier from the initialized client configuration or ping. Must be a canonical lowercase urn:uuid:… value matching this server.
`protocol_version`	Yes	Omneum protocol version. Must be v1.
`voprf_ciphersuite`	Yes	VOPRF ciphersuite. Must be ristretto255-SHA512.
`voprf_key_version`	Yes	VOPRF key version matching this deployment's configured key version.
`linkage_encoding_version`	Yes	Omneum linkage encoding version. Must be 1.

Output Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed17 schema fields changedv1.1.5Oct 17, 2026

addedInput schema / $defs / Assertion / properties / attribute_id / description

Added value: +"Opaque linkage token identifying the entity-attribute being asserted: canonical unpadded base64url encoding of 64 bytes, exactly 86 characters."

addedInput schema / $defs / Assertion / properties / claim_id / description

Added value: +"Opaque linkage token identifying a claim value for its attribute: canonical unpadded base64url encoding of 64 bytes, exactly 86 characters."

addedInput schema / $defs / Assertion / properties / source_id / description

Added value: +"Opaque source linkage token: canonical unpadded base64url encoding of 64 bytes, exactly 86 characters. Use the Omneum SDK to generate and retain its local mapping."

addedInput schema / $defs / SourcePair / properties / dependency / description

Added value: +"Caller-supplied pairwise evidence-dependency score, finite and within [0,1]: zero represents no modeled dependency; one represents maximal dependency. This does not certify exact equivalence."

changedInput schema / $defs / SourcePair / properties / exact_equivalence / description

Previous value: -"Explicit certification of identical evidence; not ordinary derivation."New value: +"Explicit certification of identical evidence; not ordinary derivation. True links form transitive equivalence groups. Group members must have identical claim profiles and uniform dependencies to other groups."

addedInput schema / $defs / SourcePair / properties / source_a_id / description

Added value: +"Source linkage token present in assertions, lexicographically smaller than source_b_id. Canonical unpadded base64url encoding of 64 bytes (86 characters)."

addedInput schema / $defs / SourcePair / properties / source_b_id / description

Added value: +"Distinct source linkage token present in assertions, lexicographically larger than source_a_id. Canonical unpadded base64url encoding of 64 bytes (86 characters)."

addedInput schema / $defs / SourcePair / properties / weighted_signal_coverage / description

Added value: +"Caller-supplied weighted coverage of observable dependency signals, finite and within [0,1]. Used for coverage diagnostics, not as an additional inference weight."

addedInput schema / properties / assertions / description

Added value: +"1-4096 unique assertion triples, sorted lexicographically by (source_id, attribute_id, claim_id). Each source may assert at most one claim per attribute; each claim belongs to exactly one attribute. At most 64 distinct sources, 2048 attributes, and 4096 claims. The sum of k*(k-1) across attributes, where k is the attribute's distinct claim count, must not exceed 16384 conflicting-claim entries."

addedInput schema / properties / deployment_id / description

Added value: +"Deployment identifier from the initialized client configuration or ping. Must be a canonical lowercase urn:uuid:… value matching this server."

addedInput schema / properties / linkage_encoding_version / description
```
Added value: +"Omneum linkage encoding version. Must be 1."
```
addedInput schema / properties / protocol_version / description
```
Added value: +"Omneum protocol version. Must be v1."
```

addedInput schema / properties / source_pairs / description

Added value: +"Complete unordered source-pair matrix: exactly n*(n-1)/2 entries for the n distinct sources in assertions, at most 2016 entries. Sort lexicographically by (source_a_id, source_b_id); use an empty array for one source. No duplicate, diagonal, reversed, or unknown-source pairs."

addedInput schema / properties / voprf_ciphersuite / description

Added value: +"VOPRF ciphersuite. Must be ristretto255-SHA512."

addedInput schema / properties / voprf_key_version / description

Added value: +"VOPRF key version matching this deployment's configured key version."

addedInput schema / properties / voprf_mode / description
```
Added value: +"VOPRF mode. Must be voprf."
```

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$defs": {
+    "ClaimSupport": {
+      "additionalProperties": false,
+      "properties": {
+        "agreement_weight": {
+          "maximum": 1,
+          "minimum": 0,
+          "title": "Agreement Weight",
+          "type": "number"
+        },
+        "attribute_id": {
+          "title": "Attribute Id",
+          "type": "string"
+        },
+        "claim_id": {
+          "title": "Claim Id",
+          "type": "string"
+        },
+        "conflicting_claims": {
+          "items": {
+            "$ref": "#/$defs/ConflictingClaim"
+          },
+          "title": "Conflicting Claims",
+          "type": "array"
+        },
+        "dependency_signal_coverage": {
+          "anyOf": [
+            {
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "title": "Dependency Signal Coverage"
+        },
+        "estimated_independent_support_count": {
+          "minimum": 1,
+          "title": "Estimated Independent Support Count",
+          "type": "number"
+        },
+        "is_attribute_max_support": {
+          "title": "Is Attribute Max Support",
+          "type": "boolean"
+        },
+        "support": {
+          "minimum": 0,
+          "title": "Support",
+          "type": "number"
+        },
+        "supporting_source_count": {
+          "minimum": 1,
+          "title": "Supporting Source Count",
+          "type": "integer"
+        },
+        "supporting_sources": {
+          "items": {
+            "$ref": "#/$defs/SupportingSource"
+          },
+          "title": "Supporting Sources",
+          "type": "array"
+        }
+      },
+      "required": [
+        "attribute_id",
+        "claim_id",
+        "support",
+        "agreement_weight",
+        "is_attribute_max_support",
+        "supporting_source_count",
+        "estimated_independent_support_count",
+        "dependency_signal_coverage",
+        "supporting_sources",
+        "conflicting_claims"
+      ],
+      "title": "ClaimSupport",
+      "type": "object"
+    },
+    "ConflictingClaim": {
+      "additionalProperties": false,
+      "properties": {
+        "claim_id": {
+          "title": "Claim Id",
+          "type": "string"
+        },
+        "support": {
+          "minimum": 0,
+          "title": "Support",
+          "type": "number"
+        }
+      },
+      "required": [
+        "claim_id",
+        "support"
+      ],
+      "title": "ConflictingClaim",
+      "type": "object"
+    },
+    "EvaluateAssertionResponse": {
+      "additionalProperties": false,
+      "properties": {
+        "claim_support": {
+          "items": {
+            "$ref": "#/$defs/ClaimSupport"
+          },
+          "title": "Claim Support",
+          "type": "array"
+        },
+        "deployment_id": {
+          "title": "Deployment Id",
+          "type": "string"
+        },
+        "linkage_encoding_version": {
+          "title": "Linkage Encoding Version",
+          "type": "integer"
+        },
+        "metadata": {
+          "$ref": "#/$defs/Metadata"
+        },
+        "protocol_version": {
+          "title": "Protocol Version",
+          "type": "string"
+        },
+        "source_reliability": {
+          "items": {
+            "$ref": "#/$defs/SourceReliability"
+          },
+          "title": "Source Reliability",
+          "type": "array"
+        },
+        "summary": {
+          "$ref": "#/$defs/Summary"
+        },
+        "voprf_ciphersuite": {
+          "title": "Voprf Ciphersuite",
+          "type": "string"
+        },
+        "voprf_key_version": {
+          "maximum": 4294967295,
+          "minimum": 1,
+          "title": "Voprf Key Version",
+          "type": "integer"
+        },
+        "voprf_mode": {
+          "title": "Voprf Mode",
+          "type": "string"
+        }
+      },
+      "required": [
+        "protocol_version",
+        "deployment_id",
+        "voprf_key_version",
+        "voprf_mode",
+        "voprf_ciphersuite",
+        "linkage_encoding_version",
+        "summary",
+        "source_reliability",
+        "claim_support",
+        "metadata"
+      ],
+      "title": "EvaluateAssertionResponse",
+      "type": "object"
+    },
+    "Metadata": {
+      "additionalProperties": false,
+      "properties": {
+        "algorithm_version": {
+          "title": "Algorithm Version",
+          "type": "string"
+        },
+        "converged": {
+          "title": "Converged",
+          "type": "boolean"
+        },
+        "convergence_delta": {
+          "minimum": 0,
+          "title": "Convergence Delta",
+          "type": "number"
+        },
+        "convergence_tolerance": {
+          "minimum": 0,
+          "title": "Convergence Tolerance",
+          "type": "number"
+        },
+        "iterations": {
+          "maximum": 1000,
+          "minimum": 1,
+          "title": "Iterations",
+          "type": "integer"
+        }
+      },
+      "required": [
+        "algorithm_version",
+        "iterations",
+        "converged",
+        "convergence_tolerance",
+        "convergence_delta"
+      ],
+      "title": "Metadata",
+      "type": "object"
+    },
+    "OmneumErrorResponse": {
+      "additionalProperties": false,
+      "description": "Stable structured tool failure.",
+      "properties": {
+        "message": {
+          "title": "Message",
+          "type": "string"
+        },
+        "omneum_code": {
+          "enum": [
+            "request_too_large",
+            "invalid_request",
+            "authentication_required",
+            "permission_denied",
+            "unsupported_protocol_version",
+            "deployment_mismatch",
+            "voprf_key_version_mismatch",
+            "unsupported_voprf_mode",
+            "unsupported_voprf_ciphersuite",
+            "unsupported_linkage_encoding_version",
+            "invalid_blinded_element",
+            "invalid_graph",
+            "rate_limited",
+            "server_busy",
+            "request_timeout",
+            "evaluation_failed",
+            "assertion_evaluation_failed",
+            "internal_error"
+          ],
+          "title": "Omneum Code",
+          "type": "string"
+        }
+      },
+      "required": [
+        "message",
+        "omneum_code"
+      ],
+      "title": "OmneumErrorResponse",
+      "type": "object"
+    },
+    "SourceReliability": {
+      "additionalProperties": false,
+      "properties": {
+        "reliability": {
+          "minimum": 0,
+          "title": "Reliability",
+          "type": "number"
+        },
+        "source_id": {
+          "title": "Source Id",
+          "type": "string"
+        }
+      },
+      "required": [
+        "source_id",
+        "reliability"
+      ],
+      "title": "SourceReliability",
+      "type": "object"
+    },
+    "Summary": {
+      "additionalProperties": false,
+      "properties": {
+        "assertion_count": {
+          "maximum": 4096,
+          "minimum": 1,
+          "title": "Assertion Count",
+          "type": "integer"
+        },
+        "claim_count": {
+          "maximum": 4096,
+          "minimum": 1,
+          "title": "Claim Count",
+          "type": "integer"
+        },
+        "source_count": {
+          "maximum": 64,
+          "minimum": 1,
+          "title": "Source Count",
+          "type": "integer"
+        }
+      },
+      "required": [
+        "source_count",
+        "claim_count",
+        "assertion_count"
+      ],
+      "title": "Summary",
+      "type": "object"
+    },
+    "SupportingSource": {
+      "additionalProperties": false,
+      "properties": {
+        "contribution": {
+          "minimum": 0,
+          "title": "Contribution",
+          "type": "number"
+        },
+        "independence": {
+          "maximum": 1,
+          "minimum": 0,
+          "title": "Independence",
+          "type": "number"
+        },
+        "source_id": {
+          "title": "Source Id",
+          "type": "string"
+        }
+      },
+      "required": [
+        "source_id",
+        "independence",
+        "contribution"
+      ],
+      "title": "SupportingSource",
+      "type": "object"
+    }
+  },
+  "anyOf": [
+    {
+      "$ref": "#/$defs/EvaluateAssertionResponse"
+    },
+    {
+      "$ref": "#/$defs/OmneumErrorResponse"
+    }
+  ],
+  "type": "object"
+}

First observedv0.1.0Oct 17, 2026

TDQS

A4.4/5.0

Behavior5/5

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

With no annotations, the description carries the full burden and discharges it well: it discloses that graphs are evaluated without persistence, that the server performs no source fetching or truth determination, and that failures return isError=true with a message and omneum_code. This is meaningful behavioral context an agent could not infer from the schema.

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?

Four dense sentences, front-loaded with purpose followed by setup guidance, return values, and limitations. Every sentence carries information, though it is tightly packed and could be marginally streamlined.

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?

For a complex cryptographic graph-evaluation tool, the description covers purpose, caller responsibilities, return contents, failure behavior, and explicit non-capabilities. With an output schema present, return values need not be detailed further, and nothing essential for correct invocation is missing.

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 schema already explains every parameter in depth (token format, ordering, dependency semantics, limits). The description adds only high-level framing about canonical ordering and opaque tokens, so the baseline of 3 applies.

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?

States a specific verb (evaluate) and resource (relative source reliability and claim support) over a precisely characterized input (a caller-prepared graph of opaque linkage tokens and pairwise evidence dependencies). This is clearly distinguishable from siblings like ping and evaluate_voprf, which operate on different inputs.

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?

Gives clear context: use the Omneum SDK to prepare canonically ordered inputs and map returned tokens back to local context, and states explicit exclusions (server does not inspect source text, fetch sources, or determine truth/freshness). It does not explicitly name the alternative sibling or the condition selecting it, so it falls short of a 5.

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

Deploy Server