integrations

Run the monthly storage check now (internal)

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 /admin/billing/cron/storage-close
Access token

Checks the storage used in yearMonth (default: the current UTC month) against each organization's storage cap, for every organization or only organizationId, and sends one alert listing the organizations over their cap; nothing is charged. Returns how many organizations were checked and how many were over. Not available in production (403). Super admin only.

application/json

Body Required

  • yearMonth string

    UTC month YYYY-MM (default: current month)

  • organizationId string

    Scope the close to one organization (default: all)

Responses

  • 200 application/json
    Hide response attributes Show response attributes object
    • data object Required
      Hide data attributes Show data attributes object
      • orgsChecked integer
      • breaches integer
    • statusCode number Required
    • timestamp string(date-time) Required
POST /admin/billing/cron/storage-close 
curl \
 --request POST 'http://api.example.com/admin/billing/cron/storage-close' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "yearMonth": "string",
  "organizationId": "string"
}'
Request examples 
{
  "yearMonth": "string",
  "organizationId": "string"
}
Response examples (200) 
{
  "data": {
    "orgsChecked": 12,
    "breaches": 1
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}