integrations

Verify a certificate file

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 /certificates/verify-document
Access token

Public, no sign-in; at most 10 requests a minute. Checks an uploaded certificate PDF or JSON against the stored certificate (file hash, plus the PDF signature or the JSON content) and returns authentic, tampered or revoked with a message. Returns 400 for a missing file or another file type and 404 when the file names no known certificate.

multipart/form-data

Body Required

  • file string(binary)

Responses

  • 200 application/json
    Hide response attributes Show response attributes object
    • data object Required
      Hide data attributes Show data attributes object
      • status string Required
      • certificateId string Required
      • certificateStatus string Required

        Values are verified, partial, or revoked.

      • signaturePresent boolean Required
      • hashMatch boolean Required
      • documentMatch boolean Required
      • issuedAt string | null Required
      • message string Required
    • statusCode number Required
    • timestamp string(date-time) Required
POST /certificates/verify-document 
curl \
 --request POST 'http://api.example.com/certificates/verify-document' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: multipart/form-data" \
 --form "file=@file"
Response examples (200) 
{
  "data": {
    "status": "authentic",
    "certificateId": "HC-2026-05-15-A1B2-1F3",
    "certificateStatus": "verified",
    "signaturePresent": true,
    "hashMatch": true,
    "documentMatch": true,
    "issuedAt": "2026-05-15T09:30:00.000Z",
    "message": "This document is an authentic, unmodified certificate issued by Hearsay."
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}