# onehq-comissions-calculator

> Use this tool when you need to calculate insurance commissions, validate distribution hierarchies, or access carrier-specific contract rules within your AI workflow. It provides five key functions: calculating commissions, building and validating hierarchies, checking carrier compliance, retrieving carrier information, and offering platform overviews. With inputs such as annual premiums, agent tiers, and carrier names, it outputs detailed commission breakdowns, validated hierarchies, and compliance results.

Canonical page: https://skillsregistry.net/skills/dante-r-g36u-onehq-comissions-calculator  
JSON: https://api.skillsregistry.net/v1/skills/dante-r-g36u-onehq-comissions-calculator

## Description

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:

1. 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.

2. 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.

3. 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.

4. 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%.

5. 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.

## Trust

- **Trust score (0–1):** 0.50
- **Verification tier:** unverified

## Facts

- **Version:** 1.0.0
- **Skill type:** atomic
- **Execution layer:** mcp-remote
- **Runtime environment:** api
- **Category:** file-system
- **Updated:** 2026-05-17

## Source

- **Source listing:** [Smithery](https://smithery.ai/server/dante-r-g36u/onehq-comissions-calculator)

## Use it

Resolve this record through the SkillsRegistry MCP server (no auth, read-only):

```
claude mcp add --transport http --scope user skillsregistry https://api.skillsregistry.net/mcp
```

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_skill",
    "arguments": {
      "slug": "dante-r-g36u-onehq-comissions-calculator"
    }
  }
}
```

REST: `GET https://api.skillsregistry.net/v1/skills/dante-r-g36u-onehq-comissions-calculator` · pull for local use: `GET https://api.skillsregistry.net/v1/skills/dante-r-g36u-onehq-comissions-calculator/pull`

---
SkillsRegistry indexes agent skills from public registries and GitHub. Skills we have analysed are scanned with Circle-IR and scored on six dimensions; each listing states its scan coverage. More: https://skillsregistry.net/llms.txt