# onehq-comissions-calculator

onehq-comissions-calculator — an MCP server for modeling insurance distribution hierarchies and calculating tiered payouts. It validates contract percentages against carrier limits directly in your coding assistant.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1274 installs
- Author: dante-r-g36u
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/dante-r-g36u/onehq-comissions-calculator
- Updated: 2026-04-08
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/onehq-comissions-calculator

## What it does

This integration connects your coding client with insurance compensation logic. Running `calculate_commission` breaks down an annual premium into direct agent earnings and tiered override spreads. To structure payouts before calculating them, `build_hierarchy` organizes custom tiers or applies pre-configured setups such as Standard BGA and Multi-Level.

Compliance checks run through `validate_hierarchy`. The tool flags percentages that exceed carrier caps and highlights numbers outside typical boundaries. You can query `get_carrier_info` to inspect industry contract benchmarks from Agent up to IMO tiers, or fetch the full list of supported carriers.

Because this server operates over HTTP at `https://onehq-comissions-calculator.run.tools`, local execution without internet access will fail. If you need background on automating these workflows across CRM or commission systems, the `onehq_info` tool supplies reference material for the OneHQ ecosystem.

## Requirements
- Remote server: `https://onehq-comissions-calculator.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http onehq-comissions-calculator https://onehq-comissions-calculator.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add onehq-comissions-calculator --url https://onehq-comissions-calculator.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "onehq-comissions-calculator": {
            "url": "https://onehq-comissions-calculator.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "onehq-comissions-calculator": {
            "type": "http",
            "url": "https://onehq-comissions-calculator.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http onehq-comissions-calculator https://onehq-comissions-calculator.run.tools
```

## When to use it
- calculate direct payouts and override spreads from an annual premium
- model commission hierarchies with pre-built BGA and Multi-Level templates
- verify contract levels against maximum limits set by insurance carriers
- retrieve benchmark compensation ranges for tiers from Agent to IMO

## Example prompts
- Calculate commissions for an annual premium of 50000 across IMO and BGA tiers with `calculate_commission`.
- Check whether our contract percentages exceed carrier limits using `validate_hierarchy`.
- List available insurance carriers and benchmark contract tiers with `get_carrier_info`.

## Similar
- [Music Royalties Calculator](https://affpapa.org/en/nevibecode/mcp/music-royalties-calculator.md) — MCP server · 186 installs
- [amazon-fba-calculator](https://affpapa.org/en/nevibecode/skills/amazon-fba-calculator.md) — skill · 1300 installs
- [calculator-design](https://affpapa.org/en/nevibecode/skills/calculator-design.md) — skill · 286 installs
- [calculator-mcp-server](https://affpapa.org/en/nevibecode/mcp/calculator-mcp-server.md) — MCP server · 4412 installs
- [Calculator](https://affpapa.org/en/nevibecode/mcp/calculator.md) — MCP server · 2021 installs
- [affiliate-payout-audit](https://affpapa.org/en/nevibecode/skills/affiliate-payout-audit.md) — skill · 17700 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
