Prior Authorization System Server

End-to-end Prior Authorization decision-support system with a multi-agent AI pipeline, MCP Tool Registry, and PostgreSQL backend.

Original wireframe: https://www.figma.com/design/5qn3BZ9VfJ2eoa06sytSY0/Prior-Authorization-Wireframe

Tech Stack

• Frontend: React 18 + Vite + Tailwind CSS + shadcn/ui
• Backend: Express.js (ESM) with JWT authentication
• Database: PostgreSQL 16 (6 tables, 400+ seed rows)
• AI Pipeline: 4 agents + 6 MCP tools + 9-step processing pipeline

Prerequisites

• Node.js 18+
• PostgreSQL 16+
• npm

Setup

# 1. Install frontend dependencies
npm install

# 2. Install backend dependencies
cd server && npm install && cd ..

# 3. Create database
createdb prior_auth_db

# 4. Run schema + seed data (15 members, 75 claims, 15 policies, 15 PA requests)
node server/db/setup.js

# 5. Create .env.local for frontend API URL
echo "VITE_API_BASE_URL=http://localhost:3001/api/v1" > .env.local

Running

# Start backend (port 3001)
node server/index.js

# Start frontend (port 5173) — in a new terminal
npm run dev

Demo Credentials

Username	Password	Role
admin	admin123	Medical Director
nurse	nurse123	Clinical Reviewer
analyst	analyst123	Claims Analyst

Verification

# Health check
curl http://localhost:3001/api/v1/health

# List MCP tools
curl http://localhost:3001/api/v1/mcp/tools

# List PA requests
curl http://localhost:3001/api/v1/requests

Database Reset

node server/db/setup.js --reset

Architecture

See DESIGN.md for full architecture documentation covering database schema, MCP tool registry, agent pipeline, API routes, and frontend integration.