integrations

Check whether an email can sign up

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 /auth/check-email-availability
Access token

Says whether an email is free to sign up with. isAvailable is false when it belongs to a user (type: 'user') or to a custodian on an extraction code (type: 'custodian'); type is null when it is available. No auth; limited to 10 requests per minute.

application/json

Body Required

  • email string Required

    The email to check availability for

Responses

  • 200 application/json
    Hide response attributes Show response attributes object
    • data object Required
      Hide data attributes Show data attributes object
      • isAvailable boolean Required

        Whether the email is available

      • message string Required

        The message

      • type string Required

        Type of user (user/custodian)

    • statusCode number Required
    • timestamp string(date-time) Required
POST /auth/check-email-availability 
curl \
 --request POST 'http://api.example.com/auth/check-email-availability' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "email": "test@example.com"
}'
Request examples 
{
  "email": "test@example.com"
}
Response examples (200) 
{
  "data": {
    "isAvailable": true,
    "message": "Email is available",
    "type": "user"
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}