@bitsbound/mcp-server 1.0.14 → 1.2.0

package/dist/types/Bitsbound_Kings_McpServer_Backend_Types.js

@@ -3,130 +3,97 @@
 ////////////////////////////////////////
 // NO NEW FILES!!!!!!!!!
 ////////////////////////////////////////
-export const DEFAULT_API_URL = 'https://bitsbound-saas-backend-mxb1.onrender.com';
+export const DEFAULT_API_URL = 'https://bitsbound-contract-backend.onrender.com';
 // ══════════════════════════════════════════════════════════════════════════════════════════════════════════════════
 // MCP Tool Definitions 'R_DVT_G_D_ToolDefs' - Tool schemas for MCP protocol
 // ══════════════════════════════════════════════════════════════════════════════════════════════════════════════════
 export const TOOL_DEFINITIONS = {
-    process_contract: {
-        name: 'process_contract',
-        description: `Process a contract through the full 8-stage BitsBound pipeline.
-
-⚠️ BEFORE CALLING THIS TOOL: You MUST gather the following information from the user:
+    // ════════════════════════════════════════════════════════════════════════════════════════════════════════════════
+    // CORE TOOLS - 4-tool interface for Claude Code Plugin Marketplace
+    // ════════════════════════════════════════════════════════════════════════════════════════════════════════════════
+    // ────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+    // REDLINE MODE: Attack existing counterparty contract with parallel SAC agents
+    // ────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+    redline_swarm: {
+        name: 'redline_swarm',
+        description: `**REDLINE MODE** - Attack counterparty's contract with parallel AI agents.
 
-**REQUIRED - Ask the user:**
-1. representingParty: "Are you representing the Customer (buyer) or Vendor (seller)?"
-2. aggressivenessLevel: "On a scale of 1-10, how aggressive should the redlines be? (1=very conciliatory, 5=balanced, 10=very aggressive)"
+Upload a DOCX contract and BitsBound's Instant Swarm™ deploys parallel SAC (Supreme AI Co-Counsel) agents to analyze and redline every section simultaneously. Returns partner-level redlined DOCX with real OOXML Track Changes (w:ins/w:del), negotiation email, and risk analysis.
 
-**RECOMMENDED - Ask if not obvious:**
-3. paperOwnership: "Did the counterparty draft this contract (their paper) or did you draft it (our paper)?"
-4. dealValue + dealValueCurrency: "What's the estimated deal value?"
-5. industry: "What industry is this contract for?"
-6. additionalContext: "Any special context about this deal or relationship I should know?"
+**REQUIRED INPUTS (ask the user):**
+1. File path to the counterparty's DOCX contract
+2. Contract type: saas, ma, vc, employment, nda, equipment, commercial-lease, professional-services, or miscellaneous
+3. Who you represent: customer/vendor (saas), buyer/seller (ma), investor/founder (vc), etc.
+4. Aggressiveness level: 1-10 (1=conciliatory, 5=balanced, 10=aggressive)
 
-**FOR EMAIL GENERATION - Ask:**
-7. emailRecipient: "Should I generate a negotiation email to send to the counterparty?"
-8. If yes: recipientName, senderName (your name), any additionalContext for the email tone
+**OPTIONAL:** dealValue, additionalContext, emailRecipient info
 
-After gathering this context, call the tool. The response includes "importantNote" with when to check back (~45 min).
+**DELIVERABLES:**
+• Redlined DOCX with real Track Changes (not markup - actual w:ins/w:del)
+• Negotiation email explaining each requested change
+• Favorability score and risk analysis
 
-Pipeline: (1) Context Loading, (2) Data Extraction, (3) Party Identification, (4) Research, (5) AI Analysis with 18+ analyzers, (6) Instant Swarm™ redlining, (7) Email Generation, (8) Synthesis.`,
+Analysis takes ~25-35 minutes. Response includes 'checkBackTime' for when to check status.`,
         inputSchema: {
             type: 'object',
             properties: {
-                // ══════════════════════════════════════════════════════════════════════
-                // FILE INPUT (one required)
-                // ══════════════════════════════════════════════════════════════════════
                 filePath: {
                     type: 'string',
-                    description: 'RECOMMENDED: Absolute path to the DOCX file on disk (e.g., "/Users/john/Documents/contract.docx"). The server will read and encode the file automatically.'
+                    description: 'RECOMMENDED: Absolute path to DOCX file (e.g., "/Users/john/Documents/contract.docx"). Server reads file directly.'
                 },
                 docxBase64: {
                     type: 'string',
-                    description: 'Alternative: The contract document already encoded as base64 string (DOCX format). Use filePath instead if possible.'
+                    description: 'Alternative: Base64-encoded DOCX content. Use filePath instead when possible.'
                 },
                 fileName: {
                     type: 'string',
-                    description: 'Original filename of the document. If using filePath, this is extracted automatically.'
+                    description: 'Original filename. Auto-extracted if using filePath.'
+                },
+                contractVertical: {
+                    type: 'string',
+                    enum: ['saas', 'ma', 'vc', 'employment', 'nda', 'equipment-lease', 'equipment-financing', 'security-agreement', 'loan', 'commercial-lease', 'professional-services', 'miscellaneous'],
+                    description: 'Contract type. Determines analyzers and party options.'
                 },
-                // ══════════════════════════════════════════════════════════════════════
-                // DEAL CONTEXT (ask user for these!)
-                // ══════════════════════════════════════════════════════════════════════
                 representingParty: {
                     type: 'string',
-                    enum: ['customer', 'vendor', 'neutral'],
-                    description: 'REQUIRED: Who are you representing? customer=buyer, vendor=seller, neutral=balanced review'
+                    description: 'Who you represent: saas(customer/vendor), ma(buyer/seller), vc(investor/founder), employment(employer/employee), nda(disclosing-party/receiving-party), equipment-lease(lessee/lessor), equipment-financing(debtor/secured-party), security-agreement(debtor/secured-party), commercial-lease(tenant/landlord), professional-services(client/service-provider), loan(borrower/lender)'
+                },
+                aggressivenessLevel: {
+                    type: 'number',
+                    minimum: 1,
+                    maximum: 10,
+                    description: 'Redline aggressiveness 1-10. Default: 5'
                 },
                 dealValue: {
                     type: 'number',
-                    description: 'Estimated deal value / annual contract value (ACV). Helps calibrate risk thresholds.'
+                    description: 'Optional: Deal value for risk calibration'
                 },
                 dealValueCurrency: {
                     type: 'string',
                     enum: ['USD', 'EUR', 'GBP', 'CAD', 'AUD'],
-                    description: 'Currency for deal value. Default: USD'
-                },
-                industry: {
-                    type: 'string',
-                    enum: ['technology', 'healthcare', 'financial', 'retail', 'manufacturing', 'professional', 'media', 'education', 'government', 'other'],
-                    description: 'Industry context for analysis. Affects regulatory considerations and benchmarks.'
+                    description: 'Currency. Default: USD'
                 },
                 additionalContext: {
                     type: 'string',
-                    description: 'Free-form context about the deal: relationship history, priorities, concerns, red lines, etc.'
+                    description: 'Optional: Deal context, priorities, relationship notes'
                 },
                 paperOwnership: {
                     type: 'string',
                     enum: ['their-paper', 'our-paper'],
-                    description: 'Who drafted the contract? their-paper=counterparty drafted (default, full analysis), our-paper=we drafted (review their markup only)'
+                    description: 'Who drafted? their-paper=counterparty (default), our-paper=we drafted'
                 },
-                // ══════════════════════════════════════════════════════════════════════
-                // SAC/REDLINE SETTINGS
-                // ══════════════════════════════════════════════════════════════════════
-                aggressivenessLevel: {
-                    type: 'number',
-                    minimum: 1,
-                    maximum: 10,
-                    description: 'IMPORTANT: Redline aggressiveness 1-10. 1=very conciliatory (accept most terms), 5=balanced (default), 10=very aggressive (push hard on everything)'
-                },
-                enableAutoSwarm: {
-                    type: 'boolean',
-                    description: 'Enable parallel 17-section SAC analysis for comprehensive redlines. Default: true'
-                },
-                analysisDepth: {
-                    type: 'string',
-                    enum: ['quick', 'standard', 'deep'],
-                    description: 'Analysis depth: quick (~10 min), standard (~30 min), deep (~45 min). Default: standard'
-                },
-                // ══════════════════════════════════════════════════════════════════════
-                // EMAIL GENERATION
-                // ══════════════════════════════════════════════════════════════════════
                 enableEmailGenerator: {
                     type: 'boolean',
-                    description: 'Generate a negotiation email summarizing redlines? Default: true'
-                },
-                emailRecipient: {
-                    type: 'string',
-                    enum: ['client', 'counterparty', 'none'],
-                    description: 'Who should the email be addressed to? counterparty=send to other side, client=internal summary, none=skip email'
+                    description: 'Generate negotiation email? Default: true'
                 },
                 emailContext: {
                     type: 'object',
-                    description: 'Additional context for email generation',
+                    description: 'Email context',
                     properties: {
-                        recipientName: { type: 'string', description: 'Name of email recipient (e.g., "John Smith")' },
-                        recipientEmail: { type: 'string', description: 'Email address of recipient' },
-                        senderName: { type: 'string', description: 'Your name (the sender)' },
-                        additionalContext: { type: 'string', description: 'Tone/relationship notes for the email (e.g., "We have a good relationship with this vendor")' }
+                        recipientName: { type: 'string' },
+                        senderName: { type: 'string' },
+                        additionalContext: { type: 'string' }
                     }
-                },
-                // ══════════════════════════════════════════════════════════════════════
-                // DEPRECATED (use representingParty instead)
-                // ══════════════════════════════════════════════════════════════════════
-                perspective: {
-                    type: 'string',
-                    enum: ['customer', 'vendor', 'neutral'],
-                    description: 'DEPRECATED: Use representingParty instead'
                 }
             },
             required: []
@@ -136,260 +103,115 @@ Pipeline: (1) Context Loading, (2) Data Extraction, (3) Party Identification, (4
             destructiveHint: false
         }
     },
-    get_analysis_status: {
-        name: 'get_analysis_status',
-        description: 'Check the status of a running or completed contract analysis. Returns progress through the 8-stage pipeline (Context→Extraction→Parties→Research→Analysis→Swarm→Email→Synthesis). When complete, returns deliverables with CLICKABLE BROWSER LINKS: (1) redlinedDocxUrl - presigned URL to download the redlined DOCX (works directly in browser, valid 1 hour), (2) negotiationEmailUrl - URL to view the negotiation email in browser. ALWAYS display both URLs to the user as clickable links.',
+    // ────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+    // DRAFT MODE: Generate contract from scratch with multi-pass AI refinement
+    // ────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+    power_draft: {
+        name: 'power_draft',
+        description: `**DRAFT MODE** - Generate a complete contract from scratch.
+
+NO FILE UPLOAD NEEDED. Provide deal context and BitsBound generates a partner-level contract using a multi-pass architecture:
+1. Opus 4.5 generates initial draft based on your requirements
+2. 16+ parallel analyzers critique the draft
+3. Sonnet 4.5 synthesizes analyzer feedback
+4. Opus 4.5 generates refined second draft
+5. Final QB Enhancer pass for consistency
+
+**REQUIRED INPUTS (ask the user):**
+1. Contract type: saas, ma, vc, employment, nda, equipment-lease, commercial-lease, professional-services
+2. Who you represent: customer/vendor (saas), buyer/seller (ma), investor/founder (vc), etc.
+3. Terms Favorability: 1-10 (1=minimal protections/fast close, 5=balanced, 10=maximum protections/bulletproof)
+
+**RECOMMENDED:** Additional context describing the deal (value, term, key requirements, counterparty info)
+
+**DELIVERABLES:**
+• Clean DOCX ready for negotiation (no Track Changes needed - it's your paper)
+• Cover email introducing the draft (optional)
+• Risk analysis of your own positions
+
+Draft generation takes ~30-40 minutes. Response includes 'checkBackTime' for when to check status.`,
         inputSchema: {
             type: 'object',
             properties: {
-                analysisId: {
+                // ════════════════════════════════════════════════════════════════════════════
+                // REQUIRED - Core Draft Parameters (matches UI)
+                // ════════════════════════════════════════════════════════════════════════════
+                contractVertical: {
                     type: 'string',
-                    description: 'The processing ID returned from process_contract'
-                }
-            },
-            required: ['analysisId']
-        },
-        annotations: {
-            readOnlyHint: true
-        }
-    },
-    ask_sac: {
-        name: 'ask_sac',
-        description: 'Ask the Supreme AI Co-Counsel (SAC) questions about an analyzed contract. SAC has full context of the contract and all analysis results. Great for clarifying risks, understanding clauses, or getting negotiation advice.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                analysisId: {
-                    type: 'string',
-                    description: 'The analysis ID of a completed analysis'
-                },
-                question: {
-                    type: 'string',
-                    description: 'Your question about the contract'
+                    enum: ['saas', 'ma', 'vc', 'employment', 'nda', 'equipment-lease', 'equipment-financing', 'security-agreement', 'loan', 'commercial-lease', 'professional-services'],
+                    description: 'Contract type to generate. REQUIRED.'
                 },
-                includeClauseCitations: {
-                    type: 'boolean',
-                    description: 'Include specific clause citations in the response. Default: true'
-                }
-            },
-            required: ['analysisId', 'question']
-        },
-        annotations: {
-            readOnlyHint: true
-        }
-    },
-    generate_redline: {
-        name: 'generate_redline',
-        description: 'Generate a redlined Word document with real OOXML Track Changes (w:ins, w:del) applied directly to the original document. Returns the redlined DOCX as base64.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                analysisId: {
+                representingParty: {
                     type: 'string',
-                    description: 'The analysis ID of a completed analysis'
+                    description: 'Who you represent (sets protective posture). REQUIRED. Options by vertical: saas(customer/vendor), ma(buyer/seller), vc(investor/founder), employment(employer/employee), nda(disclosing-party/receiving-party), equipment-lease(lessee/lessor), commercial-lease(tenant/landlord), professional-services(client/service-provider)'
                 },
-                aggressiveness: {
+                aggressivenessLevel: {
                     type: 'number',
-                    enum: [1, 2, 3, 4, 5],
-                    description: 'How aggressive the redlines should be (1=conservative, 5=aggressive). Default: 3'
-                },
-                includeComments: {
-                    type: 'boolean',
-                    description: 'Include rationale comments in Word margins. Default: true'
-                }
-            },
-            required: ['analysisId']
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false
-        }
-    },
-    generate_negotiation_email: {
-        name: 'generate_negotiation_email',
-        description: 'Generate a professional negotiation email to send to the counterparty, explaining requested changes and their rationale.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                analysisId: {
-                    type: 'string',
-                    description: 'The analysis ID of a completed analysis'
+                    minimum: 1,
+                    maximum: 10,
+                    description: 'Terms Favorability 1-10: How protective for YOUR party. 1=minimal protections (fast close), 5=balanced (default), 10=maximum protections (bulletproof). REQUIRED.'
                 },
