Watch
1
0
Fork
You've already forked arc
0
forked from hesabix/arc
arc/extraScripts/claudeCodePlugin/docs/registry-catalog.md

24 KiB

Hesabix AI/MCP tool catalog (generated)

Generated by scripts/generate_registry_catalog.py from the checked-in AI registry and Tool Manifest. This is a source-level inventory, not a promise that every item appears for every account. The live MCP server additionally filters by enabled/deprecated status, business context, role, and current user permissions. The runtime is authoritative.

Permission model

  • ai:tools:read: baseline MCP scope. It exposes only tools classified read-only by _mcp_readonly.
  • ai:tools:write: separately consented MCP scope. OAuth users select write tools during the consent flow; manual bearer connections with write access can only be created by the business owner. Each tool still passes current Hesabix permission checks.
  • A direct MCP tools/call executes an authorized write handler without running the in-chat approval flow. The MCP client must preview the exact action and arguments and obtain transaction-specific user confirmation before sending the call; the server does not independently verify that confirmation.
  • MCP write-scope classification means the server does not mark the tool read-only. It does not always mean a financial record is written: session-plan/todo tools mutate conversation state, while exports, workflow execution, and generic connectors can create artifacts or external effects.
  • required_permissions: per-tool business permission keys checked by the API, such as reports.read or inventory.read. These are independent of the two MCP OAuth scopes.
  • The model cannot grant a scope, select a different tenant, or turn a read call into an authorized write by supplying arguments.
  • ask_hesabix_agent is analyzer-only and is hidden for credentials with an explicit per-tool allowlist, including OAuth grants. The server exposes hesabix://business/overview and hesabix://mcp/capabilities; prompt availability depends on the connection's visible tool categories. See mcp-prompts.md.

Source-declared business tools potentially visible to a business user/owner: 136 (106 read-scope, 30 write-scope). These are potential candidates; live role/permission filtering may remove them.

Columns: tool name, MCP scope needed, application permissions, roles in source declaration, source category, and permission policy.

accounting

Tool MCP scope Hesabix permissions Roles Permission policy
get_current_fiscal_year ai:tools:read fiscal_years.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_document_details ai:tools:read accounting_documents.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_opening_balance ai:tools:read opening_balance.view ADMIN, BUSINESS_OWNER, USER required
list_fiscal_years ai:tools:read fiscal_years.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
search_documents ai:tools:read accounting_documents.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required

agent

Tool MCP scope Hesabix permissions Roles Permission policy
await_subagent ai:tools:read (policy/handler) ADMIN, BUSINESS_OWNER, OPERATOR, USER agent_internal
cancel_subagent ai:tools:read (policy/handler) ADMIN, BUSINESS_OWNER, OPERATOR, USER agent_internal
create_session_plan ai:tools:write (policy/handler) ADMIN, BUSINESS_OWNER, OPERATOR, USER agent_internal
list_session_todos ai:tools:read (policy/handler) ADMIN, BUSINESS_OWNER, OPERATOR, USER agent_internal
spawn_subagent ai:tools:read (policy/handler) ADMIN, BUSINESS_OWNER, OPERATOR, USER agent_internal
update_session_todo ai:tools:write (policy/handler) ADMIN, BUSINESS_OWNER, OPERATOR, USER agent_internal

audit

Tool MCP scope Hesabix permissions Roles Permission policy
search_activity_logs ai:tools:read activity_logs.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required

business

Tool MCP scope Hesabix permissions Roles Permission policy
get_business_dashboard ai:tools:read reports.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_business_info ai:tools:read (policy/handler) ADMIN, BUSINESS_OWNER, OPERATOR, USER user_context
list_business_users ai:tools:read settings.view ADMIN, BUSINESS_OWNER required

checks

Tool MCP scope Hesabix permissions Roles Permission policy
get_check_details ai:tools:read checks.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
search_checks ai:tools:read checks.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required

credit

Tool MCP scope Hesabix permissions Roles Permission policy
get_business_credit_settings ai:tools:read credit.view ADMIN, BUSINESS_OWNER, USER required
get_person_credit ai:tools:read credit.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
list_credit_installment_plans ai:tools:read credit.view ADMIN, BUSINESS_OWNER, USER required

