@bitsbound/mcp-server 1.0.13 → 1.1.1

package/types/Bitsbound_Kings_McpServer_Backend_Types.ts

@@ -48,12 +48,48 @@ export interface McpServerConfig {
   readonly BITSBOUND_API_KEY: string;
 }
 
-export const DEFAULT_API_URL = 'https://bitsbound-saas-backend-mxb1.onrender.com';
+export const DEFAULT_API_URL = 'https://bitsbound-contract-backend.onrender.com';
 
 // ══════════════════════════════════════════════════════════════════════════════════════════════════════════════════
 // Tool Input Schemas 'R_DVT_G_D_ToolInputs' - What AI platforms send to each tool
 // ══════════════════════════════════════════════════════════════════════════════════════════════════════════════════
 
+// ══════════════════════════════════════════════════════════════════════════════════════════════════════════════════
+// Contract Vertical Types 'R_DVT_G_D_ContractVerticals'
+// ══════════════════════════════════════════════════════════════════════════════════════════════════════════════════
+
+/**
+ * ContractVertical - The type of contract being analyzed
+ * D: Each vertical has its own analyzer set and representing party options
+ *
+ * Verticals and their Representing Party options:
+ * - saas: Customer (Buyer) | Vendor (Seller)
+ * - ma: Buyer | Seller
+ * - vc: Investor | Founder/Company
+ * - employment: Employer | Employee
+ * - nda: Disclosing Party | Receiving Party
+ * - equipment-lease: Lessee | Lessor
+ * - equipment-financing: Debtor | Secured Party
+ * - security-agreement: Debtor | Secured Party
+ * - loan: Borrower | Lender
+ * - commercial-lease: Tenant | Landlord
+ * - professional-services: Client | Service Provider
+ * - miscellaneous: Party A | Party B (let AI decide best classification)
+ */
+export type ContractVertical =
+  | 'saas'                    // MSA, SaaS Agreement, Subscription Agreement
+  | 'ma'                      // APA, SPA, Merger Agreement
+  | 'vc'                      // SAFE, Convertible Note, Series A/B/C
+  | 'employment'              // Offer Letter, Employment Agreement
+  | 'nda'                     // Mutual NDA, Unilateral NDA
+  | 'equipment-lease'         // Equipment Lease (lessee/lessor)
+  | 'equipment-financing'     // Equipment Financing (debtor/secured-party)
+  | 'security-agreement'      // Security Agreement (debtor/secured-party)
+  | 'loan'                    // Loan Agreement (borrower/lender)
+  | 'commercial-lease'        // Commercial Lease, Office Lease
+  | 'professional-services'   // SOW, Consulting Agreement
+  | 'miscellaneous';          // Unknown/other (AI classifies)
+
 export interface AnalyzeContractInput {
   readonly filePath?: string;           // RECOMMENDED: Absolute path to DOCX file on disk
   readonly docxBase64?: string;         // Alternative: Base64-encoded DOCX content
@@ -61,10 +97,15 @@ export interface AnalyzeContractInput {
   readonly analysisDepth?: 'quick' | 'standard' | 'deep';
   readonly perspective?: 'customer' | 'vendor' | 'neutral';  // DEPRECATED: Use representingParty
 
+  // ════════════════════════════════════════════════════════════════════════════
+  // CONTRACT TYPE (determines analyzer set and representing party options)
+  // ════════════════════════════════════════════════════════════════════════════
+  readonly contractVertical?: ContractVertical;  // What type of contract? (REQUIRED)
+
   // ════════════════════════════════════════════════════════════════════════════
   // DEAL CONTEXT (matches Customer Account dashboard Start Analysis form)
   // ════════════════════════════════════════════════════════════════════════════
-  readonly representingParty?: 'customer' | 'vendor' | 'neutral';  // Who is the AI representing? (REQUIRED)
+  readonly representingParty?: string;  // Who is the AI representing? (contextual per vertical)
   readonly dealValue?: number;           // Estimated deal value / ACV in specified currency
   readonly dealValueCurrency?: 'USD' | 'EUR' | 'GBP' | 'CAD' | 'AUD';  // Currency (default: USD)
   readonly industry?: string;            // Industry: technology, healthcare, financial, retail, manufacturing, professional, media, education, government, other
@@ -382,7 +423,7 @@ export interface CheckDealbreakersOutput {
 }
 
 // ══════════════════════════════════════════════════════════════════════════════════════════════════════════════════
-// BitsBound SaaS API Types 'R_DVT_G_D_ApiTypes' - For calling the backend
+// BitsBound API Types 'R_DVT_G_D_ApiTypes' - For calling the backend
 // ══════════════════════════════════════════════════════════════════════════════════════════════════════════════════
 
 export interface BitsBoundApiResponse<T> {
@@ -433,129 +474,83 @@ export interface SectionAnalysis {
 // ══════════════════════════════════════════════════════════════════════════════════════════════════════════════════
 
 export const TOOL_DEFINITIONS = {
+  // ════════════════════════════════════════════════════════════════════════════════════════════════════════════════
+  // CORE TOOLS - Simplified 3-tool interface for Claude Code Plugin Marketplace
+  // ════════════════════════════════════════════════════════════════════════════════════════════════════════════════
+
   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:
-
-**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)"
+    description: `Process a contract through BitsBound's full analysis pipeline. Returns partner-level redlined DOCX with Track Changes, 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 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).
-
-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: []
@@ -568,270 +563,22 @@ Pipeline: (1) Context Loading, (2) Data Extraction, (3) Party Identification, (4
 
   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.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        analysisId: {
-          type: 'string',
-          description: 'The processing ID returned from process_contract'
-        }
-      },
-      required: ['analysisId']
-    },
-    annotations: {
-      readOnlyHint: true
-    }
-  },
+    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
 
-  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.',
+ALWAYS display download URLs as clickable links when analysis completes.`,
     inputSchema: {
       type: 'object',
       properties: {
         analysisId: {
           type: 'string',
-          description: 'The analysis ID of a completed analysis'
-        },
-        question: {
-          type: 'string',
-          description: 'Your question about the contract'
-        },
-        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: {
-          type: 'string',
-          description: 'The analysis ID of a completed analysis'
-        },
-        aggressiveness: {
-          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'
-        },
-        tone: {
-          type: 'string',
-          enum: ['collaborative', 'firm', 'aggressive'],
-          description: 'Tone of the email. Default: collaborative'
-        },
-        recipientRole: {
-          type: 'string',
-          description: 'Role of the recipient (e.g., "General Counsel", "Sales Rep", "Procurement"). Helps tailor the message.'
+          description: 'Analysis ID from process_contract'
         }
       },
       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: {
-          type: 'string',
-          description: 'The analysis ID of a completed analysis'
-        },
-        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: {
-          type: 'string',
-          description: 'The analysis ID of a completed analysis'
-        },
-        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.'
-        },
-        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").'
-        },
-        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'
-        }
-      },
-      required: ['analysisId', 'aggressivenessLevel', 'partyPosition']
-    },
-    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.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        contractText: {
-          type: 'string',
-          description: 'The contract text (plain text or base64-encoded DOCX)'
-        },
-        playbookId: {
-          type: 'string',
-          description: 'Optional: Specific playbook to check against. If not provided, uses your default company playbook.'
-        }
-      },
-      required: ['contractText']
-    },
     annotations: {
       readOnlyHint: true
     }
