# Convrgent.ai Information Framing Engine

> Convrgent.ai Information Framing Engine is a paid API for AI agents from convrgent.ai, paid per call via x402, $1/call, status unknown (last checked 2026-09-15).

Generates optimally framed messages for difficult news, trade-offs, price increases, or controversial decisions using gain/loss, temporal, attribution, and scope framing science — personality-calibrated when a KYH profile is provided.

## Facts

- Endpoint: POST https://convrgent.ai/api/blah/frame
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/convrgent-ai-fce6ab5d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_70MNatg6Qk5Wp8Bp-xZJi

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 convrgent-ai-fce6ab5d -d '<json body>'
```

Example prompt: I need to tell my SaaS customers about a 20% price increase effective next quarter — can you frame this message using gain framing to minimize churn, and calibrate it for someone who is highly conscientious and loss-averse based on their KYH profile?

## When to prefer this

Choose this endpoint when you need to communicate difficult, sensitive, or high-stakes information and want the message framed using behavioral science principles rather than just rephrased. Especially valuable when you have KYH personality data for the recipient and want personality-matched framing. Prefer this over generic rewrite tools when framing strategy (gain/loss, temporal, scope) matters to the outcome.

## Known failure modes

- Missing required message content returns a 400 error
- Invalid or malformed KYH profile data may fall back to non-personalized framing
- Ambiguous framing type input may result in a default framing strategy being applied
- Very short or vague input messages may produce generic output with low specificity
- Payment not included or invalid x402 header returns 402 Payment Required

## How this service works

Information framing — optimal presentation of difficult news, trade-offs, price increases, feedback, and controversial decisions. Personality-calibrated when KYH data is provided. Framing science: gain/loss, temporal, attribution, and scope framing.

## Output

Returns a personality-calibrated, strategically framed version of the input message — including the recommended framing type applied (e.g. gain vs loss, temporal, attribution, or scope), the rationale for why this framing suits the recipient, and the final polished message ready for delivery.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "bodyType",
    "body",
    "method"
   ],
   "properties": {
    "body": {
     "required": [
      "information",
      "frame_type",
      "audience_context",
      "desired_outcome"
     ],
     "properties": {
      "frame_type": {
       "enum": [
        "bad-news",
        "price-increase",
        "trade-off",
        "feedback",
        "change",
        "rejection",
        "delay"
       ],
       "type": "string"
      },
      "constraints": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "information": {
       "type": "string"
      },
      "kyh_profile": {
       "type": "object"
      },
      "desired_outcome": {
       "type": "string"
      },
      "audience_context": {
       "type": "string"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "mode": "contextual",
  "avoid": [
   "Don't blame infrastructure costs",
   "Don't offer discounts preemptively"
  ],
  "timing_advice": "Deliver Tuesday-Thursday, give 30+ days notice",
  "frame_type_used": "Gain framing + temporal distance",
  "framing_strategy": "Value-first gain framing with relationship anchoring",
  "recommended_frame": {
   "body": "Over the past year, we've invested heavily in the capabilities your team relies on most. To sustain that and deliver what's next, we're adjusting pricing to $X/month starting next quarter.",
   "close": "You've been with us since the beginning — I'd love to walk through how to maximize value under the new structure.",
   "opening": "I wanted to reach out personally about an update to your plan."
  },
  "alternative_frames": [
   {
    "risk": "Can feel deflective",
    "framing": "Contrast anchor approach",
    "science": "Anchoring bias",
    "strategy": "Compare to higher market rates first"
   }
  ],
  "psychological_anchors": [
   "3-year relationship tenure",
   "Features delivered"
  ],
  "personality_adjustments": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/convrgent-ai-fce6ab5d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from convrgent.ai](https://www.zero.xyz/host/convrgent.ai/llms.txt)