# MCPEngine

**37+ production-ready Model Context Protocol (MCP) servers for business software platforms — plus the factory infrastructure that builds, tests, and deploys them.**

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![MCP Version](https://img.shields.io/badge/MCP-1.0-blue.svg)](https://modelcontextprotocol.io)

**Website:** [mcpengine.com](https://mcpengine.com)

---

## What is MCPEngine?

MCPEngine is the **single source of truth** for all MCP servers, MCP apps, and factory infrastructure we build. Every new MCP server, UI app, testing tool, or pipeline system lives here.

AI assistants like Claude, ChatGPT, and others use these servers to directly interact with business software — CRMs, scheduling, payments, field service, HR, marketing, and more.

---

## Repository Structure

```
mcpengine-repo/
├── servers/              # All MCP servers (one folder per platform)
│   ├── acuity-scheduling/
│   ├── bamboohr/
│   ├── basecamp/
│   ├── bigcommerce/
│   ├── brevo/
│   ├── calendly/
│   ├── clickup/
│   ├── close/
│   ├── closebot/          # NEW — 119 tools, 14 modules
│   ├── clover/
│   ├── competitor-research/# NEW — competitive intel MCP
│   ├── constant-contact/
│   ├── fieldedge/
│   ├── freshbooks/
│   ├── freshdesk/
│   ├── google-console/     # NEW — Google Search Console MCP
│   ├── gusto/
│   ├── helpscout/
│   ├── housecall-pro/
│   ├── jobber/
│   ├── keap/
│   ├── lightspeed/
│   ├── mailchimp/
│   ├── meta-ads/           # NEW — Meta/Facebook Ads MCP
│   ├── n8n-apps/           # NEW — n8n workflow MCP apps
│   ├── pipedrive/
│   ├── reonomy/            # NEW — Commercial real estate MCP
│   ├── rippling/
│   ├── servicetitan/
│   ├── squarespace/
│   ├── toast/
│   ├── touchbistro/
│   ├── trello/
│   ├── twilio/             # NEW — Twilio communications MCP
│   ├── wave/
│   ├── wrike/
│   └── zendesk/
├── infra/                # Factory infrastructure
│   ├── factory-tools/    # mcp-jest, mcp-validator, mcp-add, MCP Inspector
│   ├── command-center/   # Pipeline state, operator playbook, dashboard
│   └── factory-reviews/  # Automated review reports
├── landing-pages/        # Marketing pages per server
├── deploy/               # Deploy-ready static site
├── docs/                 # Factory docs, eval reports, research
│   ├── reports/          # Pipeline evaluation + compliance reports
│   └── research/         # MCP research & competitive intel
├── research/             # Platform research & API analysis
└── SEO-BATTLE-PLAN.md   # SEO strategy
```

---

## MCP Servers — Full Inventory

### Original 30 Servers (Stage 16 — Website Built)

| Category | Server | Tools | Status |
|----------|--------|-------|--------|
| **Field Service** | ServiceTitan, Jobber, Housecall Pro, FieldEdge | ~40 each | Ready |
| **HR & Payroll** | Gusto, BambooHR, Rippling | ~30 each | Ready |
| **Scheduling** | Calendly, Acuity Scheduling | ~25 each | Ready |
| **CRM** | Close, Pipedrive, Keap | ~40 each | Ready |
| **Support** | Zendesk, Freshdesk, HelpScout | ~35 each | Ready |
| **E-Commerce** | BigCommerce, Squarespace, Lightspeed, Clover | ~30 each | Ready |
| **Project Mgmt** | Trello, ClickUp, Wrike, Basecamp | ~35 each | Ready |
| **Marketing** | Mailchimp, Constant Contact, Brevo | ~30 each | Ready |
| **Finance** | Wave, FreshBooks | ~25 each | Ready |
| **Restaurant** | Toast, TouchBistro | ~30 each | Ready |

### Advanced Servers (In Progress)

| Server | Tools | Stage | Notes |
|--------|-------|-------|-------|
| **CloseBot** | 119 | Stage 7 (UI Apps Built) | 14 modules, 4,656 lines TS, needs API key |
| **Google Console** | ~50 | Stage 7 (UI Apps Built) | Awaiting design approval |
| **Meta Ads** | ~80 | Stage 8 (Integration Complete) | Needs META_ADS_API_KEY |
| **Twilio** | ~90 | Stage 8 (Integration Complete) | Needs TWILIO_API_KEY |
| **Competitor Research** | ~20 | Stage 6 (Core Tools Built) | Competitive intel gathering |
| **n8n Apps** | ~15 | Stage 6 (Core Tools Built) | n8n workflow integrations |
| **Reonomy** | WIP | Stage 1 (Identified) | Commercial real estate |

### Pipeline Stages

```
Stage 1  → Identified
Stage 5  → Scaffolded (compiles)
Stage 6  → Core Tools Built
Stage 7  → UI Apps Built
Stage 8  → Integration Complete
Stage 11 → Edge Case Testing
Stage 16 → Website Built (ready to deploy)
```

---

## Factory Infrastructure (`infra/`)

### factory-tools/
The complete testing and validation toolchain:
- **mcp-jest** — Global CLI for discovering, testing, and validating MCP servers
- **mcp-validator** — Python-based formal protocol compliance reports
- **mcp-add** — One-liner customer install CLI
- **MCP Inspector** — Visual debug UI for MCP servers
- **test-configs/** — 60 test config files, 702 auto-generated test cases

### command-center/
Pipeline operations:
- `state.json` — Shared state between dashboard and pipeline operator
- `PIPELINE-OPERATOR.md` — Full autonomous operator playbook
- Dashboard at `http://192.168.0.25:8888` — drag-drop kanban

### factory-reviews/
Automated review and evaluation reports from pipeline sub-agents.

---

## Quick Start

```bash
# Clone
git clone https://github.com/BusyBee3333/mcpengine.git
cd mcpengine

# Run any server
cd servers/zendesk
npm install
npm start

# Run factory tests
cd infra/factory-tools
npm install
npx mcp-jest --server ../servers/zendesk
```

---

## Contributing Rules

> **IMPORTANT: This is the canonical repo for ALL MCP work.**

See [CONTRIBUTING.md](./CONTRIBUTING.md) for full rules.

---

## License

MIT — see [LICENSE](./LICENSE)
