integrations

Update the attorney notes

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://docs.usehearsay.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "integrations MCP server": {
    "url": "https://docs.usehearsay.com/mcp"
  }
}
Close
PUT /ai/cases/{caseId}/summary/attorney-notes
Access token

Sets the attorney-written theory, strategy and open questions sent (the AI never changes these), records who edited them and when, and returns the summary, creating it if needed. Requires owner or admin access to the case and an active plan (403 otherwise); not available to opposing counsel.

Path parameters

  • caseId string Required
application/json

Body Required

  • theory string | null
  • strategy string | null
  • openQuestions array[string]

Responses

  • 200 application/json
    Hide response attributes Show response attributes object
    • data object Required

      The layered AI case summary.

      Hide data attributes Show data attributes object
      • _id string
      • case string
      • organization string
      • version number
      • keyParties object
        Hide keyParties attributes Show keyParties attributes object
        • parties array[object]
          Hide parties attributes Show parties attributes object
          • name string
          • role string
          • aliases array[string]
          • frequency number
          • significance string
        • lastRegeneratedAt string(date-time) | null
      • timeline object
        Hide timeline attributes Show timeline attributes object
        • events array[object]
          Hide events attributes Show events attributes object
          • date string(date-time)
          • description string
          • sourceRefs array[string]
        • lastRegeneratedAt string(date-time) | null
      • factualNarrative object
        Hide factualNarrative attributes Show factualNarrative attributes object
        • content string | null
        • pendingVersion string | null
        • pendingGeneratedAt string(date-time) | null
        • basedOnEvidenceThrough string(date-time) | null
        • stale boolean
        • modelVersion string | null
        • promptVersion string | null
        • contextProfileVersion number | null
      • evidentiaryMap object
        Hide evidentiaryMap attributes Show evidentiaryMap attributes object
        • elements array[object]
        • lastRegeneratedAt string(date-time) | null
      • attorneyNotes object
        Hide attorneyNotes attributes Show attorneyNotes attributes object
        • theory string | null
        • strategy string | null
        • openQuestions array[string]
        • lastEditedAt string(date-time) | null
        • lastEditedBy string | null
      • openItems object
        Hide openItems attributes Show openItems attributes object
        • items array[object]
          Hide items attributes Show items attributes object
          • id string
          • description string
          • status string

            Values are open, in_progress, resolved, or dismissed.

          • suggestedBy string

            Values are ai_suggested or attorney_added.

          • createdAt string(date-time) | null
          • resolvedAt string(date-time) | null
        • lastRegeneratedAt string(date-time) | null
      • createdAt string(date-time) | null
      • updatedAt string(date-time) | null
    • statusCode number Required
    • timestamp string(date-time) Required
PUT /ai/cases/{caseId}/summary/attorney-notes 
curl \
 --request PUT 'http://api.example.com/ai/cases/{caseId}/summary/attorney-notes' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "theory": "string",
  "strategy": "string",
  "openQuestions": [
    "string"
  ]
}'
Request examples 
{
  "theory": "string",
  "strategy": "string",
  "openQuestions": [
    "string"
  ]
}
Response examples (200) 
{
  "data": {
    "_id": "65a1b2c3d4e5f6a7b8c9d0e1",
    "case": "65a1b2c3d4e5f6a7b8c9d0e2",
    "organization": "65a1b2c3d4e5f6a7b8c9d0e3",
    "version": 1,
    "keyParties": {
      "parties": [
        {
          "name": "string",
          "role": "string",
          "aliases": [
            "string"
          ],
          "frequency": 42.0,
          "significance": "string"
        }
      ],
      "lastRegeneratedAt": "2026-01-15T10:15:00.000Z"
    },
    "timeline": {
      "events": [
        {
          "date": "2026-05-04T09:42:00Z",
          "description": "string",
          "sourceRefs": [
            "string"
          ]
        }
      ],
      "lastRegeneratedAt": "2026-01-15T10:15:00.000Z"
    },
    "factualNarrative": {
      "content": "string",
      "pendingVersion": "string",
      "pendingGeneratedAt": "2026-01-15T10:15:00.000Z",
      "basedOnEvidenceThrough": "2026-01-15T10:15:00.000Z",
      "stale": false,
      "modelVersion": "string",
      "promptVersion": "case_summary.v1",
      "contextProfileVersion": 2
    },
    "evidentiaryMap": {
      "elements": [
        {}
      ],
      "lastRegeneratedAt": "2026-01-15T10:15:00.000Z"
    },
    "attorneyNotes": {
      "theory": "string",
      "strategy": "string",
      "openQuestions": [
        "string"
      ],
      "lastEditedAt": "2026-01-15T10:15:00.000Z",
      "lastEditedBy": "65a1b2c3d4e5f6a7b8c9d0e4"
    },
    "openItems": {
      "items": [
        {
          "id": "string",
          "description": "string",
          "status": "open",
          "suggestedBy": "ai_suggested",
          "createdAt": "2026-01-15T10:15:00.000Z",
          "resolvedAt": "2026-01-15T10:15:00.000Z"
        }
      ],
      "lastRegeneratedAt": "2026-01-15T10:15:00.000Z"
    },
    "createdAt": "2026-01-15T10:15:00.000Z",
    "updatedAt": "2026-01-15T10:15:00.000Z"
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}