integrations

Get the current plan and usage

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 /billing/plan/current
Access token

Returns the organization's plan (tier, cadence, billing mode and the card that will be charged) with usage against its caps for seats, storage, this month's AI tokens and cases, and delinquent, which is true when a plan base fee failed more than 7 days ago. plan is null when the organization is not on case billing; usage is still returned. Requires an org admin, owner or billing role.

Headers

  • organization string Required

    id of the selected (active) organization

Responses

  • 200 application/json
    Hide response attributes Show response attributes object
    • data object Required
      Hide data attributes Show data attributes object
      • plan object Required
        Hide plan attributes Show plan attributes object
        • tier string Required

          Values are public, solo, firm, or firm-plus.

        • cadence string Required

          Values are monthly or annual.

        • billingMode string Required

          Values are payg, per-source, or flat-case.

        • paymentMethodOnFile boolean Required

          Whether a usable card is on file, read live from Stripe rather than from the stored flag.

        • paymentMethod object Required

          The card that will actually be charged (the customer default), or null when there is none.

          Hide paymentMethod attributes Show paymentMethod attributes object
          • brand string Required
          • last4 string Required
          • expMonth number Required
          • expYear number Required
      • usage object Required
        Hide usage attributes Show usage attributes object
        • seats object Required
          Hide seats attributes Show seats attributes object
          • used number Required
          • cap number | null Required
        • storageGB object Required
          Hide storageGB attributes Show storageGB attributes object
          • used number Required
          • cap number | null Required
        • aiTokens object Required
          Hide aiTokens attributes Show aiTokens attributes object
          • used number Required
          • budget number Required
        • cases object Required
          Hide cases attributes Show cases attributes object
          • used number Required
          • cap number | null Required
      • delinquent boolean Required
    • statusCode number Required
    • timestamp string(date-time) Required
GET /billing/plan/current 
curl \
 --request GET 'http://api.example.com/billing/plan/current' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "organization: string"
Response examples (200) 
{
  "data": {
    "plan": {
      "tier": "firm",
      "cadence": "monthly",
      "billingMode": "payg",
      "paymentMethodOnFile": true,
      "paymentMethod": {
        "brand": "visa",
        "last4": "4242",
        "expMonth": 4,
        "expYear": 2044
      }
    },
    "usage": {
      "seats": {
        "used": 12,
        "cap": 50
      },
      "storageGB": {
        "used": 12,
        "cap": 50
      },
      "aiTokens": {
        "used": 250000,
        "budget": 1000000
      },
      "cases": {
        "used": 12,
        "cap": 50
      }
    },
    "delinquent": false
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}