integrations

Create an AI prompt draft (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

mcp.json 
{
  "integrations MCP server": {
    "url": "https://docs.usehearsay.com/mcp"
  }
}
Close
POST /ai/admin/prompts/{purpose}/drafts
Access token

Creates an inactive version with the next versionSlug for the purpose, copied from seedFromVersionSlug (or the active version, or the code default) with the given changes applied. It takes no traffic until activated. Renaming or removing top-level tool input properties returns 400. An unknown purpose returns 400. Super admins only.

Path parameters

  • purpose string Required

    Values are chunk_summary, period_summary, conversation_summary, case_summary, case_context_filing_extraction, relevance_gate, evidentiary_map_element, or tag_suggestion.

application/json

Body Required

  • systemPrompt string
  • toolDescription string
  • toolInputSchema object

    Claude tool-use input_schema (JSON Schema). Renaming or removing top-level properties triggers 400.

  • model string

    'haiku' / 'sonnet' alias or a literal Bedrock model id

  • maxTokens number

    Minimum value is 1, maximum value is 32000.

  • temperature number

    Minimum value is 0, maximum value is 2.

  • notes string
  • seedFromVersionSlug string

    Seed the new draft from this version slug. Defaults to the currently active version.

Responses

  • 201 application/json
    Hide response attributes Show response attributes object
    • data 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
POST /ai/admin/prompts/{purpose}/drafts 
curl \
 --request POST 'http://api.example.com/ai/admin/prompts/{purpose}/drafts' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "systemPrompt": "string",
  "toolDescription": "string",
  "toolInputSchema": {},
  "model": "string",
  "maxTokens": 42.0,
  "temperature": 42.0,
  "notes": "string",
  "seedFromVersionSlug": "string"
}'
Request examples 
{
  "systemPrompt": "string",
  "toolDescription": "string",
  "toolInputSchema": {},
  "model": "string",
  "maxTokens": 42.0,
  "temperature": 42.0,
  "notes": "string",
  "seedFromVersionSlug": "string"
}
Response examples (201) 
{
  "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": 201,
  "timestamp": "2026-01-15T10:15:00.000Z"
}