Get the evidentiary map

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

{
  "integrations MCP server": {
    "url": "https://docs.usehearsay.com/mcp"
  }
}

GET /ai/cases/{caseId}/evidentiary-map

Access token

Returns, for each element of each legal claim, the supporting and contradicting evidence, its strength and the AI assessment, plus any attorney override. Returns 404 when the case has no summary yet. 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 evidentiary map section of the case summary.
  
  Hide data attributes Show data attributes object
  
  elements array[object]
  
  Hide elements attributes Show elements attributes object
  
  claimId string
  
  elementId string
  
  elementDescription string
  
  supportingEvidence array[object]
  
  Hide supportingEvidence attributes Show supportingEvidence attributes object
  
  kind string
  
  Values are message, chunk, or file.
  
  ref string
  
  source string
  
  Values are device_message, linkedin, reddit, discord, email, or ai_chat.
  
  snippet string | null
  
  relevanceScore number
  
  reasoning string | null
  
  contradictingEvidence array[object]
  
  Hide contradictingEvidence attributes Show contradictingEvidence attributes object
  
  kind string
  
  Values are message, chunk, or file.
  
  ref string
  
  source string
  
  Values are device_message, linkedin, reddit, discord, email, or ai_chat.
  
  snippet string | null
  
  relevanceScore number
  
  reasoning string | null
  
  strength string
  
  Values are gap, weak, moderate, or strong.
  
  aiAssessment string | null
  
  attorneyOverride string | null
  
  lastRegeneratedAt string(date-time) | null
  
  stale boolean
  
  lastRegeneratedAt string(date-time) | null
- statusCode number Required
- timestamp string(date-time) Required

GET /ai/cases/{caseId}/evidentiary-map

curl \
 --request GET 'http://api.example.com/ai/cases/{caseId}/evidentiary-map' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "data": {
    "elements": [
      {
        "claimId": "claim-1",
        "elementId": "claim-1-el-1",
        "elementDescription": "string",
        "supportingEvidence": [
          {
            "kind": "message",
            "ref": "string",
            "source": "device_message",
            "snippet": "string",
            "relevanceScore": 0.82,
            "reasoning": "string"
          }
        ],
        "contradictingEvidence": [
          {
            "kind": "message",
            "ref": "string",
            "source": "device_message",
            "snippet": "string",
            "relevanceScore": 0.82,
            "reasoning": "string"
          }
        ],
        "strength": "moderate",
        "aiAssessment": "string",
        "attorneyOverride": "string",
        "lastRegeneratedAt": "2026-01-15T10:15:00.000Z",
        "stale": false
      }
    ],
    "lastRegeneratedAt": "2026-01-15T10:15:00.000Z"
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}