List sender and recipient domains

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 /extraction/case/email-domains

Access token

Lists the domains in the from, to, cc and bcc addresses of the emails in the mailboxes linked to the caller's extraction code, with how many emails each appears in.

Query parameters

sourceEmails array[string]

Restrict to these source mailboxes (provider emails). Omit to cover every mailbox in the case.

Responses

200 application/json
Hide response attributes Show response attributes object
- data object Required
  
  Hide data attributes Show data attributes object
  
  data array[object] Required
  
  Hide data attributes Show data attributes object
  
  domain string Required
  
  The email domain (part after @), lowercased.
  
  count number Required
  
  Number of emails with this domain on a from/to/cc/bcc.
  
  totalDomains number Required
  
  Number of distinct domains.
- statusCode number Required
- timestamp string(date-time) Required

GET /extraction/case/email-domains

curl \
 --request GET 'http://api.example.com/extraction/case/email-domains' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "data": {
    "data": [
      {
        "domain": "example.org",
        "count": 128
      }
    ],
    "totalDomains": 12
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}