Commonality Server

MCP-native sales intelligence — Commonality as a Claude connector + minimal web app for setup, billing, and invites.

Daily usage happens inside Claude.ai via an MCP server. The React web app handles one-time team setup, billing, and teammate invites only.

Architecture

A pnpm monorepo deployed as a single Railway service. One Express server hosts both the MCP endpoint and the React static build.

apps/server     Express + TypeScript — MCP endpoint, OAuth, REST API, static host
apps/web        React + Vite — marketing, onboarding, dashboard, invites, billing
packages/shared Zod schemas + shared TypeScript types
supabase        SQL migrations (schema, RLS, atomic quota fn)

Quick start

pnpm install
cp .env.example .env   # fill in real values — never commit .env
pnpm --filter server dev
pnpm --filter web dev

Build process

This repo was generated from the build brief in COMMONALITY_BUILD_INSTRUCTIONS.md (kept outside this repo). See CLAUDE.md for operating principles and conventions for future Claude Code sessions.

Stack

• MCP server — JSON-RPC 2.0 over HTTP, 11 tools, JWT-gated
• Auth — OAuth 2.1 discovery + Commonality-issued JWT (Clerk as the IdP)
• DB — Supabase (Postgres) with Row Level Security scoped by company_id
• Billing — Stripe checkout + customer portal + webhooks
• Email — Resend for invites
• Enrichment — Apify (LinkedIn) + Cassidy (profile enrichment), shared cache
• CRM push — HubSpot + Salesforce

License

Private — The Endurance Group.