integrations

List data sources

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
GET /data-source
Access token

Lists every data source Hearsay can collect from (for example iOS and Android devices, Gmail, Facebook exports), sorted by category. Reference data; the list rarely changes.

Headers

  • organization string Required

    id of the selected (active) organization

Responses

  • 200 application/json
    Hide response attributes Show response attributes object
    • data array[object] Required
      Hide data attributes Show data attributes object
      • createdAt string(date-time) Required
      • updatedAt string(date-time) Required
      • id string Required
      • name string Required
      • displayName string Required
      • category string Required
      • config object | null Required

        Collection options for this source. The keys below are the ones the code reads, for device sources (ios, android).

        Additional properties are allowed.

        Hide config attributes Show config attributes object | null
        • iosEnableEncryptedBackup boolean
        • iosAllowOnlyEncryptedBackup boolean
        • iosAutoIncludeSafariData boolean
        • iosAutoIncludeNotesData boolean
        • androidIgnoreMediaPermission boolean
        • iosAllApps array[string]
        • iosAllowedApps array[string]
        • androidAllApps array[string]
        • androidAllowedApps array[string]
    • statusCode number Required
    • timestamp string(date-time) Required
GET /data-source 
curl \
 --request GET 'http://api.example.com/data-source' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "organization: string"
Response examples (200) 
{
  "data": [
    {
      "createdAt": "2026-01-15T14:30:00.000Z",
      "updatedAt": "2026-01-15T14:30:00.000Z",
      "id": "507f1f77bcf86cd799439011",
      "name": "gmail",
      "displayName": "Gmail",
      "category": "email",
      "config": {
        "iosEnableEncryptedBackup": true,
        "iosAllowOnlyEncryptedBackup": false,
        "iosAllApps": [
          "messages",
          "call_log",
          "whatsapp",
          "photos"
        ],
        "iosAllowedApps": [
          "messages",
          "call_log"
        ]
      }
    }
  ],
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}