The-Bip-App/bip-mcp-server

BIP MCP Server

Production-ready MCP server for the BIP healthcare credentialing platform. Enables AI agents to interact with provider data, credentialing workflows, and healthcare operations through a secure, authenticated API.

Features

• Comprehensive Provider Management: Full CRUD operations for providers, licenses, education, work history, CME activities, and peer references
• Multi-Tenant Security: Business-level data isolation with Supabase RLS
• Production Ready: Rate limiting, caching, audit logging, error handling
• Authentication: Service account and API key support
• External Integrations: NPPES lookup, LexisNexis enhancement
• Workflow Automation: Guided prompts for common credentialing tasks

Quick Start

Prerequisites

• Node.js 20+
• Supabase project with BIP schema
• Service role key from Supabase
• Your business UUID

Installation

Interactive Installation (Recommended):

cd ~/dev/bip-mcp-server
./install.sh

The script will:

1. Prompt for your Supabase service role key
2. Prompt for your business UUID
3. Create .env file
4. Build the project
5. Add to Claude Code automatically

Manual Installation:

cd ~/dev/bip-mcp-server
npm install

# Copy and edit environment file
cp .env.example .env
# Edit .env with your credentials

npm run build

Using the Server

After installation, the server is automatically added to Claude Code.

Try these commands in Claude Code:

Read bip://providers/list

Use the search_providers tool to find all Active providers

Use the create_provider tool to add a new provider with NPI 1234567890

Uninstall

cd ~/dev/bip-mcp-server
./uninstall.sh

Architecture

Resources (Read-Only)

• bip://providers/list - List all providers
• bip://providers/{id} - Individual provider
• bip://providers/{id}/licenses - Provider licenses
• bip://providers/{id}/education - Education records
• bip://providers/{id}/work-history - Work history
• bip://providers/{id}/cme - CME activities
• bip://providers/{id}/peer-references - Peer references
• bip://providers/{id}/documents - Documents

Tools (Actions)

• create_provider - Create new provider
• update_provider - Update provider details
• search_providers - Search and filter providers
• add_license - Add provider license
• add_education - Add education record
• add_work_history - Add work history
• add_cme_activity - Add CME activity
• upload_document - Upload document
• import_from_nppes - NPPES lookup

Prompts (Workflows)

• onboard_provider - Complete provider onboarding
• complete_credentialing - Credentialing checklist
• generate_roster - Create roster
• review_expiring_items - Expiration review

Security

• Service role key required (full database access)
• Business-level data isolation enforced
• Rate limiting to prevent abuse
• Audit logging for all mutations
• Input validation with Zod
• No sensitive data in error messages

Development

# Run with hot reload
npm run dev

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Lint code
npm run lint

# Format code
npm run format

Environment Variables

See .env.example for all configuration options.

Testing

# Unit tests
npm run test

# Integration tests (requires test Supabase instance)
npm run test -- tests/integration

# E2E tests
npm run test -- tests/e2e

Deployment

Cloud Deployment (Render, Railway, Fly.io)

1. Create new service
2. Connect GitHub repository
3. Set environment variables
4. Deploy

Docker (Optional)

FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --production
COPY dist ./dist
CMD ["node", "dist/index.js"]

License

MIT