Connect in under 5 minutes

MCP Setup Guide

Connect your AI assistant to Commish for commission management, deal tracking, and comp plan insights — all through natural conversation.

What You'll Need

A Commish account with an API key (Settings → API Keys)
An MCP-compatible AI client (Claude Desktop, ChatGPT, Cursor, or VS Code)

Recommended

Quick Setup

No downloads, no dependencies — just paste a config snippet and restart your AI client.

🤖 Claude Desktop

1
Open your Claude Desktop config file:
macOS
Open Claude Desktop → menu bar → Claude → Settings → Developer → Edit Config
Manual file path →
1. Open Finder
2. Press Cmd+Shift+G (Go to Folder)
3. Paste: ~/Library/Application Support/Claude/
4. Open claude_desktop_config.json in any text editor
If the file doesn't exist, create it with: {}
Windows
Open Claude Desktop → ☰ Menu (top-left) → Settings → Developer → Edit Config
Manual file path →
1. Press Win+R to open the Run dialog
2. Paste: %APPDATA%\Claude and hit Enter
3. Open claude_desktop_config.json in Notepad or any text editor
If the file doesn't exist, create a new text file with that name containing: {}

Add the Commish server to mcpServers:

{
  "mcpServers": {
    "commish": {
      "url": "https://app.getcommish.io/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

3
Restart Claude Desktop.

Using the demo environment? Replace app.getcommish.io with demo.getcommish.io.

Power Users

Advanced Setup

Run the MCP server locally — useful for offline access, custom modifications, or self-hosted environments.

Prerequisites

Automated Installer (Windows)

Run this one-liner in PowerShell, then choose option 2 (Advanced - Local Install) when prompted:

irm https://getcommish.io/install-mcp.ps1 | iex

Manual Install

Clone and build the MCP server:

git clone https://github.com/brandonpenrod/commish-mcp-server.git ~/commish-mcp-server
cd ~/commish-mcp-server
npm install
npm run build

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "commish": {
      "command": "node",
      "args": ["~/commish-mcp-server/dist/index.js"],
      "env": {
        "COMMISH_API_URL": "https://app.getcommish.io/api/v1",
        "COMMISH_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

3
Restart Claude Desktop after saving.

Example prompts

Things to Try

Once connected, try asking your AI assistant any of these:

“

List all comp plans in Commish

“

Show me this quarter's commission summary

“

Create a new deal for Acme Corp

“

What's my top performer's pipeline looking like?

“

What would Sarah earn on a $150K new business deal?

“

Set up a SPIFF — $500 per new logo, capped at 5 per rep

“

Create a comp plan with a 3-month ramp, NRR as the primary metric, and 1.5x accelerator above 100% attainment

“

Set up a custom deal field for 'Contract Length' as a number field

“

Build a complete AE comp plan — $120K base, $80K variable, 70% ARR / 30% WNC, $800K ARR quota, 2x annual accelerator

Troubleshooting

Common issues and how to fix them. Still stuck? Email [email protected]

Ready to Connect?

You're a config snippet away from managing commissions through natural conversation. Jump back to the MCP overview, or get your API key and get started.