Agent research and continuation

Pages carry whole claims: a claim travels with its row and every claim it was derived from, and the answer's basis is always on page 1. Keep the token and ask for the next page only when the agent needs it.

research and continue (Python)

# Python 3.8+, standard library only. One research call, then its next page.
import json
import urllib.request

MCP = "https://exchange-production-9123.up.railway.app/mcp/core?c=docs"


def call(tool, arguments, rpc_id=1):
    body = json.dumps({
        "jsonrpc": "2.0", "id": rpc_id, "method": "tools/call",
        "params": {"name": tool, "arguments": arguments},
    }).encode()
    req = urllib.request.Request(MCP, data=body, headers={
        "Content-Type": "application/json",
        "Accept": "application/json, text/event-stream",
        "User-Agent": "my-research-agent/1.0",
    })
    with urllib.request.urlopen(req, timeout=60) as resp:
        result = json.load(resp)["result"]
    return result["structuredContent"]


page1 = call("research", {
    "question": "Which BDCs lend to Auctane, and which of them are current lenders?",
})
print(page1["answer_state"], "|", page1["answer"]["text"][:160])
for row in page1["relationships"]:
    print(" ", row["type"], "|", row["subject"]["name"], "| current:", row.get("current"), "|", row["claim_type"], "|", row["cite"]["url"])
print("page", page1["page"]["index"], "of", page1["page"]["pages"])

if page1["page"].get("continuation"):
    page2 = call("research", {"continue": page1["page"]["continuation"]}, rpc_id=2)
    for row in page2["relationships"]:
        print(" ", row["type"], "|", row["subject"]["name"], "| current:", row.get("current"), "|", row["claim_type"], "|", row["cite"]["url"])
    print("page", page2["page"]["index"], "of", page2["page"]["pages"])

What production returned at 2026-10-11T20:22:21Z. Standard output in full.

OK | At 2026-06-30, 29 BDCs held positions in Auctane Inc on their own schedules of investments; the largest: Blackstone Private Credit Fund ($889.4M of debt at fair
  BDC_SCHEDULE_HOLDING | Blackstone Private Credit Fund | current: True | VERIFIED_FACT | https://www.sec.gov/Archives/edgar/data/1803498/000180349826000048/bcred-20260630.htm
  BDC_SCHEDULE_HOLDING | Blackstone Secured Lending Fund | current: True | VERIFIED_FACT | https://www.sec.gov/Archives/edgar/data/1736035/000173603526000016/bxsl-20260630.htm
  BDC_SCHEDULE_HOLDING | ARES CAPITAL CORP | current: True | VERIFIED_FACT | https://www.sec.gov/Archives/edgar/data/1287750/000162828026050307/arcc-20260630.htm
  BDC_SCHEDULE_HOLDING | Goldman Sachs Private Credit Corp. | current: True | VERIFIED_FACT | https://www.sec.gov/Archives/edgar/data/1920145/000119312526340582/ck0001920145-20260630.htm
page 1 of 3
  BDC_SCHEDULE_HOLDING | ARES STRATEGIC INCOME FUND | current: True | VERIFIED_FACT | https://www.sec.gov/Archives/edgar/data/1918712/000162828026054923/asif-20260630.htm
  SPONSOR_OF_BORROWER | Thoma Bravo | current: True | REPORTED | https://www.thomabravo.com/press-releases/wwex-group-and-auctane-complete-merger-creating-leading-logistics-provider-shipstation-global
page 2 of 3

Saved investigations live on the watch tools (watch_create, watch_list, watch_changes, watch_reevaluate, watch_cancel). They save an account's own objectives and checkpoints, so they need an account; a keyless call to them is refused and nothing is saved.

depth: "monitor" with since returns the dated changes on one subject in one call. Each event is labelled by novelty: NEW_EVENT happened inside the window, NEWLY_OBSERVED_HISTORICAL was first read inside it but happened before, SCHEDULED_FUTURE has not happened yet.

research, depth monitor

curl -s "https://exchange-production-9123.up.railway.app/mcp/core?c=docs" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"research",
       "arguments":{"question":"What changed in Auctane lender group since April?",
                    "entity":"dfx:pc:d071f992-5b4e-dffb-9f2c-22cb2204622b",
                    "depth":"monitor","since":"2026-04-01","detail":"compact"}}}'

What production returned at 2026-10-11T20:48:20Z. result.structuredContent in full, re-indented.

{
 "dfx": {
  "capability": "research",
  "layer": "dfx_intelligence",
  "version": "1.0.0",
  "answered_at": "2026-10-11T20:48:20.682543+00:00"
 },
 "ok": true,
 "state": "OK",
 "schema": "dfx.research/2",
 "generated_at": "2026-10-11T20:48:20.682543+00:00",
 "answer_state": "OK",
 "detail": "compact",
 "identities": {
  "state": "RESOLVED",
  "subject": {
   "dfx_id": "dfx:pc:d071f992-5b4e-dffb-9f2c-22cb2204622b",
   "name": "Auctane Inc",
   "type": "borrower"
  }
 },
 "answer": {
  "text": "5 changes for Auctane Inc on DFX's tape since 2026-04-01.",
  "basis": [
   "v1",
   "v2",
   "v3",
   "v4",
   "v5"
  ]
 },
 "claims": [
  {
   "claim_id": "clm_12952d56dd54c78131c19b4e",
   "row": "v1",
   "predicate": "EVENT_MATURITY_EXTENDED",
   "claim_type": "REPORTED_FACT"
  },
  {
   "claim_id": "clm_979da0244a3e2273fd4a73ef",
   "row": "v2",
   "predicate": "EVENT_NEW_LENDER",
   "claim_type": "REPORTED_FACT"
  },
  {
   "claim_id": "clm_724fa17bb73be34df32498ff",
   "row": "v3",
   "predicate": "EVENT_NEW_LENDER",
   "claim_type": "REPORTED_FACT"
  }
 ],
 "counts": {
  "facts": 0,
  "relationships": 0,
  "events": 5,
  "claims_total": 5,
  "rows_total": 5,
  "uncertainty": 0,
  "coverage_limits": 1
 },
 "withheld": {
  "access": "anonymous"
 },
 "more": "detail=research returns the facts, relationships, claims and limits in full"
}