# Verity Suite Compass

> Verity Suite Compass is a paid API for AI agents from suite.veritylayer.dev, paid per call via x402, $0.06/call, status unknown (last checked 2026-09-14).

Evaluates a set of candidate options against stated constraints and evidence, returning a structured verdict (recommend, tentative, gather_more_info, or no_viable_option) with confidence score and reasons.

## Facts

- Endpoint: POST https://suite.veritylayer.dev/compass
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/verity-suite-compass-3a7bad32
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oAAzUhkZ99023JJ32UCV_

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability verity-suite-compass-3a7bad32 -d '<json body>'
```

Example prompt: I need to pick between three cloud storage plans — Plan A at $9/mo with 1TB and no versioning, Plan B at $15/mo with 2TB and 30-day versioning, Plan C at $20/mo with 5TB and unlimited versioning — my constraints are: must have versioning, prefer under $18/mo, storage at least 1TB. Which one should I go with and how confident are you?

## When to prefer this

Choose Compass when an agent needs a structured, auditable, calibrated pick from a finite set of known options — especially when confidence scoring and explicit reasoning are required. Prefer it over raw LLM reasoning when you need fail-closed behavior (it won't hallucinate external facts beyond supplied evidence), a machine-readable verdict enum, or a cryptographic payment receipt for audit trails. Not suited for open-ended generation, ranking large unstructured datasets, or real-time web lookups.

## Known failure modes

- Empty or missing options array — request rejected at validation
- Constraints field blank or too short — fails minLength:1 validation
- Evidence references external/current facts not provided in the evidence field — service may return gather_more_info verdict instead of a pick
- Options list contains ambiguous or duplicate entries — may produce lower confidence or tentative verdict
- Body not sent as JSON with correct bodyType — request rejected
- Payment not included or insufficient — x402 payment required error
- Constraints or evidence exceed 2000 character limits — request rejected

## How this service works

The trust fabric for AI agents — calibrated, fail-closed services agents pay per call.

## Output

Returns a structured verdict object with: a verdict field (recommend, tentative, gather_more_info, or no_viable_option), the chosen option copied verbatim from the input list (when a pick is made), a confidence score, an array of concrete reasons grounded in the constraints and evidence (including the main tradeoff against the runner-up), and a payment receipt object.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "options": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "title": "Options",
   "description": "the candidate choices to pick among; one option per item, stated verbatim as you want it returned"
  },
  "evidence": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 2000
    },
    {
     "type": "null"
    }
   ],
   "title": "Evidence",
   "default": null,
   "description": "facts known about the options (specs, prices, availability, data); for any current or external fact, only what is stated here may be used"
  },
  "constraints": {
   "type": "string",
   "title": "Constraints",
   "maxLength": 2000,
   "minLength": 1,
   "description": "the goal plus hard requirements (must-meet gates), soft preferences (weigh, don't gate), and any priorities or tradeoffs between them"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/verity-suite-compass-3a7bad32/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from suite.veritylayer.dev](https://www.zero.xyz/host/suite.veritylayer.dev/llms.txt)
