List the active AI prompts (internal)

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/admin/prompts

Access token

Lists the active stored prompt version of each purpose, sorted by purpose. Only stored versions are listed; a purpose with none runs on its code default. Super admins only.

Responses

200 application/json
Hide response attributes Show response attributes object
- data array[object] Required
  
  Hide data attributes Show data attributes object
  
  _id string
  
  purpose string
  
  Values are chunk_summary, period_summary, conversation_summary, case_summary, case_context_filing_extraction, relevance_gate, evidentiary_map_element, or tag_suggestion.
  
  versionSlug string
  
  systemPrompt string
  
  toolName string
  
  toolDescription string
  
  toolInputSchema object
  
  JSON Schema of the tool input.
  
  model string
  
  maxTokens number
  
  temperature number
  
  isActive boolean
  
  notes string
  
  createdBy string | null
  
  updatedBy string | null
  
  createdAt string(date-time) | null
  
  updatedAt string(date-time) | null
- statusCode number Required
- timestamp string(date-time) Required

GET /ai/admin/prompts

curl \
 --request GET 'http://api.example.com/ai/admin/prompts' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "data": [
    {
      "_id": "65a1b2c3d4e5f6a7b8c9d0e1",
      "purpose": "case_summary",
      "versionSlug": "case_summary.v2",
      "systemPrompt": "string",
      "toolName": "string",
      "toolDescription": "string",
      "toolInputSchema": {},
      "model": "sonnet",
      "maxTokens": 1024,
      "temperature": 0.2,
      "isActive": true,
      "notes": "string",
      "createdBy": "65a1b2c3d4e5f6a7b8c9d0e4",
      "updatedBy": "65a1b2c3d4e5f6a7b8c9d0e4",
      "createdAt": "2026-01-15T10:15:00.000Z",
      "updatedAt": "2026-01-15T10:15:00.000Z"
    }
  ],
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}