Compshop

by mkibrick

329 downloads
Not rated
GitHub

About

Independent directory of 350+ compensation surveys. Search, filter, and recommend salary-survey publishers (Mercer, WTW, Aon Radford, Pearl Meyer, SullivanCotter, Gallagher, Empsight, Culpepper, Croner, and more) by industry, region, or job title.

Details

Author
mkibrick
Downloads
329
Categories
Other

- Search 350+ compensation surveys across 17+ vendors
- Filter reports by job title, industry, geography, or publisher
- Server-side full-text search across reports, job families, and positions
- ~3,500 statically-generated, SEO-optimized indexable pages
- Bundled SQLite database for offline local development
- JSON-LD, OG/Twitter tags, canonical URLs, and auto-generated sitemap

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Compshop
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Clone the repository, run npm install followed by npm run dev, and open http://localhost:3000 in a browser. Data can be loaded via command-line scripts (npm run db:add-vendor, npm run db:add-report, or npm run db:add-report-batch). The app can be deployed to Vercel with the SQLite database file committed to the repo.

search

Free-text search across the CompShop directory of compensation surveys. Returns matching vendors, reports, job families, and positions. Use for open-ended discovery questions like 'biotech surveys in Europe' or 'CEO compensation data'.

list_vendors_by_industry

List every CompShop vendor that publishes surveys for a given industry. Use when the user asks 'what survey publishers cover [industry]?'

list_vendors_by_region

List vendors with survey coverage in a given region. Use when the user asks 'what publishers cover [region]?' Region is matched against both vendor-level scope and individual report scopes.

find_surveys_for_position

Find compensation surveys that benchmark a specific job title or position (e.g. 'Software Engineer', 'CPA', 'Sr Acct', 'head of finance'). Combines literal title matching with embedding-based semantic similarity, so abbreviations and paraphrases work — 'CPA' returns 'Certified Public Accountant', 'Sr Acct' returns 'Senior Accountant'. Reports per position are ranked to surface broad-coverage surveys (general-industry, US scope) before niche cuts.

get_vendor

Detailed info on a specific vendor by slug, including all of their reports. Use after `search` or `list_vendors_by_industry` returns a candidate.

get_report

Detailed info on a single survey report by slug.

recommend_surveys

Recommend the best-fit compensation surveys given a hiring/benchmarking context. Use when the user asks 'what survey should I use for [situation]?' Returns ranked vendors with rationale. Required: industry. Optional: region, role focus.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "compshop": {
            "compshop": {
                "url": "https://www.comp-shop.com/api/mcp"
            }
        }
    }
}

McpServers

{
    "compshop": {
        "url": "https://www.comp-shop.com/api/mcp"
    }
}

CompShop

The independent directory of salary & compensation surveys. Search 350+ reports across 17+ vendors (Mercer, WTW, Aon, SullivanCotter, Gallagher, Pearl Meyer, Empsight, Culpepper, Milliman, MRA, LOMA, Birches Group, Western Management Group, and more) by job title, industry, geography, or publisher.

Tech stack

- Framework: Next.js 14 (App Router) + TypeScript + Tailwind
- Database: SQLite (better-sqlite3) with a file-backed DB bundled in the repo
- Search: server-side FTS-ish query across vendors, reports, job families, positions, and participating orgs
- SEO: ~3,500 statically-generated indexable pages (vendor / report / family / position) with JSON-LD, OG/Twitter tags, canonical URLs, and an auto-generated sitemap

Local dev

npm install
npm run dev

Open http://localhost:3000.

Data pipelines

Loaders are in scripts/. Each writes to data/compshop.db.

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.