Get conversation context
get_conversation_contextReturns one conversation already assembled, newest first, so a smaller model can answer about that conversation. It reads messages and call summaries on that conversation id. It does not rewrite them. The most recent messages that fit token_budget are included, plus call summaries for calls on that same conversation. A call uses its stored summary, or a transcript excerpt when no summary is stored. token_budget defaults to 2000. approx_tokens estimates tokens as characters divided by 4, rounded up, on each serialized item. That figure is an estimate, not a tokenizer count. Pass query to also include older messages in this conversation that match it, still inside the budget. since is an ISO 8601 lower bound. Each item has type message or call, its message id or call_id, a timestamp, sender or direction, and text. The result reports approx_tokens, items_included, items_omitted, has_more_older, and server_ms. It returns the items that fit, not the whole conversation. Verification codes and other labeled secrets are masked. Set include_memory true to add the saved memory for this conversation when that account has it turned on. Memory cites message ids and call ids, and reports its version, freshness, and token count. If memory is off, missing, stale, or paused, the result is the source messages and memory.status says why. That does not fail the call, and it does not show a conversation this seat cannot already read.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"conversation_id": "<conversation_id>"
},
"name": "get_conversation_context"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Also include older messages in this conversation that contain this text. | |
| since | No | ISO 8601 lower bound. Older items are left out. | |
| token_budget | No | Approximate token cap. Default 2000. Counted as characters divided by 4, rounded up. | |
| include_memory | No | When true, add this conversation's saved memory if the account has it turned on. Otherwise the result is the source messages. | |
| conversation_id | Yes |