# BlitzAPI MCP Server

Custom MCP server exposing BlitzAPI's B2B data endpoints to Claude — enabling BizForce sales reps to find contacts, companies, and enriched data via natural language.

## Tools

| Tool | What it does | Rep prompt example |
|---|---|---|
| `blitz_check_credits` | Check API key + credit balance | "Do we have credits left?" |
| `blitz_find_people` | Search contacts across companies by ICP filters | "Find billing managers at orthopedic clinics in Tennessee" |
| `blitz_employee_finder` | Find all employees at a specific company | "Who works at Memorial Health Group?" |
| `blitz_waterfall_icp` | Get the single best decision-maker at a company | "Best RCM contact at Cleveland Clinic" |
| `blitz_company_search` | Find companies matching ICP criteria | "Find hospitals in Georgia with 200+ employees" |
| `blitz_find_email` | Get verified work email from LinkedIn URL | "Get emails for these contacts" |
| `blitz_find_phone` | Get direct phone/mobile from LinkedIn URL | "Get phone numbers too" |
| `blitz_company_enrichment` | Full company profile from LinkedIn URL | "Tell me about this company" |
| `blitz_reverse_email_lookup` | Find person from email address | "Who is john@company.com?" |

## Setup

### 1. Install dependencies

```bash
npm install
```

### 2. Build

```bash
npm run build
```

### 3. Set environment variables

```bash
export BLITZ_API_KEY=your_blitzapi_key_here
export TRANSPORT=http   # or stdio
export PORT=3000        # optional, default 3000
```

### 4. Run

```bash
npm start
```

---

## Deploy to Railway

1. Push this repo to GitHub
2. Go to [railway.app](https://railway.app) → New Project → Deploy from GitHub
3. Add environment variable: `BLITZ_API_KEY=your_key`
4. Railway auto-detects Node and sets `PORT` — server starts automatically
5. Copy the Railway public URL

## Deploy to Render

1. Push to GitHub
2. Go to [render.com](https://render.com) → New Web Service → Connect repo
3. Build command: `npm install && npm run build`
4. Start command: `npm start`
5. Add env var: `BLITZ_API_KEY=your_key`
6. Copy the Render public URL

---

## Connect to Claude Team

1. Go to claude.ai → Settings → Connectors → Add Custom Connector
2. Enter your deployed URL: `https://your-app.railway.app/mcp`
3. Save — all reps on the Team plan can now use BlitzAPI via Claude

---

## Example Rep Workflows

### Find + Enrich

```
Rep: "Find RCM directors at hospitals in Georgia with 200+ employees"
→ blitz_find_people → 15 contacts with LinkedIn URLs

Rep: "Get emails for all of them"
→ blitz_find_email × 15 → verified emails

Rep: "Get phone numbers for the top 5"
→ blitz_find_phone × 5 → direct dials
```

### Account Research

```
Rep: "Tell me about this company: linkedin.com/company/memorial-health"
→ blitz_company_enrichment → full profile

Rep: "Who's the best billing contact there?"
→ blitz_waterfall_icp → single best decision-maker
```

### TAM Build

```
Rep: "Find orthopedic practices in Tennessee and Florida with 11-200 employees"
→ blitz_company_search → list of matching companies

Rep: "Find billing managers at each of these companies"
→ blitz_employee_finder (per company) or blitz_find_people (batch)
```