List legal provider connections

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 /legal/status

Access token

Lists one entry per legal provider (Clio, Smokeball) the organization has connected: its status (degraded when no user connection is primary), the provider account id, when it was connected, how many users are connected, the primary user connection and whether the matter and document webhooks are registered. An empty list means none is connected. Requires a member role or above in the organization.

Headers

organization string Required

id of the selected (active) organization

Responses

200 application/json
Hide response attributes Show response attributes object
- data object Required
  
  Hide data attribute Show data attribute object
  
  connections array[object]
  
  Hide connections attributes Show connections attributes object
  
  provider string
  
  Values are clio or smokeball.
  
  status string
  
  Values are connected, not_connected, or degraded.
  
  remoteAccountId string
  
  connectedAt string(date-time)
  
  activeUserCount number
  
  primaryUser object
  
  Absent when status is degraded.
  
  Hide primaryUser attributes Show primaryUser attributes object
  
  hearsayUserId string
  
  remoteUserId string
  
  tokenExpiresAt string(date-time)
  
  lastUsedAt string(date-time)
  
  webhooks object
  
  Hide webhooks attributes Show webhooks attributes object
  
  matters boolean
  
  documents boolean
- statusCode number Required
- timestamp string(date-time) Required

GET /legal/status

curl \
 --request GET 'http://api.example.com/legal/status' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "organization: string"

Response examples (200)

{
  "data": {
    "connections": [
      {
        "provider": "clio",
        "status": "connected",
        "remoteAccountId": "3456789",
        "connectedAt": "2026-01-15T10:15:00.000Z",
        "activeUserCount": 2,
        "primaryUser": {
          "hearsayUserId": "65a1b2c3d4e5f6a7b8c9d0e4",
          "remoteUserId": "345678901",
          "tokenExpiresAt": "2026-01-15T10:15:00.000Z",
          "lastUsedAt": "2026-01-15T10:15:00.000Z"
        },
        "webhooks": {
          "matters": true,
          "documents": true
        }
      }
    ]
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}