integrations

Choose or change the plan

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

Puts the organization on a self-serve tier in pay-as-you-go mode, or changes its tier or cadence (monthly by default, annual for an annual-only tier); a change settles the current base fee at once and returns the net amount in prorationCents (0 on a first selection), and a first selection also moves the organization off any legacy subscription. When no card is on file, paymentRequired is true and setupSessionUrl links to a card setup page, so successUrl and cancelUrl are then required (400 otherwise). Requires an org admin, owner or billing role; returns 403 while self-serve plan selection is not available and 400 for a monthly cadence on an annual-only tier.

Headers

  • organization string Required

    id of the selected (active) organization

application/json

Body Required

  • tier string Required

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

  • cadence string

    Values are monthly or annual.

  • successUrl string
  • cancelUrl string

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.

      • paymentRequired boolean Required
      • setupSessionUrl string
      • prorationCents number Required

        Net cents charged (positive) or credited (negative) now to reconcile the base fee on a plan change; 0 on a first-time plan selection.

    • statusCode number Required
    • timestamp string(date-time) Required
POST /billing/plan 
curl \
 --request POST 'http://api.example.com/billing/plan' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --header "organization: string" \
 --data '{
  "tier": "public",
  "cadence": "monthly",
  "successUrl": "string",
  "cancelUrl": "string"
}'
Request examples 
# Headers
organization: string

# Payload
{
  "tier": "public",
  "cadence": "monthly",
  "successUrl": "string",
  "cancelUrl": "string"
}
Response examples (200) 
{
  "data": {
    "plan": {
      "tier": "firm",
      "cadence": "monthly",
      "billingMode": "payg"
    },
    "paymentRequired": true,
    "setupSessionUrl": "https://checkout.stripe.com/c/pay/cs_test_a1Example",
    "prorationCents": 15000
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}