-                tone: {
-                    type: 'string',
-                    enum: ['collaborative', 'firm', 'aggressive'],
-                    description: 'Tone of the email. Default: collaborative'
+                // ════════════════════════════════════════════════════════════════════════════
+                // OPTIONAL - Deal Context (highly recommended for better output)
+                // ════════════════════════════════════════════════════════════════════════════
+                dealValue: {
+                    type: 'number',
+                    description: 'Annual Contract Value for risk calibration. Optional but recommended.'
                 },
-                recipientRole: {
-                    type: 'string',
-                    description: 'Role of the recipient (e.g., "General Counsel", "Sales Rep", "Procurement"). Helps tailor the message.'
-                }
-            },
-            required: ['analysisId']
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false
-        }
-    },
-    extract_clause: {
-        name: 'extract_clause',
-        description: 'Extract and analyze a specific clause type from an analyzed contract. Returns the clause text, risk analysis, and suggested improvements.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                analysisId: {
+                dealValueCurrency: {
                     type: 'string',
-                    description: 'The analysis ID of a completed analysis'
+                    enum: ['USD', 'EUR', 'GBP', 'CAD', 'AUD'],
+                    description: 'Currency for deal value. Default: USD'
                 },
-                clauseType: {
-                    type: 'string',
-                    enum: ['indemnification', 'liability', 'ip', 'termination', 'payment', 'confidentiality', 'data_privacy', 'sla', 'force_majeure', 'assignment'],
-                    description: 'The type of clause to extract'
-                }
-            },
-            required: ['analysisId', 'clauseType']
-        },
-        annotations: {
-            readOnlyHint: true
-        }
-    },
-    compare_playbook: {
-        name: 'compare_playbook',
-        description: 'Compare an analyzed contract against a company playbook to identify deviations from pre-approved positions and required approvals.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                analysisId: {
+                additionalContext: {
                     type: 'string',
-                    description: 'The analysis ID of a completed analysis'
+                    description: 'HIGHLY RECOMMENDED: Deal context for better AI drafting. Include: party names, deal value, term length, key requirements, counterparty info, risk factors, special provisions needed. Example: "Deal value: $500K/year, 3-year term. We need strong IP protections. Counterparty is a startup, so we want robust termination rights. Key contact: John Smith, CEO..."'
                 },
+                // ════════════════════════════════════════════════════════════════════════════
+                // OPTIONAL - Playbook & Email Settings
+                // ════════════════════════════════════════════════════════════════════════════
                 playbookId: {
                     type: 'string',
-                    description: 'The ID of the playbook to compare against'
-                }
-            },
-            required: ['analysisId', 'playbookId']
-        },
-        annotations: {
-            readOnlyHint: true
-        }
-    },
-    // ════════════════════════════════════════════════════════════════════════════════════════════════════════════════
-    // INSTANT SWARM - Parallel N-Section Redlining (spawns N agents for N sections, max parallelization)
-    // ════════════════════════════════════════════════════════════════════════════════════════════════════════════════
-    instant_swarm: {
-        name: 'instant_swarm',
-        description: 'PARALLEL REDLINING of entire contract. Spawns N independent SAC agents for N sections simultaneously - maximum parallelization with no lock contention. Each agent (IP, Liability, Indemnification, Payment, Term, etc.) independently analyzes and redlines its section, then all branches merge into a single DOCX with real Track Changes. Returns merged document + per-section results. Requires a completed analysis (use process_contract first). This is the flagship feature - full attorney-quality redlines across the entire contract in parallel.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                analysisId: {
-                    type: 'string',
-                    description: 'The analysis ID from a completed process_contract call. The analysis provides contract context for each section.'
-                },
-                aggressivenessLevel: {
-                    type: 'number',
-                    enum: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10],
-                    description: 'How aggressive the redlines should be (1=conservative, 10=very aggressive). Recommended: 5-7 for balanced approach.'
+                    description: 'Playbook ID for firm-specific rules. Optional - uses BitsBound Foundational (117 rules) by default.'
                 },