crm

Tool MCP scope Hesabix permissions Roles Permission policy
create_lead ai:tools:write crm.write ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_crm_summary ai:tools:read crm.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_deal_details ai:tools:read crm.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_lead_details ai:tools:read crm.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_lead_funnel_report ai:tools:read crm.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_pipeline_report ai:tools:read crm.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
search_activities ai:tools:read crm.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
search_deals ai:tools:read crm.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
search_leads ai:tools:read crm.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required

customer_club

Tool MCP scope Hesabix permissions Roles Permission policy
adjust_customer_club_points ai:tools:write customer_club.write ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_customer_club_rfm_summary ai:tools:read customer_club.view ADMIN, BUSINESS_OWNER, USER required
get_customer_club_settings ai:tools:read customer_club.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
list_customer_club_ledger ai:tools:read customer_club.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
list_customer_club_tiers ai:tools:read customer_club.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
recalculate_customer_club_rfm ai:tools:write customer_club.write ADMIN, BUSINESS_OWNER, OPERATOR, USER required
search_customer_club_rfm_persons ai:tools:read customer_club.view ADMIN, BUSINESS_OWNER, USER required
update_customer_club_settings ai:tools:write customer_club.write ADMIN, BUSINESS_OWNER, OPERATOR, USER required

distribution

Tool MCP scope Hesabix permissions Roles Permission policy
list_distribution_routes ai:tools:read distribution.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required

export

Tool MCP scope Hesabix permissions Roles Permission policy
export_business_data ai:tools:write reports.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required

financial

Tool MCP scope Hesabix permissions Roles Permission policy
create_check ai:tools:write checks.write ADMIN, BUSINESS_OWNER, OPERATOR, USER required
create_expense_income ai:tools:write expenses_income.write ADMIN, BUSINESS_OWNER, OPERATOR, USER required
create_receipt_payment ai:tools:write receipts_payments.write ADMIN, BUSINESS_OWNER, OPERATOR, USER required
create_transfer ai:tools:write transfers.write ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_cash_flow ai:tools:read reports.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_creditors_report ai:tools:read reports.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_debtors_report ai:tools:read reports.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_financial_summary ai:tools:read reports.read ADMIN, BUSINESS_OWNER, USER required
get_inventory_valuation ai:tools:read inventory.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_purchase_report ai:tools:read reports.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_sales_report ai:tools:read reports.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required
list_bank_accounts ai:tools:read bank_accounts.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
list_cash_registers ai:tools:read cash_registers.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
list_currencies ai:tools:read invoices.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
list_petty_cash ai:tools:read petty_cash.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
search_expense_income ai:tools:read expenses_income.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
search_receipts_payments ai:tools:read receipts_payments.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required
search_transfers ai:tools:read transfers.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required

integration

Tool MCP scope Hesabix permissions Roles Permission policy
get_basalam_overview ai:tools:read basalam.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
invoke_business_connector ai:tools:write settings.view ADMIN, BUSINESS_OWNER, USER required
list_basalam_dead_letter ai:tools:read basalam.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
list_basalam_product_conflicts ai:tools:read basalam.view ADMIN, BUSINESS_OWNER, USER required
list_basalam_synced_invoices ai:tools:read basalam.view ADMIN, BUSINESS_OWNER, USER required
list_woocommerce_orders ai:tools:read woocommerce.view ADMIN, BUSINESS_OWNER, USER required
list_woocommerce_products ai:tools:read woocommerce.view ADMIN, BUSINESS_OWNER, USER required

invoices

Tool MCP scope Hesabix permissions Roles Permission policy
create_invoice ai:tools:write invoices.write ADMIN, BUSINESS_OWNER, OPERATOR, USER required
delete_invoice ai:tools:write invoices.write ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_invoice_details ai:tools:read invoices.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_invoices_count ai:tools:read invoices.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required
search_invoices ai:tools:read invoices.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required
update_invoice ai:tools:write invoices.write ADMIN, BUSINESS_OWNER, OPERATOR, USER required

marketplace

Tool MCP scope Hesabix permissions Roles Permission policy
list_business_plugins ai:tools:read marketplace.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
list_marketplace_plugins ai:tools:read marketplace.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required

memory

