integrations

Get the AI case summary

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
GET /ai/cases/{caseId}/summary
Access token

Returns the layered case summary: key parties, timeline, factual narrative (with any pending regenerated version), evidentiary map, attorney notes and open items. A case with no summary yet gets an empty one. Requires commenter access or above to the case and an active plan (403 otherwise); not available to opposing counsel.

Path parameters

  • caseId string Required

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
GET /ai/cases/{caseId}/summary 
curl \
 --request GET 'http://api.example.com/ai/cases/{caseId}/summary' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
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"
}