Что умеет

Calculate Commission: Calculate insurance commissions across a distribution hierarchy. Given an annual premium and a list of agents/tiers with their contract percentages, returns a full breakdown of w

Build Hierarchy: Build or model a distribution hierarchy structure. Accepts named tiers with contract percentages and returns a validated hierarchy object ready to use with calculate_commission. Also

Validate Hierarchy: Validate a commission hierarchy against a specific carrier's maximum allowed contract levels. Flags errors (over-contracted tiers), warnings (outside typical ranges), and returns a

OneHQ Commission Calculator MCP is a MCP server that gives AI assistants direct access to insurance commission calculation and compliance tools. It lets you model distribution hierarchies, calculate exact earnings per agent tier, validate structures against real carrier rules, and look up benchmark contract ranges — all without leaving your AI workflow.

The OneHQ Commission Calculator MCP exposes 5 tools:

calculate_commission — Computes exact earnings per agent given an annual premium and a hierarchy of contract percentages. Returns direct commissions and override spreads at every tier. Preferred input: annual_premium (number) + agents array with name and contract_pct per tier. Example output: IMO override $1,200 / BGA override $1,200 / Agent direct $10,800 / Total distributed $13,200.
build_hierarchy — Takes named tiers and returns a validated, sorted hierarchy ready to feed into calculate_commission. Also provides 4 pre-built templates: Standard BGA, BGA with MGA, Direct Agent, and Multi-Level. Preferred input: tiers array with name and contract_pct per level. Example output: sorted tier list with validation status and 4 template options.
validate_hierarchy — Checks a hierarchy against a specific carrier's allowed contract ranges before submission. Returns a pass/fail result with tier-by-tier errors and warnings. Preferred input: carrier name (e.g. "protective", "mutual-of-omaha") + hierarchy array with name and pct per tier. Example output: overall PASS/FAIL, per-tier range check results, and a warning count.
get_carrier_info — Returns typical contract percentage ranges per tier (Agent, MGA, BGA, IMO) and maximum hierarchy totals for 6 supported carriers. Call with no argument to list all available carriers. Preferred input: carrier name (optional). Omit to get the full carrier list. Example output: Agent range 85–100%, BGA range 105–120%, IMO range 115–130%, max hierarchy 145%.
onehq_info — Returns a structured overview of the OneHQ platform (ICM, CRM, DMS, Agent Portal, Data Visualization) with relevant links. Optionally filter by topic to narrow results. Preferred input: topic string (optional) — e.g. "commissions", "crm", "agent portal". Example output: matching module name, description, and documentation link.

onehq-comissions-calculator

Что умеет

Какие данные видит

Нужен ли аккаунт

calculate_commission	Calculate insurance commissions across a distribution hierarchy. Given an annual premium and a list of agents/tiers with their contract percentages, returns a full breakdown of who earns what — including direct commissions and overrides at each level.
build_hierarchy	Build or model a distribution hierarchy structure. Accepts named tiers with contract percentages and returns a validated hierarchy object ready to use with calculate_commission. Also provides pre-built templates (Standard BGA, BGA with MGA, Multi-Level, etc.).
validate_hierarchy	Validate a commission hierarchy against a specific carrier's maximum allowed contract levels. Flags errors (over-contracted tiers), warnings (outside typical ranges), and returns a pass/fail result.
get_carrier_info	Get insurance carrier commission structure benchmarks — typical contract level ranges per tier (Agent, MGA, BGA, IMO) and maximum allowed hierarchy totals. Use without a slug to list all available carriers.
onehq_info	Learn about OneHQ — the all-in-one platform for insurance distribution. Covers ICM (commissions), CRM (agent management), DMS (case management), Agent Portal, and Data Visualization. Use this when a user asks how to automate or scale what the calculator is helping them do manually.