mcp-twin 1.2.0 → 1.4.0

package/.env.example

@@ -0,0 +1,30 @@
+# MCP Twin Cloud Configuration
+
+# Database (PostgreSQL)
+# Get a free database from Supabase: https://supabase.com
+DATABASE_URL=postgresql://user:password@host:5432/database
+
+# Server
+PORT=3000
+HOST=0.0.0.0
+NODE_ENV=development
+
+# Security
+JWT_SECRET=your-super-secret-jwt-key-change-this-in-production
+
+# CORS (comma-separated origins or * for all)
+CORS_ORIGIN=*
+
+# Stripe (for billing - optional)
+# Get keys from https://dashboard.stripe.com/apikeys
+STRIPE_SECRET_KEY=sk_test_...
+STRIPE_WEBHOOK_SECRET=whsec_...
+
+# Stripe Price IDs (create in Stripe Dashboard)
+# Products > Add Product > Add Price > Copy Price ID
+STRIPE_PRICE_STARTER=price_starter_monthly
+STRIPE_PRICE_PRO=price_pro_monthly
+
+# Debug flags (optional)
+DEBUG_SQL=false
+DEBUG_HTTP=false

package/PRD.md

@@ -0,0 +1,682 @@
+# MCP Twin Cloud - Product Requirements Document
+
+**Version:** 1.0
+**Author:** Prax Labs
+**Date:** December 31, 2024
+**Status:** Draft
+
+---
+
+## Executive Summary
+
+MCP Twin Cloud transforms the open-source mcp-twin CLI into a managed cloud service, enabling developers to deploy, manage, and scale MCP servers with zero-downtime updates. The platform provides multi-tenant hosting, observability, and enterprise-grade reliability for AI agent infrastructure.
+
+**Target Market:** Developers and teams using Claude, Cursor, Cline, VS Code, and Windsurf with multiple MCP servers.
+
+**Business Model:** Freemium SaaS with tiered pricing based on usage (requests/month) and features.
+
+---
+
+## Goals & Success Metrics
+
+### Primary Goals
+
+1. **Launch MVP in 3 weeks** with functional auth, billing, and twin management
+2. **Acquire 150+ free signups** in first month
+3. **Convert 5% to paid** within 60 days
+4. **Demonstrate investor-ready metrics** (MRR, unit economics, growth rate)
+
+### Success Metrics
+
+| Metric | Week 1 | Week 2 | Week 3 | Month 2 |
+|--------|--------|--------|--------|---------|
+| Signups | 50 | 100 | 150 | 300 |
+| Paid Users | 0 | 2 | 5 | 15 |
+| MRR | $0 | $58 | $295 | $1,000 |
+| API Calls | 10K | 50K | 200K | 1M |
+
+---
+
+## User Personas
+
+### Persona 1: Solo AI Developer ("Alex")
+- Building AI agents with Claude/Cursor
+- Uses 2-3 MCP servers locally
+- Pain: Restarting clients when updating servers
+- Value: Zero-downtime, simple deployment
+
+### Persona 2: AI Agency Lead ("Jordan")
+- Manages 5-10 MCP servers for clients
+- Needs observability and multi-tenant isolation
+- Pain: No centralized management, no usage metrics
+- Value: Dashboard, logs, client billing data
+
+### Persona 3: Enterprise Platform Team ("Sam")
+- Deploying AI agents at scale (50+ servers)
+- Requires SLAs, audit logs, SSO
+- Pain: Building custom orchestration layer
+- Value: Enterprise features, dedicated support
+
+---
+
+## Feature Requirements
+
+### Phase 1: Cloud Hosting + Auth (Week 1)
+
+#### 1.1 HTTP API Server Mode
+
+**Description:** Add cloud server mode to existing mcp-twin CLI.
+
+**User Story:** As a developer, I want to run `npx mcp-twin --cloud` to start mcp-twin as an HTTP service so I can deploy it to cloud infrastructure.
+
+**Requirements:**
+- [ ] Add `--cloud` flag to CLI
+- [ ] Start Express HTTP server on port 3000 (configurable via `--port`)
+- [ ] Support environment-based configuration (DATABASE_URL, STRIPE_KEY, etc.)
+- [ ] Health check endpoint: `GET /health`
+- [ ] Graceful shutdown handling
+
+#### 1.2 Authentication System
+
+**Description:** Email/password auth with API key generation.
+
+**User Stories:**
+- As a new user, I want to sign up with email/password so I can access the platform
+- As a user, I want to generate API keys so I can authenticate my MCP clients
+- As a user, I want to revoke API keys so I can maintain security
+
+**API Endpoints:**
+
+| Method | Endpoint | Description | Auth |
+|--------|----------|-------------|------|
+| POST | `/api/auth/signup` | Create account | None |
+| POST | `/api/auth/login` | Get session token | None |
+| POST | `/api/auth/api-keys` | Generate API key | Session |
+| DELETE | `/api/auth/api-keys/:id` | Revoke API key | Session |
+| GET | `/api/auth/me` | Get current user | API Key |
+
+**Request/Response Examples:**
+
+```typescript
+// POST /api/auth/signup
+Request: {
+  email: "user@example.com",
+  password: "securepassword123"
+}
+Response: {
+  userId: "uuid",
+  apiKey: "mtc_live_xxxxx",
+  message: "Welcome! Use this API key to create twins."
+}
+
+// POST /api/auth/login
+Request: {
+  email: "user@example.com",
+  password: "securepassword123"
+}
+Response: {
+  sessionToken: "jwt_token",
+  expiresAt: "2024-01-30T00:00:00Z"
+}
+```
+
+#### 1.3 Twin Management
+
+**Description:** CRUD operations for twin configurations.
+
+**User Stories:**
+- As a user, I want to create a twin configuration so my MCP server runs in the cloud
+- As a user, I want to list my twins so I can manage them
+- As a user, I want to update twin config so I can change settings without recreating
+- As a user, I want to delete twins I no longer need
+
+**API Endpoints:**
+
+| Method | Endpoint | Description | Auth |
+|--------|----------|-------------|------|
+| POST | `/api/twins` | Create twin | API Key |
+| GET | `/api/twins` | List user's twins | API Key |
+| GET | `/api/twins/:id` | Get twin details | API Key |
+| PATCH | `/api/twins/:id` | Update twin config | API Key |
+| DELETE | `/api/twins/:id` | Delete twin | API Key |
+| POST | `/api/twins/:id/call` | Execute tool call | API Key |
+| GET | `/api/twins/:id/logs` | Get execution logs | API Key |
+| GET | `/api/twins/:id/status` | Get twin health | API Key |
+
+**Request/Response Examples:**
+
+```typescript
+// POST /api/twins
+Request: {
+  name: "my-mcp-server",
+  config: {
+    script: "/path/to/server.py",
+    ports: [8101, 8102],
+    healthEndpoint: "/health",
+    startupTimeout: 10
+  }
+}
+Response: {
+  twinId: "uuid",
+  name: "my-mcp-server",
+  status: "provisioning",
+  endpoints: {
+    active: "https://twins.mcp-twin.cloud/t/uuid/a",
+    standby: "https://twins.mcp-twin.cloud/t/uuid/b"
+  }
+}
+
+// POST /api/twins/:id/call
+Request: {
+  toolName: "search_files",
+  args: { query: "*.py", path: "/src" }
+}
+Response: {
+  result: { files: ["main.py", "utils.py"] },
+  durationMs: 45,
+  server: "a",
+  requestId: "req_xxxxx"
+}
+```
+
+#### 1.4 Observability & Logging
+
+**Description:** Automatic logging of all tool calls with searchable history.
+
+**User Stories:**
+- As a user, I want to see logs of all tool calls so I can debug issues
+- As a user, I want to filter logs by status/time so I can find specific events
+- As a user, I want to see latency metrics so I can monitor performance
+
+**Log Entry Schema:**
+```typescript
+interface LogEntry {
+  id: string;
+  twinId: string;
+  userId: string;
+  toolName: string;
+  args: object;
+  result: object | null;
+  error: string | null;
+  status: 'success' | 'error' | 'timeout';
+  durationMs: number;
+  server: 'a' | 'b';
+  createdAt: Date;
+}
+```
+
+---
+
+### Phase 2: Stripe Integration + Billing (Week 2)
+
+#### 2.1 Stripe Setup
+
+**Description:** Payment processing with Stripe for subscriptions.
+
+**Products/Prices:**
+
+| Tier | Price | Stripe Price ID |
+|------|-------|-----------------|
+| Free | $0/month | (no subscription) |
+| Starter | $29/month | price_starter_monthly |
+| Professional | $149/month | price_pro_monthly |
+| Enterprise | Custom | (contact sales) |
+
+**Webhook Events to Handle:**
+- `checkout.session.completed` → Activate subscription
+- `customer.subscription.updated` → Update tier
+- `customer.subscription.deleted` → Downgrade to free
+- `invoice.payment_failed` → Send warning email
+
+#### 2.2 Usage Tracking & Quotas
+
+**Description:** Track API usage and enforce tier limits.
+
+**Tier Limits:**
+
+| Tier | Twins | Requests/Month | Log Retention | Support |
+|------|-------|----------------|---------------|---------|
+| Free | 1 | 10,000 | 24 hours | Community |
+| Starter | 5 | 100,000 | 7 days | Email |
+| Professional | Unlimited | 1,000,000 | 30 days | Priority |
+| Enterprise | Unlimited | Unlimited | 90 days | Dedicated |
+
+**Quota Enforcement:**
+- Check usage on every `/api/twins/:id/call` request
+- Return 429 when quota exceeded with upgrade prompt
+- Reset quota on 1st of each month (UTC)
+
+**API Endpoints:**
+
+| Method | Endpoint | Description | Auth |
+|--------|----------|-------------|------|
+| GET | `/api/usage` | Get current month usage | API Key |
+| GET | `/api/usage/history` | Get usage history | API Key |
+
+```typescript
+// GET /api/usage
+Response: {
+  tier: "starter",
+  period: { start: "2024-01-01", end: "2024-01-31" },
+  twins: { used: 3, limit: 5 },
+  requests: { used: 45000, limit: 100000 },
+  percentUsed: 45
+}
+```
+
+#### 2.3 Billing Portal
+
+**Description:** Self-service billing management.
+
+**User Stories:**
+- As a user, I want to upgrade my plan so I can get more features
+- As a user, I want to see my invoices so I can track spending
+- As a user, I want to update payment method so my subscription continues
+
+**API Endpoints:**
+
+| Method | Endpoint | Description | Auth |
+|--------|----------|-------------|------|
+| POST | `/api/billing/checkout` | Create Stripe checkout session | Session |
+| POST | `/api/billing/portal` | Create Stripe billing portal session | Session |
+| GET | `/api/billing/invoices` | List invoices | Session |
+
+---
+
+### Phase 3: Landing Page + Public Demo (Week 3)
+
+#### 3.1 Marketing Landing Page
+
+**Description:** Public-facing website to convert visitors to signups.
+
+**Pages:**
+- `/` - Hero + features + pricing + CTA
+- `/pricing` - Detailed pricing comparison
+- `/docs` - API documentation
+- `/blog` - Content marketing
+- `/login` - Auth flow
+- `/dashboard` - User dashboard (authenticated)
+
+**Hero Section Content:**
+```
+MCP Twin Cloud
+Deploy MCP servers in seconds. Zero downtime, infinite scale.
+
+[Start Free] [View Pricing]
+
+Trusted by developers at: [logos]
+```
+
+**Features Section:**
+- One API key, infinite twins
+- Auto-scaling, no ops needed
+- Built-in observability
+- Works with Claude, Cursor, Cline, VS Code, Windsurf
+- Zero-downtime updates
+- 99.9% uptime SLA (Pro+)
+
+#### 3.2 Dashboard UI
+
+**Description:** Web dashboard for managing twins and viewing usage.
+
+**Dashboard Views:**
+1. **Overview** - Usage stats, quick actions, recent logs
+2. **Twins** - List/create/manage twins
+3. **Logs** - Searchable log viewer
+4. **Settings** - API keys, profile, billing
+5. **Billing** - Current plan, usage, upgrade
+
+**Dashboard Wireframe:**
+```
+┌─────────────────────────────────────────────────────────────┐
+│  MCP Twin Cloud                    [Docs] [Settings] [User] │
+├─────────────┬───────────────────────────────────────────────┤
+│             │                                               │
+│  Overview   │   Usage This Month                            │
+│  Twins      │   ████████████░░░░░░░░  45,000 / 100,000     │
+│  Logs       │                                               │
+│  Settings   │   Active Twins (3/5)                          │
+│  Billing    │   ┌─────────┬─────────┬─────────┐            │
+│             │   │ inbox   │ phi     │ tools   │            │
+│             │   │ ● Active│ ● Active│ ○ Idle  │            │
+│             │   └─────────┴─────────┴─────────┘            │
+│             │                                               │
+│             │   Recent Activity                             │
+│             │   • search_files called (45ms) - 2m ago      │
+│             │   • get_message called (120ms) - 5m ago      │
+│             │   • send_message called (89ms) - 8m ago      │
+│             │                                               │
+└─────────────┴───────────────────────────────────────────────┘
+```
+
+#### 3.3 Demo Video
+
+**Description:** 60-second product demo for marketing.
+
+**Script:**
+1. (0-10s) "Deploy MCP servers in seconds with MCP Twin Cloud"
+2. (10-25s) Show signup flow → create twin → get API key
+3. (25-40s) Show tool call execution → logs appear
+4. (40-55s) Show usage dashboard → pricing tiers
+5. (55-60s) CTA: "Start free at mcp-twin.cloud"
+
+---
+
+## Technical Architecture
+
+### System Diagram
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                        MCP Twin Cloud                            │
+│                                                                  │
+│  ┌──────────────┐    ┌──────────────┐    ┌──────────────┐      │
+│  │   Vercel     │    │   Railway    │    │   Stripe     │      │
+│  │   (Frontend) │    │   (Backend)  │    │   (Billing)  │      │
+│  │              │    │              │    │              │      │
+│  │  - Landing   │◄──►│  - API       │◄──►│  - Payments  │      │
+│  │  - Dashboard │    │  - Workers   │    │  - Webhooks  │      │
+│  │  - Docs      │    │  - Twins     │    │              │      │
+│  └──────────────┘    └──────┬───────┘    └──────────────┘      │
+│                             │                                    │
+│                      ┌──────▼───────┐                           │
+│                      │  PostgreSQL  │                           │
+│                      │  (Supabase)  │                           │
+│                      │              │                           │
+│                      │  - users     │                           │
+│                      │  - twins     │                           │
+│                      │  - logs      │                           │
+│                      │  - api_keys  │                           │
+│                      └──────────────┘                           │
+│                                                                  │
+└─────────────────────────────────────────────────────────────────┘
+
+        │                    │                    │
+        ▼                    ▼                    ▼
+   ┌─────────┐         ┌─────────┐         ┌─────────┐
+   │ Claude  │         │ Cursor  │         │  Cline  │
+   │ Desktop │         │         │         │         │
+   └─────────┘         └─────────┘         └─────────┘
+```
+
+### Tech Stack
+
+| Layer | Technology | Rationale |
+|-------|------------|-----------|
+| Frontend | Next.js 14 + Tailwind | Fast, SEO-friendly, Vercel-native |
+| Backend | Node.js + Express | Same language as mcp-twin CLI |
+| Database | PostgreSQL (Supabase) | Free tier, realtime, auth helpers |
+| Payments | Stripe | Industry standard, great DX |
+| Hosting | Vercel + Railway | Free/cheap, auto-scaling |
+| Auth | Custom JWT + API Keys | Simple, no vendor lock-in |
+
+### Database Schema
+
+```sql
+-- Users table
+CREATE TABLE users (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  email VARCHAR(255) UNIQUE NOT NULL,
+  password_hash VARCHAR(255) NOT NULL,
+  tier VARCHAR(20) DEFAULT 'free' CHECK (tier IN ('free', 'starter', 'pro', 'enterprise')),
+  stripe_customer_id VARCHAR(255),
+  stripe_subscription_id VARCHAR(255),
+  created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
+  updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
+);
+
+-- API Keys table
+CREATE TABLE api_keys (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  user_id UUID REFERENCES users(id) ON DELETE CASCADE,
+  key_hash VARCHAR(255) NOT NULL,
+  key_prefix VARCHAR(20) NOT NULL,  -- "mtc_live_abc" for display
+  name VARCHAR(100),
+  last_used_at TIMESTAMP WITH TIME ZONE,
+  created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
+  revoked_at TIMESTAMP WITH TIME ZONE
+);
+
+-- Twins table
+CREATE TABLE twins (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  user_id UUID REFERENCES users(id) ON DELETE CASCADE,
+  name VARCHAR(100) NOT NULL,
+  config_json JSONB NOT NULL,
+  status VARCHAR(20) DEFAULT 'stopped' CHECK (status IN ('stopped', 'starting', 'running', 'error')),
+  active_server VARCHAR(1) DEFAULT 'a' CHECK (active_server IN ('a', 'b')),
+  port_a INTEGER,
+  port_b INTEGER,
+  created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
+  updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
+);
+
+-- Logs table (partitioned by month for performance)
+CREATE TABLE logs (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  user_id UUID REFERENCES users(id) ON DELETE CASCADE,
+  twin_id UUID REFERENCES twins(id) ON DELETE CASCADE,
+  tool_name VARCHAR(100) NOT NULL,
+  args JSONB,
+  result JSONB,
+  error TEXT,
+  status VARCHAR(20) NOT NULL CHECK (status IN ('success', 'error', 'timeout')),
+  duration_ms INTEGER NOT NULL,
+  server VARCHAR(1) NOT NULL CHECK (server IN ('a', 'b')),
+  created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
+);
+
+-- Usage tracking (aggregated daily)
+CREATE TABLE usage_daily (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  user_id UUID REFERENCES users(id) ON DELETE CASCADE,
+  date DATE NOT NULL,
+  request_count INTEGER DEFAULT 0,
+  error_count INTEGER DEFAULT 0,
+  total_duration_ms BIGINT DEFAULT 0,
+  UNIQUE(user_id, date)
+);
+
+-- Indexes
+CREATE INDEX idx_api_keys_hash ON api_keys(key_hash) WHERE revoked_at IS NULL;
+CREATE INDEX idx_twins_user ON twins(user_id);
+CREATE INDEX idx_logs_twin_created ON logs(twin_id, created_at DESC);
+CREATE INDEX idx_logs_user_created ON logs(user_id, created_at DESC);
+CREATE INDEX idx_usage_user_date ON usage_daily(user_id, date DESC);
+```
+
+---
+
+## API Specification
+
+### Authentication
+
+All authenticated endpoints require one of:
+- **API Key**: `Authorization: Bearer mtc_live_xxxxx`
+- **Session Token**: `Authorization: Bearer jwt_xxxxx` (for dashboard)
+
+### Rate Limits
+
+| Tier | Requests/Second | Burst |
+|------|-----------------|-------|
+| Free | 10 | 20 |
+| Starter | 50 | 100 |
+| Pro | 200 | 500 |
+| Enterprise | Custom | Custom |
+
+### Error Responses
+
+```typescript
+interface ErrorResponse {
+  error: {
+    code: string;      // "QUOTA_EXCEEDED", "UNAUTHORIZED", etc.
+    message: string;   // Human-readable message
+    details?: object;  // Additional context
+  }
+}
+```
+
+**Error Codes:**
+
+| Code | HTTP Status | Description |
+|------|-------------|-------------|
+| UNAUTHORIZED | 401 | Invalid or missing API key |
+| FORBIDDEN | 403 | Valid key but no access to resource |
+| NOT_FOUND | 404 | Resource doesn't exist |
+| QUOTA_EXCEEDED | 429 | Monthly quota exceeded |
+| RATE_LIMITED | 429 | Too many requests per second |
+| VALIDATION_ERROR | 400 | Invalid request body |
+| INTERNAL_ERROR | 500 | Server error |
+
+---
+
+## Implementation Timeline
+
+### Week 1: Core Infrastructure
+
+| Day | Tasks | Owner |
+|-----|-------|-------|
+| 1 | Set up repo, database, basic Express server | Dev |
+| 2 | Implement auth endpoints (signup, login, API keys) | Dev |
+| 3 | Implement twin CRUD endpoints | Dev |
+| 4 | Implement tool call proxy + logging | Dev |
+| 5 | Deploy to Railway, test E2E | Dev |
+
+**Deliverables:**
+- [ ] Working API at `api.mcp-twin.cloud`
+- [ ] Database provisioned on Supabase
+- [ ] Auth flow functional
+- [ ] One twin can be created and called
+
+### Week 2: Billing + Quotas
+
+| Day | Tasks | Owner |
+|-----|-------|-------|
+| 1 | Stripe account setup, products created | Dev |
+| 2 | Implement checkout + webhook handlers | Dev |
+| 3 | Implement usage tracking + quota enforcement | Dev |
+| 4 | Build billing portal page | Dev |
+| 5 | Test full billing flow end-to-end | Dev |
+
+**Deliverables:**
+- [ ] Stripe integration live
+- [ ] Users can upgrade/downgrade
+- [ ] Quotas enforced correctly
+- [ ] Billing portal functional
+
+### Week 3: Frontend + Launch
+
+| Day | Tasks | Owner |
+|-----|-------|-------|
+| 1 | Build landing page (Next.js) | Dev |
+| 2 | Build dashboard UI | Dev |
+| 3 | Build docs site | Dev |
+| 4 | Record demo video | Dev |
+| 5 | Launch: Product Hunt, r/mcp, HN | Dev |
+
+**Deliverables:**
+- [ ] Landing page live at `mcp-twin.cloud`
+- [ ] Dashboard functional
+- [ ] Demo video published
+- [ ] Launch posts submitted
+
+---
+
+## Business Model
+
+### Pricing Strategy
+
+**Positioning:** Premium pricing for reliability + zero-downtime value.
+
+| Tier | Price | Target User | Key Value |
+|------|-------|-------------|-----------|
+| Free | $0 | Individual devs trying it out | Get hooked |
+| Starter | $29/mo | Serious hobbyists, small projects | Remove limits |
+| Pro | $149/mo | Agencies, startups | Unlimited + priority |
+| Enterprise | Custom | Large orgs | SLA, SSO, support |
+
+### Unit Economics
+
+| Metric | Value | Notes |
+|--------|-------|-------|
+| Hosting cost per user | ~$2/mo | Railway compute + Supabase |
+| Stripe fees | 2.9% + $0.30 | Per transaction |
+| Gross margin (Starter) | 90% | $29 - $2.90 - $2 = $24.10 |
+| Gross margin (Pro) | 95% | $149 - $4.62 - $2 = $142.38 |
+| Target CAC | <$50 | Organic + content marketing |
+| Target LTV | $600 | 12 months avg retention |
+| LTV:CAC | 12:1 | Healthy SaaS ratio |
+
+### Revenue Projections
+
+| Month | Free Users | Paid Users | MRR |
+|-------|------------|------------|-----|
+| 1 | 150 | 5 | $445 |
+| 2 | 300 | 15 | $1,335 |
+| 3 | 500 | 35 | $3,115 |
+| 6 | 1,500 | 120 | $10,680 |
+| 12 | 5,000 | 500 | $44,500 |
+
+---
+
+## Risks & Mitigations
+
+| Risk | Likelihood | Impact | Mitigation |
+|------|------------|--------|------------|
+| Low initial adoption | Medium | High | Strong content marketing, r/mcp presence |
+| Technical issues at scale | Medium | High | Start with conservative limits, monitor closely |
+| Competitor enters market | Low | Medium | Move fast, build brand, focus on DX |
+| Stripe account issues | Low | High | Keep reserves, document compliance |
+| MCP protocol changes | Medium | Medium | Stay close to Anthropic, adapt quickly |
+
+---
+
+## Success Criteria
+
+### MVP Success (Week 3)
+- [ ] 100+ signups
+- [ ] 5+ paid users
+- [ ] $200+ MRR
+- [ ] 99% uptime
+- [ ] <500ms avg latency
+
+### Month 3 Success
+- [ ] 500+ signups
+- [ ] 35+ paid users
+- [ ] $3,000+ MRR
+- [ ] 3+ testimonials
+- [ ] Investor deck ready
+
+---
+
+## Appendix
+
+### Competitor Analysis
+
+| Competitor | Offering | Pricing | Gap |
+|------------|----------|---------|-----|
+| MCPTotal | MCP marketplace | Unknown | No zero-downtime |
+| Klavis AI | Managed MCP hosting | Unknown | No multi-client support |
+| Self-hosted | DIY | Free | No observability, manual |
+
+### Investor FAQ
+
+**Q: How do you differentiate from renting MCP servers?**
+A: We're the orchestration layer solving multi-tenant governance, observability, and vendor lock-in. Platform, not tool.
+
+**Q: What's your TAM?**
+A: Enterprise AI agent deployment. $50B market by 2030 (Gartner). Targeting teams with 5+ MCP servers.
+
+**Q: How do you acquire customers?**
+A: Developer-first. Partner with MCP creators, post on r/mcp, HN, Dev.to. Target agencies first.
+
+**Q: What's your moat?**
+A: First-mover in meta-layer architecture. Network effects from MCP server ecosystem.
+
+---
+
+## Document History
+
+| Version | Date | Author | Changes |
+|---------|------|--------|---------|
+| 1.0 | 2024-12-31 | Prax Labs | Initial PRD |