HUMANMIRROR OUTCOME · DOCS

Describe the result. Verify it. Pay only on success.

Outcome uses the existing HumanMirror Nexus key and credit balance. Quotes and verification are free. A successful outcome.run costs 5 Nexus credits. Execution errors and verification failures are automatically refunded.

1. Quote — free

POST https://humanmirror.fr/api/outcome/quote/
Content-Type: application/json

{
  "outcome_type": "deduplicate_records",
  "input": [
    {"id":1,"name":"Ada"},
    {"id":1,"name":"Ada"},
    {"id":2,"name":"Linus"}
  ]
}

The response contains contract_id, selected_tool_id, normalized success criteria, verifier description and the 5-credit success price.

2. Run — charged only on verified success

POST https://humanmirror.fr/api/outcome/run/
Authorization: Bearer hm_nexus_YOUR_KEY
Content-Type: application/json

{
  "outcome_type": "deduplicate_records",
  "contract_id": "hmoc_...",
  "input": [
    {"id":1,"name":"Ada"},
    {"id":1,"name":"Ada"},
    {"id":2,"name":"Linus"}
  ]
}

On success, the response contains status: verified_success, the output, deterministic verification checks and a HumanMirror Trace receipt. If the execution or verification fails, Nexus refunds the reserved credits automatically.

3. Verify — free

POST https://humanmirror.fr/api/outcome/verify/
Content-Type: application/json

{
  "outcome_type": "deduplicate_records",
  "input": [
    {"id":1,"name":"Ada"},
    {"id":1,"name":"Ada"},
    {"id":2,"name":"Linus"}
  ],
  "output": [
    {"id":1,"name":"Ada"},
    {"id":2,"name":"Linus"}
  ]
}

You can also verify the Trace receipt using its public verification URL returned by a successful Outcome run.

MCP

Remote MCP:
https://humanmirror.fr/api/nexus/mcp/

Free:
outcome_quote
outcome_verify

Metered on verified success:
outcome_run

Supported outcome types

clean_json, deduplicate_records, normalize_entity, data_quality_at_least, detect_anomalies, no_secrets, output_quality, schema_compatible, safe_preflight, execution_receipt.

Outcome is deliberately conservative. It only marks success where HumanMirror has a deterministic verifier. It does not certify factual truth, legal correctness, authorization, medical outcomes or other high-impact judgments.