-                partyPosition: {
-                    type: 'string',
-                    enum: ['customer', 'vendor'],
-                    description: 'Which side are you on? "customer" = you are buying/receiving services. "vendor" = you are selling/providing services.'
-                },
-                ourPartyName: {
-                    type: 'string',
-                    description: 'Your company name as it should appear in redlines (e.g., "Acme Corp").'
-                },
-                counterpartyName: {
-                    type: 'string',
-                    description: 'The other party\'s name (e.g., "Vendor Inc").'
+                enableEmailGenerator: {
+                    type: 'boolean',
+                    description: 'Generate cover email introducing the draft? Default: true'
                 },
-                targetSections: {
-                    type: 'array',
-                    items: { type: 'string' },
-                    description: 'Optional: specific BUBSA sections to analyze. If omitted, analyzes all 17 sections. Valid sections: parties, definitions, ip_license, payment, term_termination, confidentiality, data_privacy, reps_warranties, indemnification, liability, insurance, assignment, force_majeure, dispute_resolution, precedence, miscellaneous, sla'
+                emailContext: {
+                    type: 'object',
+                    description: 'Cover email context',
+                    properties: {
+                        recipientName: { type: 'string', description: 'Name of email recipient' },
+                        senderName: { type: 'string', description: 'Your name (the sender)' },
+                        additionalContext: { type: 'string', description: 'Tone, relationship notes, etc.' }
+                    }
                 }
             },
-            required: ['analysisId', 'aggressivenessLevel', 'partyPosition']
+            required: ['contractVertical', 'representingParty', 'aggressivenessLevel']
         },
         annotations: {
             readOnlyHint: false,
             destructiveHint: false
         }
     },
