integrations

Suggest tags for a conversation chunk

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
POST /ai/cases/{caseId}/chunks/{chunkId}/suggest-tags
Access token

Returns active system, organization and case tags ranked by confidence with the reasoning, plus names for tags that do not exist yet. Nothing is applied. Results are cached; forceRefresh asks the model again. Returns 404 when the chunk is not in the case or its source is not supported. Requires commenter access or above to the case and an active plan (403 otherwise); not available to opposing counsel.

Path parameters

  • caseId string Required
  • chunkId string Required
application/json

Body Required

  • forceRefresh boolean

    Bypass the cache and force a fresh Claude call.

    Default value is false.

Responses

  • 200 application/json
    Hide response attributes Show response attributes object
    • data object Required
      Hide data attributes Show data attributes object
      • suggestions array[object]
        Hide suggestions attributes Show suggestions attributes object
        • tagId string
        • tagName string
        • tagSeverity string
        • tagBackgroundColor string
        • tagTextColor string
        • confidence number
        • reasoning string
      • noveltyHints array[object]
        Hide noveltyHints attributes Show noveltyHints attributes object
        • proposedTagName string
        • reasoning string
      • cached boolean
      • model string | null
    • statusCode number Required
    • timestamp string(date-time) Required
POST /ai/cases/{caseId}/chunks/{chunkId}/suggest-tags 
curl \
 --request POST 'http://api.example.com/ai/cases/{caseId}/chunks/{chunkId}/suggest-tags' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "forceRefresh": false
}'
Request examples 
{
  "forceRefresh": false
}
Response examples (200) 
{
  "data": {
    "suggestions": [
      {
        "tagId": "65a1b2c3d4e5f6a7b8c9d0e6",
        "tagName": "Threats",
        "tagSeverity": "string",
        "tagBackgroundColor": "#FDE2E1",
        "tagTextColor": "#9B1C1C",
        "confidence": 0.87,
        "reasoning": "string"
      }
    ],
    "noveltyHints": [
      {
        "proposedTagName": "Missed pickups",
        "reasoning": "string"
      }
    ],
    "cached": false,
    "model": "string"
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}