MCP Server: io.github.mkibrick/compshop

This MCP server exposes an independent directory for searching salary & compensation surveys. It enables discovery of 350+ reports across multiple vendors by job title, industry, region, or publisher, covering participating orgs and related job families and positions.

🛠️ Key Features

Search 350+ compensation surveys by industry, region, or job title
Independent directory of salary & compensation surveys
Catalog spans 17+ vendors (e.g., Mercer, WTW, Aon, SullivanCotter, Gallagher)
Server-side search across vendors, reports, job families, positions, and participating orgs
Tool availability: 7

🚀 Use Cases

Find relevant compensation survey reports for a specific role or geography
Browse surveys by industry, job title, publisher, or vendor
Use participating org and job family/position metadata for discovery

⚡ Developer Benefits

Server-side query for FTS-ish searching across catalog dimensions
SQLite database using better-sqlite3 with a file-backed DB bundled in the repo
Built with Next.js 14 (App Router), TypeScript, and Tailwind

⚠️ Limitations

Coverage is limited to the directory’s 350+ reports and the 17+ participating vendors listed in the source.

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

bash

npm install
npm run dev

Open http://localhost:3000.

Data pipelines

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

bash

# Add/refresh a vendor (parent row)
npm run db:add-vendor <path-to-json>

# Add/refresh a single report (with optional XLSX position/participant lists)
npm run db:add-report <path-to-directory>

# Batch-load many reports at once
npm run db:add-report-batch "scripts/data/mercer-*"

See scripts/SCRAPING.md for the full data-loading workflow.

Deployment

Deploys to Vercel out of the box. The SQLite DB file (data/compshop.db) is committed to the repo and read at request time by the serverless routes; almost all pages are pre-rendered statically at build time via generateStaticParams + force-static.

Set NEXT_PUBLIC_SITE_URL in your Vercel project settings to your production domain (e.g., https://compshop.io).

query	string	required	Free-text query (job title, industry, vendor, geography, etc.)
limit	integer	optional	Max results per group (default 5, max 15)

position	string	required	Job title or position to look up (free text). Abbreviations and paraphrases are fine.
limit	integer	optional	Max position matches to return (default 5, max 20)

industry	string	required	Primary industry. One of: general-industry, healthcare, life-sciences, tech, media, financial-services, insurance, energy, construction, retail, higher-ed, legal, nonprofit, executive, free.
region	string	optional	Optional. One of: United States, Canada, United Kingdom, Europe, Asia Pacific, Latin America, Middle East & Africa, Global.
role_focus	string	optional	Optional free-text describing the role types being benchmarked (e.g. 'software engineers', 'physicians', 'sales reps', 'CEO and C-suite').
limit	integer	optional	Max recommendations (default 5, max 10)

CompShop

MCP Server: io.github.mkibrick/compshop

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search

list_vendors_by_industry

list_vendors_by_region

find_surveys_for_position

get_vendor

get_report

recommend_surveys

CompShop

Tech stack

Local dev

Data pipelines

Deployment

Install

Remote endpoint

Related servers