@@ -839,17 +586,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']
@@ -870,7 +617,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: {
@@ -902,33 +649,22 @@ export const RESOURCE_DEFINITIONS = {
  * - O: User experiences a smooth, guided contract analysis flow
  */
 export const PROMPT_DEFINITIONS = {
+  // ════════════════════════════════════════════════════════════════════════════════════════════════════════════════
+  // CORE PROMPTS - Simplified 2-prompt interface matching 3-tool architecture
+  // ════════════════════════════════════════════════════════════════════════════════════════════════════════════════
+
   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',
-    arguments: []
-  },
-  check_dealbreakers: {
-    name: 'check_dealbreakers',
-    description: '🚨 Check Dealbreakers - Quick pass/fail check against your playbook rules',
+    description: 'Analyze Contract - Upload a DOCX and get partner-level redlines with Track Changes, risk analysis, and a negotiation email',
     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 analysis',
     arguments: [
       {
         name: 'analysisId',
-        description: 'The analysis ID from a previous contract analysis',
+        description: 'The analysis ID from process_contract',
         required: true
       }
     ]
@@ -943,94 +679,55 @@ export type PromptName = keyof typeof PROMPT_DEFINITIONS;
  * NOTE: MCP spec requires content to be { type: 'text', text: string } not plain string
  */
 export const PROMPT_MESSAGES: Record<PromptName, { role: 'user'; content: { type: 'text'; text: string } }[]> = {
+  // ════════════════════════════════════════════════════════════════════════════════════════════════════════════════
+  // CORE PROMPT MESSAGES - Simplified to match 3-tool architecture
+  // ════════════════════════════════════════════════════════════════════════════════════════════════════════════════
+
   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: [
-    {
-      role: 'user',
-      content: { type: 'text', text: `I want to ask questions about specific clauses in a contract.
+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 TYPE:
+   - saas, ma, vc, employment, nda, equipment, commercial-lease, professional-services, or miscellaneous
 
-I can ask multiple questions - this is a Q&A session about the contract.` }
-    }
-  ],
-  check_dealbreakers: [
-    {
-      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.` }
+2. CONTRACT FILE:
+   - File path (e.g., /Users/john/Documents/contract.docx) - preferred
+   - Or upload the DOCX directly
+
+3. WHO I REPRESENT:
+   - saas: customer or vendor
+   - ma: buyer or seller
+   - vc: investor or founder
+   - (etc. based on contract type)
+
+4. AGGRESSIVENESS (1-10):
+   - 1 = very conciliatory, 5 = balanced, 10 = very aggressive
+
+Then call the 'process_contract' tool. Analysis takes ~25-35 minutes.
+The response includes 'checkBackTime' - tell me when to check back.
+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.
+
+Analysis ID: {analysisId}
+
+Please use 'get_analysis_status' and show me:
+- Current progress percentage
+- If complete, provide:
+  * CLICKABLE download link for the redlined DOCX
+  * Negotiation 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.` }
     }
   ]
 };
@@ -1066,7 +763,7 @@ export const OPENAPI_SPEC = {
   },
   servers: [
     {
-      url: 'https://bitsbound-saas-backend-mxb1.onrender.com',
+      url: 'https://bitsbound-contract-backend.onrender.com',
       description: 'Production server'
     }
   ],
@@ -1618,7 +1315,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
 
@@ -1627,7 +1324,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 '{
@@ -1717,18 +1414,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