Tool MCP scope Hesabix permissions Roles Permission policy
delete_memory_entry ai:tools:write (policy/handler) ADMIN, BUSINESS_OWNER, OPERATOR, USER self_scoped
read_memory ai:tools:read (policy/handler) ADMIN, BUSINESS_OWNER, OPERATOR, USER self_scoped
upsert_memory_entry ai:tools:write (policy/handler) ADMIN, BUSINESS_OWNER, OPERATOR, USER self_scoped

persons

Tool MCP scope Hesabix permissions Roles Permission policy
create_person ai:tools:write persons.write ADMIN, BUSINESS_OWNER, OPERATOR, USER required
delete_person ai:tools:write people.delete ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_customer_info ai:tools:read persons.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_person_balance ai:tools:read persons.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_person_transactions ai:tools:read persons.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required
list_person_groups ai:tools:read people.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
search_persons ai:tools:read persons.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required
update_person ai:tools:write persons.write ADMIN, BUSINESS_OWNER, OPERATOR, USER required

production

Tool MCP scope Hesabix permissions Roles Permission policy
get_bom_details ai:tools:read inventory.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required
list_boms ai:tools:read inventory.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required
search_production_documents ai:tools:read invoices.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required

products

Tool MCP scope Hesabix permissions Roles Permission policy
create_product ai:tools:write products.write ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_inventory_status ai:tools:read inventory.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_product_info ai:tools:read inventory.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_product_kardex ai:tools:read inventory.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required
list_price_list_items ai:tools:read price_lists.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
list_price_lists ai:tools:read price_lists.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
search_categories ai:tools:read categories.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
search_products ai:tools:read inventory.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required
update_product ai:tools:write products.write ADMIN, BUSINESS_OWNER, OPERATOR, USER required

projects

Tool MCP scope Hesabix permissions Roles Permission policy
get_project_summary ai:tools:read accounting_documents.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
search_projects ai:tools:read accounting_documents.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required

query

Tool MCP scope Hesabix permissions Roles Permission policy
batch_query_business_data ai:tools:read (policy/handler) ADMIN, BUSINESS_OWNER, OPERATOR, USER handler
list_queryable_fields ai:tools:read (policy/handler) ADMIN, BUSINESS_OWNER, OPERATOR, USER handler
query_business_data ai:tools:read (policy/handler) ADMIN, BUSINESS_OWNER, OPERATOR, USER handler
resolve_date_range ai:tools:read (policy/handler) ADMIN, BUSINESS_OWNER, OPERATOR, USER user_context

repair

Tool MCP scope Hesabix permissions Roles Permission policy
get_repair_order_details ai:tools:read invoices.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required
search_repair_orders ai:tools:read invoices.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required

report_templates

Tool MCP scope Hesabix permissions Roles Permission policy
get_report_template ai:tools:read report_templates.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_report_template_scope_catalog ai:tools:read report_templates.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
list_report_templates ai:tools:read report_templates.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
publish_report_template ai:tools:write report_templates.write ADMIN, BUSINESS_OWNER, OPERATOR, USER required
set_default_report_template ai:tools:write report_templates.write ADMIN, BUSINESS_OWNER, OPERATOR, USER required

reports

Tool MCP scope Hesabix permissions Roles Permission policy
get_report ai:tools:read reports.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required
list_available_reports ai:tools:read reports.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required

sales

Tool MCP scope Hesabix permissions Roles Permission policy
get_quick_sales_settings ai:tools:read settings.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required

tax

Tool MCP scope Hesabix permissions Roles Permission policy
get_tax_data_quality ai:tools:read moadian.view ADMIN, BUSINESS_OWNER, USER required
get_tax_settings ai:tools:read moadian.view ADMIN, BUSINESS_OWNER, USER required
search_tax_workspace ai:tools:read moadian.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required

warehouse

Tool MCP scope Hesabix permissions Roles Permission policy
create_warehouse_document ai:tools:write warehouses.write ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_warehouse_document_details ai:tools:read warehouses.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_warehouse_stock_summary ai:tools:read inventory.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required
list_warehouses ai:tools:read warehouses.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
search_warehouse_documents ai:tools:read warehouses.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required

warranty

