{"serverId":"mcp-registry/io.github.hellobooksaiagents/hellobooks-mcp","tools":[{"name":"analyze_balance_sheet","fixed":{"name":"analyze_balance_sheet","description":"Take a Balance Sheet CSV export from QuickBooks Online, Xero, Zoho Books, or Wave (source auto-detected) and run three checks: (1) bs.equation_broken — the fundamental accounting equation Assets = Liabilities + Equity does not hold (every downstream ratio analysis is invalid until fixed); (2) bs.negative_asset — Cash / AR / Inventory line items with negative balances (reconciliation error signal); (3) bs.negative_equity — Total Equity < 0 (insolvency signal). Input is raw CSV text of a Balance S","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["csvText"],"properties":{"csvText":{"type":"string","maxLength":5242880,"minLength":1,"description":"Raw CSV text of a Balance Sheet report. Works with QuickBooks Online (Reports → Balance Sheet), Xero (Reports → Balance Sheet), Zoho Books (Reports → Balance Sheet), and Wave (Reports → Balance Sheet). Statement should include Total Assets, Total Liabilities, and Total Equity rows. Source is auto-detected from section name signatures."},"fileName":{"type":"string","maxLength":200,"description":"Optional filename for the share-page label."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":339,"tokensAfter":339},{"name":"analyze_journal_variance","fixed":{"name":"analyze_journal_variance","description":"Compare two periods of journal-entry data (QBO or Xero — source auto-detected from headers) and flag accounts whose movement deviates materially between periods. Aggregates lines per account into a net total for each period, then surfaces accounts where the period-over-period change crosses a materiality threshold (≥5% relative AND ≥$100 absolute; severity high at ≥50%, medium at ≥20%, low at ≥5%). Inputs are two CSV exports — periodACsv (earlier period) and periodBCsv (later period). Optional p","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["periodACsv","periodBCsv"],"properties":{"periodACsv":{"type":"string","maxLength":5242880,"minLength":1,"description":"Raw CSV text of the EARLIER period's journal-entry export (QBO Journal Entries or Xero Manual Journals). Source is auto-detected from the headers."},"periodBCsv":{"type":"string","maxLength":5242880,"minLength":1,"description":"Raw CSV text of the LATER period's journal-entry export. Source is auto-detected from the headers (must match periodACsv)."},"periodALabel":{"type":"string","maxLength":80,"description":"Optional human label for the earlier period — e.g. \"Q1 FY2024\". Used in flag messages."},"periodBLabel":{"type":"string","maxLength":80,"description":"Optional human label for the later period — e.g. \"Q2 FY2024\"."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":398,"tokensAfter":398},{"name":"analyze_profit_loss","fixed":{"name":"analyze_profit_loss","description":"Take a Profit & Loss / Income Statement CSV export from QuickBooks Online, Xero, Zoho Books, or Wave (source auto-detected from section names) and run three checks: (1) pnl.subtotal_mismatch — each \"Total Section\" subtotal equals the sum of its preceding line items (catches missing or duplicated rows); (2) pnl.negative_expense — flags expense-section line items with negative amounts (usually sign-flips or refunds posted to the wrong side); (3) pnl.margin_red_flag — gross-profit margin < 5% or > ","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["csvText"],"properties":{"csvText":{"type":"string","maxLength":5242880,"minLength":1,"description":"Raw CSV text of a Profit & Loss / Income Statement report. Works with QuickBooks Online (Reports → Profit and Loss), Xero (Reports → Profit and Loss), Zoho Books (Reports → Profit & Loss), and Wave (Reports → Profit & Loss). Source is auto-detected from section names. Statement should include section headers, line items, \"Total X\" subtotals, and a Net Income / Net Profit row at the bottom."},"fileName":{"type":"string","maxLength":200,"description":"Optional filename for the share-page label."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":355,"tokensAfter":355},{"name":"analyze_qbo_journal_anomalies","fixed":{"name":"analyze_qbo_journal_anomalies","description":"Scan a QuickBooks Online \"Journal Entries\" CSV export for anomalies — currently round-number lines (debit or credit amounts that are exact multiples of $1,000, above a $1,000 materiality threshold). Round numbers are statistically rare in real bookkeeping and frequently indicate estimates, plugs, or fraud signals worth review. Input is raw CSV text from QBO Reports → Accountant → Journal. Max 5,000 rows; max 5 MB. Returns flagged lines with severity ($100K+ high, $10K+ medium, else low) and a sh","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["csvText"],"properties":{"csvText":{"type":"string","maxLength":5242880,"minLength":1,"description":"Raw CSV text of a QuickBooks Online \"Journal Entries\" report. Export from QBO: Reports → Accountant → Journal → Export as CSV. Paste the file contents directly."},"fileName":{"type":"string","maxLength":200,"description":"Optional original filename, used only as a label on the share page."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":300,"tokensAfter":300},{"name":"analyze_qbo_journal_cleanup","fixed":{"name":"analyze_qbo_journal_cleanup","description":"Scan a QuickBooks Online \"Journal Entries\" CSV export for cleanup issues — unbalanced journals (debits ≠ credits, with severity by deviation), duplicate journals (same date + same totals, likely posted twice), and schema problems (invalid dates, malformed amounts, missing accounts, missing journal numbers). Input is the raw CSV content the user pastes after exporting from QBO via Reports → Accountant → Journal → Export. Max 5,000 rows; max 5 MB. Returns a structured flag list with severity (high","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["csvText"],"properties":{"csvText":{"type":"string","maxLength":5242880,"minLength":1,"description":"Raw CSV text of a QuickBooks Online \"Journal Entries\" report. Export from QBO: Reports → Accountant → Journal → Export as CSV. Paste the file contents directly."},"fileName":{"type":"string","maxLength":200,"description":"Optional original filename, used only as a label on the share page."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":300,"tokensAfter":300},{"name":"analyze_trial_balance","fixed":{"name":"analyze_trial_balance","description":"Take a Trial Balance CSV export from QuickBooks Online, Xero, Zoho Books, or Wave (source auto-detected from headers — YTD columns indicate Xero, Opening Balance indicates Zoho, etc.) and run three checks: (1) tb.unbalanced — debits ≠ credits (every downstream P&L / BS / cash-flow report built from this TB is wrong until fixed); (2) tb.wrong_sign — accounts whose name suggests a class (Revenue / COGS / Expense / AR / AP) carrying a balance on the wrong side (classic posting-error signal); (3) tb","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["csvText"],"properties":{"csvText":{"type":"string","maxLength":5242880,"minLength":1,"description":"Raw CSV text of a Trial Balance report. Works with QuickBooks Online (Reports → Trial Balance), Xero (Reports → Trial Balance), Zoho Books (Reports → Accountant → Trial Balance), and Wave (Reports → Trial Balance). Source is auto-detected from column headers."},"fileName":{"type":"string","maxLength":200,"description":"Optional filename for the share-page label."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":318,"tokensAfter":318},{"name":"analyze_xero_journal_anomalies","fixed":{"name":"analyze_xero_journal_anomalies","description":"Scan a Xero \"Manual Journals\" CSV export for anomalies — currently round-number lines (debit or credit amounts that are exact multiples of $1,000, above a $1,000 materiality threshold). Input is raw CSV text from Xero Accounting → Advanced → Manual Journals → Export. Max 5,000 rows; max 5 MB. Returns flagged lines with severity ($100K+ high, $10K+ medium, else low) and a shareable URL. Use this when a user pastes Xero data and asks \"any anomalies?\", \"look for round numbers\", or \"anything suspici","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["csvText"],"properties":{"csvText":{"type":"string","maxLength":5242880,"minLength":1,"description":"Raw CSV text of a Xero \"Manual Journals\" report. Export from Xero: Accounting → Advanced → Manual Journals → Export. Paste the file contents directly."},"fileName":{"type":"string","maxLength":200,"description":"Optional original filename, used only as a label on the share page."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":299,"tokensAfter":299},{"name":"analyze_xero_journal_cleanup","fixed":{"name":"analyze_xero_journal_cleanup","description":"Scan a Xero \"Manual Journals\" CSV export for cleanup issues — unbalanced journals, duplicate journals (same date + same totals), and schema problems (invalid dates, malformed amounts, missing account code/name, missing group key). Input is the raw CSV content the user pastes after exporting from Xero via Accounting → Advanced → Manual Journals → Export. Xero-specific idioms handled: signed Amount column (positive = credit, negative = debit), explicit Debit/Credit fallback shape, Reference-or-Nar","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["csvText"],"properties":{"csvText":{"type":"string","maxLength":5242880,"minLength":1,"description":"Raw CSV text of a Xero \"Manual Journals\" report. Export from Xero: Accounting → Advanced → Manual Journals → Export. Paste the file contents directly."},"fileName":{"type":"string","maxLength":200,"description":"Optional original filename, used only as a label on the share page."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":297,"tokensAfter":297},{"name":"compare_books_to_hellobooks","fixed":{"name":"compare_books_to_hellobooks","description":"Take a QBO or Xero journal-entry CSV (source auto-detected), run the full Tier-0 detection set (imbalance + duplicates + round-number + schema), and return a structured side-by-side comparison — \"your books have X issues; here is how HelloBooks resolves each phase\". This is the direct funnel tool: the response includes per-category counts mapped to HelloBooks Phases 1, 2, 3.0, 3.1, with exclusive-advantage bullets (command-center dashboard, conversational interface, one-prompt JE posting, cross-","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["csvText"],"properties":{"csvText":{"type":"string","maxLength":5242880,"minLength":1,"description":"Raw CSV text of a journal-entry export from QBO (\"Journal Entries\") or Xero (\"Manual Journals\"). Source is auto-detected from the headers."},"fileName":{"type":"string","maxLength":200,"description":"Optional filename label."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":282,"tokensAfter":282},{"name":"country_support","fixed":{"name":"country_support","description":"Return features available per supported country (AU, IN, UK, US, CA, AE, SG, NZ).","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"country":{"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"],"type":"string","description":"Single ISO country code. Omit for the full matrix."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":359,"tokensAfter":359},{"name":"estimate_migration_effort","fixed":{"name":"estimate_migration_effort","description":"Take a QBO or Xero journal-entry CSV (source auto-detected) and return a structured migration-effort estimate — row counts, unique-account count, period span, complexity classification (low / medium / high), human-hours estimate, assisted-hours estimate, and an indicative price quote in USD. Heuristic-based — refined against the live entity once the user signs up. Accepts larger files than the other analytical tools (up to 50,000 rows / 20 MB) because no detection runs here, just sizing. Use thi","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["csvText"],"properties":{"csvText":{"type":"string","maxLength":20971520,"minLength":1,"description":"Raw CSV text of a journal-entry export from QBO (\"Journal Entries\") or Xero (\"Manual Journals\"). Source is auto-detected from headers."},"fileName":{"type":"string","maxLength":200}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":269,"tokensAfter":269},{"name":"feature_search","fixed":{"name":"feature_search","description":"Free-text search across the marketing feature catalog, plan features, integrations, country features, compliance frameworks, competitor positioning, statutory deadlines, local payment methods, and published articles on hellobooks.ai. Queries like \"vs Xero\", \"QuickBooks alternative\", \"GSTR-3B due\", \"UPI invoice\", \"1099 article\", or \"agentic accounting\" surface the matching entry near the top.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["query"],"properties":{"limit":{"type":"integer","maximum":50,"minimum":1,"description":"Max results to return (default 20)."},"query":{"type":"string","maxLength":120,"minLength":2,"description":"Free-text query, e.g. \"BAS lodgement\", \"multi-currency\", \"vs QuickBooks\", \"GSTR-3B due\", or \"UPI invoice cap\"."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":249,"tokensAfter":249},{"name":"list_articles","fixed":{"name":"list_articles","description":"List published articles on hellobooks.ai — head-to-head compare pages and curated flagship blog posts. Filter by country, tag or free-text query. Use this when a user asks \"do you have a blog/article about X?\".","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"tag":{"type":"string","maxLength":40,"minLength":2,"description":"Single tag to filter on (case-insensitive substring match against the article tag list). e.g. \"gst\", \"1099\", \"tally\"."},"limit":{"type":"integer","maximum":100,"minimum":1,"description":"Max articles to return (default 20)."},"query":{"type":"string","maxLength":120,"minLength":2,"description":"Free-text query — substring-matched against the title, excerpt and tags of each article. e.g. \"QuickBooks alternative\" or \"audit trail\"."},"country":{"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","global"],"type":"string","description":"ISO country code or \"global\". Returns articles whose countryRelevance matches OR is \"global\". Omit to return everything."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":560,"tokensAfter":560},{"name":"list_competitors","fixed":{"name":"list_competitors","description":"Return competitor positioning entries (QuickBooks, Xero, FreshBooks, Wave, Zoho Books, Tally) with where HelloBooks wins, where the competitor wins, and pricing notes. Optional country, tier (primary / secondary), and id filters.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"id":{"type":"string","description":"Return a single competitor by id (e.g. \"quickbooks\", \"xero\", \"tally\")."},"tier":{"enum":["primary","secondary"],"type":"string","description":"Filter to head-on rivals (primary) or adjacent / segment-specific overlaps (secondary)."},"country":{"enum":["IN","US","CA","GB","AU","AE","SG","NZ"],"type":"string","description":"Only return competitors whose primary market is this country, or who are also evaluated in this market."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":243,"tokensAfter":243},{"name":"list_credit_packs","fixed":{"name":"list_credit_packs","description":"List HelloBooks AI credit packs — one-time pay-as-you-go top-ups (Boost 5,000, Power 15,000, Mega 50,000, Ultra 150,000 credits). The 8 priced regions return local currency prices; other supported country hubs return the USD/default list price with pricingCountry=US fallback metadata. Credit packs stack on any plan, including Free. Use this when a user asks how to buy more AI credits or top up after exhausting a plan allowance. Filter by `id` (boost / power / mega / ultra) or any supported `coun","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"id":{"enum":["boost","power","mega","ultra"],"type":"string","description":"Restrict the response to a single credit pack."},"country":{"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"],"type":"string","description":"ISO country code. Filters prices to one country. Countries without local pricing return the USD/default list price with fallback metadata. Omit to return priced markets."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":544,"tokensAfter":544},{"name":"list_feature_categories","fixed":{"name":"list_feature_categories","description":"List the 13 feature categories on the marketing site (Core Accounting, Invoicing, Banking, Reports, Tax & Compliance, Inventory, Warehouse, Manufacturing, AI, Integrations, Mobile, Operations, Industry Modules) with per-category counts by status.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":119,"tokensAfter":119},{"name":"list_features","fixed":{"name":"list_features","description":"List the full HelloBooks marketing feature catalog (145+ items). Filter by category, tier, status, marketedOnly, or substring query.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"tier":{"enum":["free","pro","business","cpa","warehouse-addon","manufacturing-addon"],"type":"string","description":"Filter by the minimum plan tier / add-on that unlocks the feature."},"limit":{"type":"integer","maximum":200,"minimum":1,"description":"Max number of features to return. Default 200."},"query":{"type":"string","maxLength":120,"minLength":2,"description":"Optional substring match against label + shortDescription."},"status":{"enum":["live","beta","planned"],"type":"string","description":"Filter by rollout status. Defaults to all."},"category":{"enum":["core-accounting","invoicing-billing","banking-reconciliation","reports","tax-compliance","inventory","warehouse","manufacturing","ai-automation","integrations","mobile","operations","industry-modules"],"type":"string","description":"Filter to one feature category (core-accounting, invoicing-billing, etc.)."},"marketedOnly":{"type":"boolean","description":"If true, only return features marketed on the public website."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":361,"tokensAfter":361},{"name":"list_integrations","fixed":{"name":"list_integrations","description":"List integrations (banks, payments, payroll, time tracking, shipping, accounting sync, ecommerce, CRM).","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"status":{"enum":["live","beta","coming-soon"],"type":"string","description":"Filter by rollout status."},"country":{"enum":["IN","US","CA","GB","AU","AE","SG","NZ"],"type":"string","description":"Only return integrations available in this country (or global)."},"category":{"enum":["banking","payment","payroll","time-tracking","shipping","tax-compliance","accounting-sync","ecommerce","crm","storage","freelance"],"type":"string","description":"Filter to one integration category."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":212,"tokensAfter":212},{"name":"list_plans","fixed":{"name":"list_plans","description":"List HelloBooks pricing plans with monthly + annual prices. The 8 priced regions return local currency prices (USD, INR, CAD, GBP, AUD, AED, SGD, NZD); other supported country hubs return the USD/default list price with pricingCountry=US fallback metadata while local books use the country currency. Covers the five-rung ladder — Free / Starter / Pro / Business / Scale — plus the free Partner Program (`cpa` plan id) and two per-entity stackable add-ons (Warehouse, Manufacturing). Returns AI credit","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"plan":{"enum":["free","starter","pro","business","scale","cpa"],"type":"string","description":"Restrict the response to a single plan tier (`cpa` = free Partner Program). Countries without local pricing use the USD/default list price."},"country":{"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"],"type":"string","description":"ISO country code. Filters prices to one country. Countries without local pricing return the USD/default list price with fallback metadata. Omit to return priced markets."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":573,"tokensAfter":573},{"name":"list_tax_rates","fixed":{"name":"list_tax_rates","description":"List statutory tax-rate slabs by jurisdiction — IN GST (5/12/18/28 + zero + exempt + composition trader/manufacturer/restaurant + compensation cess), UK VAT (20 / 5 / zero / exempt), AU GST (10 / GST-free / input-taxed), US sales-tax (state-administered summary, no federal rate), CA GST 5% + HST 13% ON / 15% Atlantic / 14% NS + provincial PST 7% BC / 6% SK / RST 7% MB + QST 9.975% QC, SG GST 9% (+ superseded 8% / zero / exempt), NZ GST 15% (+ zero / exempt), AE VAT 5% (+ zero / exempt). Filter b","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"scheme":{"enum":["standard","reduced","zero","exempt","input-taxed","composition","cess","state-summary"],"type":"string","description":"Filter by slab category — standard, reduced, zero, exempt, input-taxed, composition, cess."},"country":{"enum":["IN","US","CA","GB","AU","AE","SG","NZ"],"type":"string","description":"Filter to one jurisdiction. Omit to return every supported country."},"taxType":{"enum":["GST","IGST","CGST-SGST","VAT","Sales-Tax","HST","PST","QST","TDS","TCS"],"type":"string","description":"Filter by statutory tax type (GST, VAT, Sales-Tax, HST, PST, QST, etc.)."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":351,"tokensAfter":351},{"name":"list_videos","fixed":{"name":"list_videos","description":"List HelloBooks product videos curated on the marketing site (homepage demo + feature walkthroughs) and the official @hellobooksai YouTube channel link. Each video returns title, description, category, watch URL, embed URL and thumbnail. Filter by category (demo / features / overview), featuredOnly, or free-text query. Use this when a user asks for a demo, walkthrough or video. Note: this is the curated set, not a live mirror of every channel upload — the response includes the channel URL for th","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"query":{"type":"string","maxLength":120,"minLength":2,"description":"Optional substring match against video title + description."},"category":{"enum":["demo","features","overview"],"type":"string","description":"Filter to one video category (demo, features, overview)."},"featuredOnly":{"type":"boolean","description":"If true, only return videos flagged as featured on the marketing site."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":295,"tokensAfter":295},{"name":"local_payment_methods","fixed":{"name":"local_payment_methods","description":"List local bank-rail / wallet payment methods relevant to HelloBooks invoice collection (AR), B2B supplier payments (AP), and contractor payouts (UPI, RuPay, Razorpay, IMPS, NEFT, RTGS, BACS, FPS, CHAPS, Open Banking, Interac e-Transfer, EFT, PayID, PayTo, NPP, BPAY, ACH, Same Day ACH, Fedwire, RTP, Zelle, PayNow, FAST, GIRO, NZ Direct Credit, etc.). Returns rail (instant / same-day / next-day / multi-day), use-cases, issuing authority, HelloBooks support level, and operational notes (per-transa","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"id":{"type":"string","description":"Return a single payment method by id (e.g. \"in-upi\", \"au-payid\", \"us-rtp\")."},"rail":{"enum":["instant","same-day","next-day","multi-day"],"type":"string","description":"Filter by settlement rail (instant, same-day, next-day, multi-day)."},"country":{"enum":["IN","US","CA","GB","AU","AE","SG","NZ"],"type":"string","description":"Filter to one country (IN, US, CA, GB, AU, AE, SG, NZ)."},"useCase":{"enum":["payroll","contractor-payout","invoice-collection","b2b-supplier","p2p"],"type":"string","description":"Filter by payment use-case. Defaults to HelloBooks' invoice-collection + b2b-supplier + contractor-payout scope; pass an explicit value to widen."}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":384,"tokensAfter":384},{"name":"lookup_tax_rate","fixed":{"name":"lookup_tax_rate","description":"Pick a single statutory tax-rate slab — either by exact `id` (e.g. `IN-standard-18`, `GB-zero-0`, `CA-hst-13-on`) for a deterministic lookup, or by `country` + free-text `category` (e.g. \"office supplies\", \"restaurant\", \"exports\", \"domestic fuel\") for a fuzzy best-match. Returns the matched rate, the match score, and the authoritative `source` URL. Use this when a user asks \"what slab does X fall into in India?\" or \"what VAT rate applies to children's car seats?\". For broader exploration (all sl","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"id":{"type":"string","minLength":3,"description":"Exact rate id, e.g. ``IN-standard-18`` or ``GB-zero-0``. When set, country/category are ignored."},"country":{"enum":["IN","US","CA","GB","AU","AE","SG","NZ"],"type":"string","description":"Country to search within. Required when ``id`` is not provided."},"category":{"type":"string","maxLength":120,"minLength":2,"description":"Free-text query — \"office supplies\", \"restaurant\", \"exports\", \"domestic fuel\"."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":320,"tokensAfter":320},{"name":"partner_program_info","fixed":{"name":"partner_program_info","description":"Return the HelloBooks Partner Program structure — free reseller channel for accountants/CPAs/bookkeepers who put their clients on Pro/Business plans. Earned wholesale discount model (no commission): Bronze 5% at 25 pts / Silver 10% at 75 / Gold 15% at 300 / Platinum 20% at 1,000+. Pro client = 1 pt/mo, Business client = 4 pts/mo. Call with no args for the full ladder + meta; with `points` for current status + how many points to next tier; with `proClients` and/or `businessClients` to derive poin","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"points":{"type":"number","minimum":0,"description":"Current Partner Points total. If supplied, the response includes the partner's status + how many more points are needed to reach the next tier."},"proClients":{"type":"number","minimum":0,"description":"Active Pro-plan clients (1 point each per month). Combined with `businessClients` to derive points if `points` is not supplied directly."},"businessClients":{"type":"number","minimum":0,"description":"Active Business-plan clients (4 points each per month). Combined with `proClients` to derive points."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":344,"tokensAfter":344},{"name":"practice_management_info","fixed":{"name":"practice_management_info","description":"Return HelloCPA Practice Management info — the standalone product at practice.hellobooks.ai for running a CPA / CA / bookkeeping practice (proposals + CPQ, workflow, time tracking, billing, 6-role RBAC, Gmail/Outlook/Calendar sync, CSV migration from TaxDome / Karbon / Canopy). NOT the Partner Program and NOT a tier in list_plans. Per-user pricing model — US shipped at $9.99/user/month (free up to 2 users + 10 clients, 90-day trial, enterprise at 50+ users). 7 other markets (IN, GB, AU, CA, AE, ","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"country":{"enum":["IN","US","CA","GB","AU","AE","SG","NZ"],"type":"string","description":"ISO country code. Omit to get the full 8-region matrix. US is shipped; the other 7 are roadmap as of 2026-06-12."}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":247,"tokensAfter":247}],"toolsChanged":25,"tokensSaved":0,"todo":[{"tool":"estimate_migration_effort","params":["fileName"]}],"note":"Deterministic fixes. Changes marked verify need a human look before shipping (renames, inferred annotations, inferred types, removed text). Parameter descriptions in `todo` need to be written by someone who knows the API."}