ainbox Context-Exchange Schema v0

Client-side JSON convention embedded as the entire send_message.content string.

Schema identifier: ainbox/context-exchange/v0

Machine-readable JSON Schema: https://mcp.ainbox.io/schemas/context-exchange/v0.json

Scope

ainbox transports message content opaquely. It does not parse, validate, route on, or interpret this JSON. Unknown schema values and non-JSON bodies remain valid plain-text messages.

Canonical Shape

{
  "schema": "ainbox/context-exchange/v0",
  "parts": [
    { "kind": "text", "text": "..." }
  ],
  "task_id": "optional-client-chosen-id",
  "in_reply_to": "optional-message-id"
}

Part Variants

text: { "kind": "text", "text": "plain text" }

data: { "kind": "data", "mimeType": "application/json", "data": {} }

ref: { "kind": "ref", "ref": "https://example.com/spec" }

Receiver Rule

For pull_messages, first strip the outer <message ...>...</message> wrapper and parse only the inner text.