Tool MCP scope Hesabix permissions Roles Permission policy
search_warranty_codes ai:tools:read warranty.read ADMIN, BUSINESS_OWNER, OPERATOR, USER required

workflow

Tool MCP scope Hesabix permissions Roles Permission policy
create_workflow ai:tools:write workflows.write ADMIN, BUSINESS_OWNER, OPERATOR, USER required
delete_workflow ai:tools:write workflows.write ADMIN, BUSINESS_OWNER, OPERATOR, USER required
execute_workflow ai:tools:write workflows.write ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_workflow ai:tools:read workflows.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_workflow_component_schema ai:tools:read workflows.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_workflow_design_rules ai:tools:read workflows.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
get_workflow_execution_debug ai:tools:read workflows.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
list_workflow_action_catalog ai:tools:read workflows.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
list_workflow_builtin_nodes ai:tools:read workflows.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
list_workflow_executions ai:tools:read workflows.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
list_workflow_trigger_catalog ai:tools:read workflows.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
list_workflows ai:tools:read workflows.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
poll_workflow_execution ai:tools:read workflows.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required
test_workflow ai:tools:write workflows.write ADMIN, BUSINESS_OWNER, OPERATOR, USER required
update_workflow ai:tools:write workflows.write ADMIN, BUSINESS_OWNER, OPERATOR, USER required
validate_workflow_draft ai:tools:read workflows.view ADMIN, BUSINESS_OWNER, OPERATOR, USER required

Not exposed by the ordinary business-user MCP filter

These source declarations were excluded by the MCP layer's business-context/role filter, or are not enabled/current. They may serve other product surfaces or privileged roles and are not counted above.

Tool Category Roles Business context
create_account accounting dynamic/unspecified True
create_product_attribute products dynamic/unspecified True
delete_account accounting dynamic/unspecified True
delete_check checks dynamic/unspecified True
delete_expense_income financial dynamic/unspecified True
delete_product_attribute products dynamic/unspecified True
delete_receipt_payment financial dynamic/unspecified True
delete_transfer financial dynamic/unspecified True
get_account accounting dynamic/unspecified True
get_document_numbering_settings accounting dynamic/unspecified True
get_loan_facility financial dynamic/unspecified True
get_product_attribute products dynamic/unspecified True
get_wallet_metrics financial dynamic/unspecified True
get_wallet_overview financial dynamic/unspecified True
get_warehouse_report warehouse dynamic/unspecified True
hscript_fix_script hscript dynamic/unspecified True
hscript_language_guide hscript dynamic/unspecified True
hscript_read_doc hscript dynamic/unspecified True
hscript_retrieve_docs hscript dynamic/unspecified True
hscript_run_preview hscript dynamic/unspecified True
hscript_search_docs hscript dynamic/unspecified True
hscript_validate_script hscript dynamic/unspecified True
list_accounts accounting dynamic/unspecified True
list_announcements user dynamic/unspecified False
list_business_notification_logs business dynamic/unspecified True
list_business_notification_templates business dynamic/unspecified True
list_currency_rates financial dynamic/unspecified True
list_frequent_descriptions business dynamic/unspecified True
list_loan_facilities financial dynamic/unspecified True
list_my_businesses user dynamic/unspecified False
list_payment_gateways financial dynamic/unspecified True
list_product_attributes products dynamic/unspecified True
list_user_notifications user dynamic/unspecified False
list_wallet_transactions financial dynamic/unspecified True
list_warehouse_locations warehouse dynamic/unspecified True
list_warehouse_placements warehouse dynamic/unspecified True
resolve_currency_rate financial dynamic/unspecified True
search_product_instances products dynamic/unspecified True
update_account accounting dynamic/unspecified True
update_check checks dynamic/unspecified True
update_expense_income financial dynamic/unspecified True
update_product_attribute products dynamic/unspecified True
update_receipt_payment financial dynamic/unspecified True
update_transfer financial dynamic/unspecified True

Coverage and refresh

Static AIFunction declarations found: 180. Tool Manifest entries: 180. Manifest-only names without a literal AIFunction declaration are not included as registered tools. Run the generator after registry or Tool Manifest changes. A live tools/list using a specific user's OAuth connection is still required to prove actual runtime visibility and effective tool schemas.