-    // ════════════════════════════════════════════════════════════════════════════════════════════════════════════════
-    // QUICK TOOLS - Immediate analysis without waiting for full pipeline
-    // ════════════════════════════════════════════════════════════════════════════════════════════════════════════════
-    quick_scan: {
-        name: 'quick_scan',
-        description: 'INSTANT contract analysis (5-10 seconds). Get immediate risk assessment, contract classification, top concerns, and key terms WITHOUT waiting for the full 15-30 minute analysis. Perfect for initial triage or quick questions. Use this FIRST before deciding if a full analysis is needed.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                contractText: {
-                    type: 'string',
-                    description: 'The contract text (plain text or base64-encoded DOCX). For DOCX files, base64 encode the file contents.'
-                },
-                fileName: {
-                    type: 'string',
-                    description: 'Optional filename for context (e.g., "Acme_MSA_2024.docx")'
-                },
-                perspective: {
-                    type: 'string',
-                    enum: ['customer', 'vendor', 'neutral'],
-                    description: 'Analyze from customer (buyer), vendor (seller), or neutral perspective. Default: customer'
-                }
-            },
-            required: ['contractText']
-        },
-        annotations: {
-            readOnlyHint: true
-        }
-    },
-    ask_clause: {
-        name: 'ask_clause',
-        description: 'INSTANT clause Q&A (2-5 seconds). Ask about specific clauses directly WITHOUT needing a prior analysis. Examples: "What does the indemnification clause say?", "Is there a limitation of liability?", "What are the termination terms?"',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                contractText: {
-                    type: 'string',
-                    description: 'The contract text (plain text or base64-encoded DOCX)'
-                },
-                question: {
-                    type: 'string',
-                    description: 'Your question about the contract (e.g., "What is the liability cap?", "Is there an auto-renewal clause?")'
-                },
-                clauseType: {
-                    type: 'string',
-                    enum: ['indemnification', 'liability', 'ip', 'termination', 'payment', 'confidentiality', 'data_privacy', 'sla', 'force_majeure', 'assignment', 'any'],
-                    description: 'Optional: Focus on a specific clause type, or "any" to search the whole contract. Default: any'
-                }
-            },
-            required: ['contractText', 'question']
-        },
-        annotations: {
-            readOnlyHint: true
-        }
-    },
-    check_dealbreakers: {
-        name: 'check_dealbreakers',
-        description: 'INSTANT dealbreaker check (3-5 seconds). Quick pass/fail screen against your playbook rules. Identifies blockers, missing required clauses, and who needs to approve. Use before spending time on full analysis.',
+    get_analysis_status: {
+        name: 'get_analysis_status',
+        description: `Check analysis progress. When complete, returns:
+- redlinedDocxDownloadUrl: Presigned URL to download redlined DOCX (valid 1 hour)
+- negotiationEmailHtml/PlainText: Ready-to-send negotiation email
+- favorabilityScore, topRisks, negotiationPriorities
+
+ALWAYS display download URLs as clickable links when analysis completes.`,
         inputSchema: {
             type: 'object',
             properties: {
-                contractText: {
-                    type: 'string',
-                    description: 'The contract text (plain text or base64-encoded DOCX)'
-                },
-                playbookId: {
+                analysisId: {
                     type: 'string',
-                    description: 'Optional: Specific playbook to check against. If not provided, uses your default company playbook.'
+                    description: 'Analysis ID from redline_swarm or power_draft'
                 }
             },
-            required: ['contractText']
+            required: ['analysisId']
         },
         annotations: {
             readOnlyHint: true
@@ -397,17 +219,17 @@ Pipeline: (1) Context Loading, (2) Data Extraction, (3) Party Identification, (4
     },
     download_file: {
         name: 'download_file',
-        description: 'Download a file from BitsBound (e.g., the redlined DOCX with Track Changes). Returns the file as base64-encoded content that can be saved locally. The downloadUrl is provided by get_analysis_status when analysis is complete.',
+        description: 'Download a file from BitsBound (redlined DOCX, analysis JSON). Returns base64 content or saves to local path.',
         inputSchema: {
             type: 'object',
             properties: {
                 downloadUrl: {
                     type: 'string',
-                    description: 'The download URL from get_analysis_status deliverables (redlinedDocxDownloadUrl)'
+                    description: 'Download URL from get_analysis_status deliverables'
                 },
                 saveToPath: {
                     type: 'string',
-                    description: 'Optional: Local file path to save the downloaded file. If not provided, returns base64 content.'
+                    description: 'Optional: Local path to save file. If omitted, returns base64.'
                 }
             },
             required: ['downloadUrl']
@@ -424,7 +246,7 @@ export const RESOURCE_DEFINITIONS = {
     analysis: {
         uriTemplate: 'bitsbound://analysis/{analysisId}',
         name: 'Contract Analysis',
-        description: 'Full analysis results including all 17 analyzer outputs, risk scores, and recommendations',
+        description: 'Full analysis results including all analyzer outputs (varies by contract type), risk scores, and recommendations',
         mimeType: 'application/json'
     },
     playbook: {
@@ -454,33 +276,26 @@ export const RESOURCE_DEFINITIONS = {
  * - O: User experiences a smooth, guided contract analysis flow
  */
 export const PROMPT_DEFINITIONS = {
-    process_contract: {
-        name: 'process_contract',
-        description: '📄 Process Contract - Upload a DOCX and get partner-level redlines with Track Changes, risk analysis, and a negotiation email',
-        arguments: []
-    },
-    quick_scan: {
-        name: 'quick_scan',
-        description: '⚡ Quick Risk Scan - Get instant risk assessment in 5-10 seconds without waiting for full analysis',
-        arguments: []
-    },
-    ask_about_contract: {
-        name: 'ask_about_contract',
-        description: '💬 Ask About a Clause - Upload a contract and ask specific questions about any clause or term',
+    // ════════════════════════════════════════════════════════════════════════════════════════════════════════════════
+    // CORE PROMPTS - 3-prompt interface matching 4-tool architecture
+    // ════════════════════════════════════════════════════════════════════════════════════════════════════════════════
+    redline_swarm: {
+        name: 'redline_swarm',
+        description: 'Redline Mode - Upload counterparty\'s DOCX and get partner-level redlines with real Track Changes, risk analysis, and negotiation email',
         arguments: []
     },
-    check_dealbreakers: {
-        name: 'check_dealbreakers',
-        description: '🚨 Check Dealbreakers - Quick pass/fail check against your playbook rules',
+    power_draft: {
+        name: 'power_draft',
+        description: 'Draft Mode - Generate a complete contract from scratch with multi-pass AI refinement (Opus 4.5 drafts → Analyzers critique → Opus 4.5 refines)',
         arguments: []
     },
-    continue_analysis: {
-        name: 'continue_analysis',
-        description: '📊 Continue Previous Analysis - Resume working with a previously analyzed contract',
+    check_analysis: {
+        name: 'check_analysis',
+        description: 'Check Analysis Status - Check progress or download results from a running/completed redline or draft',
         arguments: [
             {
                 name: 'analysisId',
-                description: 'The analysis ID from a previous contract analysis',
+                description: 'The analysis ID from redline_swarm or power_draft',
                 required: true
             }
         ]
@@ -492,94 +307,116 @@ export const PROMPT_DEFINITIONS = {
  * NOTE: MCP spec requires content to be { type: 'text', text: string } not plain string
  */
 export const PROMPT_MESSAGES = {
-    process_contract: [
-        {
-            role: 'user',
-            content: { type: 'text', text: `I want to analyze a contract using BitsBound.
-
-Please help me by:
-1. Ask me for the contract file. I will provide EITHER:
-   - A full file path (e.g., /Users/john/Documents/contract.docx)
-   - An uploaded DOCX file
-2. IMPORTANT FILE PATH HANDLING:
-   - If I provide a FILE PATH: Pass the path DIRECTLY to the 'process_contract' tool's 'filePath' parameter. Do NOT use copy_file_user_to_claude or any other file operations - the MCP server reads the file directly from the path.
-   - If I upload a file: Use the base64 content with 'docxBase64' parameter.
-3. CRITICAL: After starting the analysis, DO NOT POLL AUTOMATICALLY. The response will include 'checkBackTime' and 'importantNote' - tell me exactly when to come back and ask you to check the status. I will manually ask you to check when I'm ready.
-4. When I ask you to check status (using 'get_analysis_status'), show me:
-   - Current progress percentage
-   - If complete, ALWAYS provide these clickable links (they work directly in browser):
-     * REDLINED DOCX: Display the 'redlinedDocxUrl' as a clickable download link
-     * NEGOTIATION EMAIL: Display the 'negotiationEmailUrl' as a clickable link to view in browser
-   - Also show: favorability score, top 5 risks, negotiation priorities
-
-The analysis typically takes ~25 minutes. Wait for me to ask you to check - do not poll automatically.` }
-        }
-    ],
-    quick_scan: [
-        {
-            role: 'user',
-            content: { type: 'text', text: `I want a quick risk scan of a contract (5-10 seconds, not the full analysis).
-
-Please help me by:
-1. Asking me to upload or paste the contract
-2. Use the BitsBound 'quick_scan' tool for instant analysis
-3. Show me:
-   - Contract type and parties
-   - Favorability estimate
-   - Top concerns by severity
-   - Key terms (liability cap, term, payment, etc.)
-   - Whether I should do a full analysis
-
-This is for initial triage - not a substitute for full attorney review.` }
-        }
-    ],
-    ask_about_contract: [
+    // ════════════════════════════════════════════════════════════════════════════════════════════════════════════════
+    // CORE PROMPT MESSAGES - Matches 4-tool architecture (redline_swarm, power_draft, get_analysis_status, download_file)
+    // ════════════════════════════════════════════════════════════════════════════════════════════════════════════════
+    redline_swarm: [
         {
             role: 'user',
-            content: { type: 'text', text: `I want to ask questions about specific clauses in a contract.
+            content: { type: 'text', text: `I want to analyze and redline a counterparty's contract using BitsBound's REDLINE MODE.
+
+Please help me by gathering this information:
 
-Please help me by:
-1. Asking me to upload or paste the contract (or relevant sections)
-2. Ask what I want to know (e.g., "What is the liability cap?", "Is there an auto-renewal?")
-3. Use the BitsBound 'ask_clause' tool for instant answers
-4. Include the actual clause text and any risk assessment
+1. CONTRACT FILE:
+   - File path (e.g., /Users/john/Documents/contract.docx) - preferred
+   - Or upload the DOCX directly
 
-I can ask multiple questions - this is a Q&A session about the contract.` }
+2. CONTRACT TYPE:
+   - saas, ma, vc, employment, nda, equipment, commercial-lease, professional-services, or miscellaneous
+
+3. WHO I REPRESENT:
+   - saas: customer or vendor
+   - ma: buyer or seller
+   - vc: investor or founder
+   - employment: employer or employee
+   - nda: disclosing-party or receiving-party
+   - (etc. based on contract type)
+
+4. AGGRESSIVENESS (1-10):
+   - 1 = very conciliatory, 5 = balanced, 10 = very aggressive
+
+Then call the 'redline_swarm' tool. Instant Swarm™ deploys parallel AI agents to attack every section.
+Analysis takes ~25-35 minutes. Response includes 'checkBackTime' - tell me when to check back.
+Do NOT poll automatically - wait for me to ask.` }
         }
     ],
-    check_dealbreakers: [
+    power_draft: [
         {
             role: 'user',
-            content: { type: 'text', text: `I want to check a contract for dealbreakers against my company's playbook.
-
-Please help me by:
-1. Asking me to upload or paste the contract
-2. Use the BitsBound 'check_dealbreakers' tool
-3. Show me:
-   - Pass/fail result
-   - Any dealbreaker issues found
-   - Missing required clauses
-   - Who needs to approve if we proceed
-
-This is a quick pre-screen before spending time on full analysis.` }
+            content: { type: 'text', text: `I want to generate a NEW CONTRACT from scratch using BitsBound's DRAFT MODE.
+
+NO FILE UPLOAD NEEDED - just provide deal context.
+
+Please help me by gathering this information:
+
+**REQUIRED:**
+
+1. CONTRACT TYPE:
+   - saas (SaaS/Software Agreement)
+   - ma (M&A - APA, SPA, Merger)
+   - vc (VC - SAFE, Term Sheet, Series A/B/C)
+   - employment (Offer Letter, Employment Agreement)
+   - nda (Mutual or Unilateral NDA)
+   - equipment-lease (Equipment Lease)
+   - commercial-lease (Commercial Real Estate Lease)
+   - professional-services (SOW, Consulting Agreement)
+
+2. WHO YOU REPRESENT:
+   - saas: customer or vendor
+   - ma: buyer or seller
+   - vc: investor or founder
+   - employment: employer or employee
+   - nda: disclosing-party or receiving-party
+   - equipment-lease: lessee or lessor
+   - commercial-lease: tenant or landlord
+   - professional-services: client or service-provider
+
+3. TERMS FAVORABILITY (1-10):
+   - 1 = minimal protections (fast close)
+   - 5 = balanced (default)
+   - 10 = maximum protections (bulletproof)
+
+**HIGHLY RECOMMENDED - Additional Context:**
+The more context you provide, the better the AI can tailor the contract:
+- Party names (your company, counterparty)
+- Deal value (e.g., $500K/year)
+- Term length (e.g., 3-year term)
+- Key requirements (e.g., "strong IP protections", "robust termination rights")
+- Counterparty info (e.g., "startup", "Fortune 500")
+- Any special provisions needed
+
+**OPTIONAL:**
+- Annual Contract Value (for risk calibration)
+- Generate cover email? (default: yes)
+
+Then call the 'power_draft' tool. Multi-pass AI architecture:
+  1. Opus 4.5 generates initial draft
+  2. 16+ parallel analyzers critique the draft
+  3. Sonnet 4.5 synthesizes feedback
+  4. Opus 4.5 generates refined second draft
+  5. QB Enhancer finalizes for consistency
+
+Draft generation takes ~30-40 minutes. Response includes 'checkBackTime'.
+Do NOT poll automatically - wait for me to ask.` }
         }
     ],
-    continue_analysis: [
+    check_analysis: [
         {
             role: 'user',
-            content: { type: 'text', text: `I want to continue working with a previously analyzed contract.
-
-I have an analysis ID from a previous BitsBound analysis. Please:
-1. Ask me for the analysis ID
-2. Use 'get_analysis_status' to check if it's complete
-3. If complete, I can:
-   - Ask questions with 'ask_sac' (SAC has full context)
-   - Generate a redlined document with 'generate_redline'
-   - Generate a negotiation email with 'generate_negotiation_email'
-   - Extract specific clauses with 'extract_clause'
-   - Compare against a playbook with 'compare_playbook'
-
-What would you like to do with this analysis?` }
+            content: { type: 'text', text: `I want to check on a contract analysis or draft generation.
+
+Analysis ID: {analysisId}
+
+Please use 'get_analysis_status' and show me:
+- Current progress percentage
+- If complete, provide:
+  * CLICKABLE download link for the DOCX (redlined or clean draft)
+  * Negotiation/cover email content
+  * Favorability score
+  * Top risks
+  * Negotiation priorities
+
+If I need to download the file, use 'download_file' with the URL from the status response.` }
         }
     ]
 };
@@ -613,7 +450,7 @@ export const OPENAPI_SPEC = {
     },
     servers: [
         {
-            url: 'https://bitsbound-saas-backend-mxb1.onrender.com',
+            url: 'https://bitsbound-contract-backend.onrender.com',
             description: 'Production server'
         }
     ],
@@ -1162,7 +999,7 @@ Add to your Claude Desktop configuration (\`~/Library/Application Support/Claude
 
 1. Create a new Custom GPT at https://chat.openai.com/gpts/editor
 2. Go to "Configure" → "Create new action"
-3. Import OpenAPI schema from: \`https://bitsbound-saas-backend-mxb1.onrender.com/api/v1/mcp/openapi.json\`
+3. Import OpenAPI schema from: \`https://bitsbound-contract-backend.onrender.com/api/v1/mcp/openapi.json\`
 4. Set Authentication: API Key, Header name: \`x-api-key\`
 5. Enter your BitsBound API key
 
@@ -1171,7 +1008,7 @@ Add to your Claude Desktop configuration (\`~/Library/Application Support/Claude
 Use the REST API directly with your API key:
 
 \`\`\`bash
-curl -X POST https://bitsbound-saas-backend-mxb1.onrender.com/api/v1/mcp/analyze \\
+curl -X POST https://bitsbound-contract-backend.onrender.com/api/v1/mcp/analyze \\
   -H "Content-Type: application/json" \\
   -H "x-api-key: sk_live_your_api_key_here" \\
   -d '{
@@ -1261,18 +1098,19 @@ Compare an analyzed contract against a company playbook.
 ## Example Workflow
 
 \`\`\`
-User: "Analyze this Master Service Agreement and tell me the key risks"
+User: "Analyze this contract and tell me the key risks"
 
 Claude/ChatGPT:
-1. Calls process_contract with the uploaded DOCX (with Instant Swarm + Email enabled)
-2. Polls get_analysis_status to watch progress through 8 stages:
+1. Identifies the contract type (MSA, M&A, VC term sheet, employment, NDA, etc.)
+2. Calls process_contract with the uploaded DOCX (with Instant Swarm + Email enabled)
+3. Polls get_analysis_status to watch progress through 8 stages:
    - Loading Context → Extracting Data → Identifying Parties → Researching
    - AI Analysis → Instant Swarm™ → Generating Email → Synthesizing Results
-3. Reads results showing favorability score (e.g., 42% - Vendor Favorable)
-4. Identifies top risks: unlimited liability, broad IP assignment, weak SLA
-5. User can ask follow-up questions via ask_sac (SAC has full contract context)
-6. Downloads the redlined DOCX with real Track Changes (from Instant Swarm™)
-7. Reviews the auto-generated negotiation email (from Email Generator)
+4. Reads results showing favorability score (e.g., 42% - Vendor Favorable)
+5. Identifies top risks based on contract type and activated analyzers
+6. User can ask follow-up questions via ask_sac (SAC has full contract context)
+7. Downloads the redlined DOCX with real Track Changes (from Instant Swarm™)
+8. Reviews the auto-generated negotiation email (from Email Generator)
 \`\`\`
 
 ## Environment Variables