{
  "entries": [
    {
      "id": "mcp-recommend_plan",
      "kind": "mcp",
      "name": "recommend_plan",
      "description": "Recommend the right HelloBooks tier for a business. Pass `needs` (free-text phrases like \"GST filing\", \"multi-currency\", \"API access\", \"multi-entity\", \"payroll\"), an optional `estimatedAnnualTransactions`, and an optional `country` for local pricing. Scores the core ladder (Free → Starter → Pro → Business → Scale) against the stated needs and transaction volume and returns the LOWEST-priced eligible tier that covers the most needs, plus the full ranked breakdown with matched/unmatched needs and per-tier price. Heuristic over published feature bullets, not a quote — confirm with list_plans / list_features. Add-ons and the free Partner Program are excluded from the core ladder.",
      "method": "MCP",
      "path": "/mcp",
      "authentication": "No account required",
      "documentation": "https://agents.hellobooks.ai/#quick-start",
      "details": {
        "inputSchema": {
          "type": "object",
          "properties": {
            "country": {
              "type": "string",
              "enum": [
                "IN",
                "US",
                "GB",
                "AU",
                "AE",
                "CA",
                "SG",
                "NZ",
                "HK",
                "DE",
                "FR",
                "NL",
                "ES",
                "IT",
                "JP",
                "KR",
                "SA",
                "IE",
                "ZA",
                "MY",
                "PH",
                "NG",
                "KE",
                "ID",
                "TH",
                "VN",
                "PK",
                "BD",
                "BR",
                "MX",
                "AR",
                "CL",
                "CO",
                "SE",
                "NO",
                "DK",
                "FI",
                "BE",
                "AT",
                "CH",
                "PL",
                "PT",
                "CZ",
                "RO",
                "HU",
                "GR",
                "TR",
                "UA",
                "IL",
                "EG",
                "BG",
                "HR",
                "SI",
                "SK",
                "LT",
                "LV",
                "EE",
                "RS",
                "MA",
                "QA",
                "KW",
                "JO",
                "OM",
                "BH",
                "TN",
                "DZ",
                "GH",
                "TZ",
                "UG",
                "ET",
                "ZM",
                "ZW",
                "RW",
                "SN",
                "LK",
                "NP",
                "MM",
                "KH",
                "LA",
                "PE",
                "EC",
                "BO",
                "PY",
                "UY",
                "CR",
                "PA",
                "GT",
                "DO",
                "KZ",
                "UZ",
                "BY",
                "MD",
                "BA",
                "MK",
                "AL",
                "LB",
                "IQ",
                "TT",
                "MO",
                "BN",
                "CY",
                "MT",
                "LU",
                "IS",
                "ME",
                "GE",
                "AM",
                "AZ",
                "TM",
                "TJ",
                "KG",
                "MN",
                "CI",
                "CM",
                "TG",
                "BJ",
                "BF",
                "ML",
                "SL",
                "LR",
                "GN",
                "MR",
                "NE",
                "TD",
                "CD",
                "CG",
                "GA",
                "MW",
                "MZ",
                "NA",
                "BW",
                "LS",
                "SZ",
                "MG",
                "AO",
                "MU",
                "SC",
                "CV",
                "HN",
                "SV",
                "NI",
                "JM",
                "BB",
                "GY",
                "SR",
                "FJ",
                "PG",
                "HT",
                "BS",
                "VE",
                "IR",
                "AF",
                "SY",
                "YE",
                "LY",
                "SD",
                "SO",
                "CU",
                "KP",
                "TW",
                "PS",
                "ER",
                "DJ",
                "SS",
                "CF",
                "GQ",
                "BI",
                "KM",
                "ST",
                "GW",
                "EH",
                "WS",
                "TO",
                "VU",
                "SB",
                "KI",
                "TV",
                "NR",
                "PW",
                "FM",
                "MH",
                "AG",
                "LC",
                "VC",
                "KN",
                "DM",
                "GD"
              ],
              "description": "ISO country code, for local pricing. Omit for the USD/default list."
            },
            "needs": {
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 1,
                "maxLength": 80
              },
              "maxItems": 25,
              "description": "What the business needs, as free-text phrases, e.g. [\"GST filing\",\"multi-currency\",\"API access\",\"multi-entity\",\"payroll\"]."
            },
            "estimatedAnnualTransactions": {
              "type": "integer",
              "minimum": 0,
              "maximum": 10000000,
              "description": "Expected ledger transactions per year. Above the Free cap (200) rules out Free."
            }
          },
          "additionalProperties": false,
          "$schema": "http://json-schema.org/draft-07/schema#"
        },
        "call": {
          "jsonrpc": "2.0",
          "id": 1,
          "method": "tools/call",
          "params": {
            "name": "recommend_plan",
            "arguments": {}
          }
        }
      }
    }
  ],
  "total": 1,
  "catalogTotal": 565,
  "page": 1,
  "pageSize": 1,
  "totalPages": 1,
  "nextPage": null,
  "counts": {
    "public": 31,
    "mcp": 43,
    "accounting": 491
  },
  "source": "https://agents.hellobooks.ai/api/catalog.json",
  "reference": "https://agents.hellobooks.ai/api/developer-reference.json",
  "referenceProvenance": {
    "source": "HelloBooks-Backend-Auth-V3/openapi/public-api.openapi.json",
    "sourceCommit": "7abae8f78f7bc401c0184bede82dbaa28cde6e67",
    "importedAt": "2026-09-25T15:40:09.021Z"
  },
  "note": "Public APIs and MCP tools are hosted here. Accounting entries document the authenticated API; use company-scoped credentials at the documented API host."
}