argulens-mcp-server 0.1.0

package/README.md

@@ -0,0 +1,77 @@
+# @argulens/mcp-server
+
+MCP server for [ArguLens](https://argulens.com) — analyze legal documents directly from Claude, ChatGPT, or any MCP-compatible AI assistant.
+
+## Setup
+
+### 1. Get an API key
+
+1. Sign up at [argulens.com](https://argulens.com)
+2. Go to [My Cases > API Keys](https://argulens.com/my-cases/api-keys)
+3. Create a new API key
+
+### 2. Install
+
+#### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "argulens": {
+      "command": "npx",
+      "args": ["@argulens/mcp-server"],
+      "env": {
+        "ARGULENS_API_KEY": "al_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+#### Claude Code
+
+```bash
+claude mcp add argulens -- npx @argulens/mcp-server
+```
+
+Then set the environment variable:
+```bash
+export ARGULENS_API_KEY=al_live_your_key_here
+```
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `analyze_case` | Upload documents and get a 7-section case pack (summary, timeline, evidence, risks, etc.) |
+| `chat_about_case` | Ask evidence-grounded follow-up questions about a case |
+| `parse_document` | Extract text from PDF, DOCX, images (OCR), or email files |
+| `draft_document` | Generate court-ready documents (affidavits, submissions, defence notices) |
+| `check_usage` | Check your current usage and remaining quota |
+
+## Usage Examples
+
+Once configured, you can ask your AI assistant:
+
+- "Analyze this divorce petition and tell me my strengths and weaknesses"
+- "What are the risks in my custody case based on these documents?"
+- "Draft an affidavit based on my case analysis"
+- "How much of my ArguLens quota have I used this month?"
+
+## Billing
+
+Usage through MCP counts against your ArguLens plan:
+
+- **Free**: 50 analyses/month, 100 chat messages/month
+- **Pro** ($11/month): 100 analyses/month, 200 chat messages/month
+
+When you hit your limit, the tool will return an error with a link to upgrade.
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `ARGULENS_API_KEY` | Yes | Your ArguLens API key (starts with `al_live_`) |
+| `ARGULENS_BASE_URL` | No | Custom API URL (defaults to `https://argulens.com`) |

package/dist/client.d.ts

@@ -0,0 +1,10 @@
+export declare class ArguLensClient {
+    private baseUrl;
+    private apiKey;
+    constructor();
+    request(path: string, options?: {
+        method?: string;
+        body?: unknown;
+    }): Promise<unknown>;
+}
+export declare const client: ArguLensClient;

package/dist/client.js

@@ -0,0 +1,39 @@
+const BASE_URL = process.env.ARGULENS_BASE_URL || "https://argulens.com";
+const API_KEY = process.env.ARGULENS_API_KEY;
+if (!API_KEY) {
+    console.error("ARGULENS_API_KEY environment variable is required");
+    process.exit(1);
+}
+export class ArguLensClient {
+    baseUrl;
+    apiKey;
+    constructor() {
+        this.baseUrl = BASE_URL;
+        this.apiKey = API_KEY;
+    }
+    async request(path, options = {}) {
+        const { method = "GET", body } = options;
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            method,
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+                "User-Agent": "argulens-mcp/0.1.0",
+            },
+            ...(body ? { body: JSON.stringify(body) } : {}),
+        });
+        if (!res.ok) {
+            const error = await res.json().catch(() => ({ error: res.statusText }));
+            const message = error.error || res.statusText;
+            if (res.status === 401) {
+                throw new Error(`Invalid or revoked API key. Generate a new key at ${this.baseUrl}/my-cases/api-keys`);
+            }
+            if (res.status === 429) {
+                throw new Error(`Rate limit or quota exceeded. Upgrade your plan at ${this.baseUrl}/pricing`);
+            }
+            throw new Error(`ArguLens API error (${res.status}): ${message}`);
+        }
+        return res.json();
+    }
+}
+export const client = new ArguLensClient();

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,168 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { client } from "./client.js";
+const server = new McpServer({
+    name: "argulens",
+    version: "0.1.0",
+});
+// Tool: analyze_case
+server.registerTool("analyze_case", {
+    title: "Analyze Legal Case",
+    description: "Upload legal documents and get a structured 7-section case pack: summary, timeline, evidence index, missing evidence, risks, opposing arguments, and response draft. Supports Singapore family law (Women's Charter, HDB, CPF) and worldwide disputes.",
+    inputSchema: {
+        documentTexts: z
+            .array(z.object({
+            name: z.string().describe("Document filename"),
+            content: z.string().describe("Extracted text content of the document"),
+        }))
+            .describe("Array of documents with name and text content"),
+        caseType: z
+            .enum([
+            "divorce",
+            "annulment",
+            "custody",
+            "support",
+            "property",
+            "landlord-tenant",
+            "contract",
+            "personal-injury",
+            "employment",
+            "immigration",
+            "other",
+        ])
+            .describe("Type of legal case"),
+        role: z
+            .enum(["plaintiff", "defendant", "petitioner", "respondent", "applicant"])
+            .describe("Your role in the case"),
+        jurisdiction: z
+            .string()
+            .default("Singapore")
+            .describe("Jurisdiction (e.g. Singapore, Malaysia, India)"),
+    },
+}, async ({ documentTexts, caseType, role, jurisdiction }) => {
+    const result = await client.request("/api/analyze", {
+        method: "POST",
+        body: { documentTexts, caseType, role, jurisdiction },
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+});
+// Tool: chat_about_case
+server.registerTool("chat_about_case", {
+    title: "Chat About a Legal Case",
+    description: "Ask evidence-grounded questions about a legal case. Every answer cites specific uploaded documents. Useful for follow-up questions after analyzing a case.",
+    inputSchema: {
+        message: z.string().describe("Your question about the case"),
+        caseId: z
+            .string()
+            .optional()
+            .describe("Case ID from a previous analysis (optional)"),
+    },
+}, async ({ message, caseId }) => {
+    const result = await client.request("/api/chat", {
+        method: "POST",
+        body: {
+            messages: [{ role: "user", content: message }],
+            ...(caseId ? { caseId } : {}),
+        },
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+});
+// Tool: parse_document
+server.registerTool("parse_document", {
+    title: "Parse Legal Document",
+    description: "Extract text from a legal document file. Supports PDF, DOCX, images (OCR), and email files. Returns the extracted text content.",
+    inputSchema: {
+        fileBase64: z
+            .string()
+            .describe("Base64-encoded file content"),
+        filename: z
+            .string()
+            .describe("Filename with extension (e.g. notice.pdf, contract.docx)"),
+    },
+}, async ({ fileBase64, filename }) => {
+    const result = await client.request("/api/parse", {
+        method: "POST",
+        body: { file: fileBase64, filename },
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+});
+// Tool: draft_document
+server.registerTool("draft_document", {
+    title: "Draft Legal Document",
+    description: "Generate a court-ready legal document from case analysis. Supported types: notice of contest, reply to defence, affidavit, written submissions, request for discovery.",
+    inputSchema: {
+        caseId: z.string().describe("Case ID from a previous analysis"),
+        documentType: z
+            .enum([
+            "notice-of-contest",
+            "reply-to-defence",
+            "affidavit-general",
+            "affidavit-assets-means",
+            "written-submissions",
+            "request-for-discovery",
+            "notice-act-in-person",
+        ])
+            .describe("Type of legal document to generate"),
+        instructions: z
+            .string()
+            .optional()
+            .describe("Additional instructions for the document"),
+    },
+}, async ({ caseId, documentType, instructions }) => {
+    const result = await client.request("/api/draft", {
+        method: "POST",
+        body: { caseId, documentType, instructions },
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+});
+// Tool: check_usage
+server.registerTool("check_usage", {
+    title: "Check Usage & Quota",
+    description: "Check your current ArguLens usage and remaining quota for analyses and chat messages.",
+}, async () => {
+    const result = await client.request("/api/usage");
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+});
+// Start the server
+const transport = new StdioServerTransport();
+server.connect(transport).catch((err) => {
+    console.error("Failed to start ArguLens MCP server:", err.message);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "argulens-mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for ArguLens — analyze legal documents from any AI assistant",
+  "bin": {
+    "argulens-mcp-server": "dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "legal",
+    "singapore",
+    "family-law",
+    "document-analysis",
+    "argulens"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/venkata-srinivasan/argulens"
+  }
+}

package/src/client.ts

@@ -0,0 +1,58 @@
+const BASE_URL = process.env.ARGULENS_BASE_URL || "https://argulens.com"
+const API_KEY = process.env.ARGULENS_API_KEY
+
+if (!API_KEY) {
+  console.error("ARGULENS_API_KEY environment variable is required")
+  process.exit(1)
+}
+
+export class ArguLensClient {
+  private baseUrl: string
+  private apiKey: string
+
+  constructor() {
+    this.baseUrl = BASE_URL
+    this.apiKey = API_KEY!
+  }
+
+  async request(
+    path: string,
+    options: {
+      method?: string
+      body?: unknown
+    } = {}
+  ): Promise<unknown> {
+    const { method = "GET", body } = options
+
+    const res = await fetch(`${this.baseUrl}${path}`, {
+      method,
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+        "Content-Type": "application/json",
+        "User-Agent": "argulens-mcp/0.1.0",
+      },
+      ...(body ? { body: JSON.stringify(body) } : {}),
+    })
+
+    if (!res.ok) {
+      const error = await res.json().catch(() => ({ error: res.statusText }))
+      const message = (error as { error?: string }).error || res.statusText
+
+      if (res.status === 401) {
+        throw new Error(
+          `Invalid or revoked API key. Generate a new key at ${this.baseUrl}/my-cases/api-keys`
+        )
+      }
+      if (res.status === 429) {
+        throw new Error(
+          `Rate limit or quota exceeded. Upgrade your plan at ${this.baseUrl}/pricing`
+        )
+      }
+      throw new Error(`ArguLens API error (${res.status}): ${message}`)
+    }
+
+    return res.json()
+  }
+}
+
+export const client = new ArguLensClient()

package/src/index.ts

@@ -0,0 +1,183 @@
+#!/usr/bin/env node
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js"
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
+import { z } from "zod"
+import { client } from "./client.js"
+
+const server = new McpServer({
+  name: "argulens",
+  version: "0.1.0",
+})
+
+// Tool: analyze_case
+server.registerTool("analyze_case", {
+  title: "Analyze Legal Case",
+  description:
+    "Upload legal documents and get a structured 7-section case pack: summary, timeline, evidence index, missing evidence, risks, opposing arguments, and response draft. Supports Singapore family law (Women's Charter, HDB, CPF) and worldwide disputes.",
+  inputSchema: {
+    documentTexts: z
+      .array(
+        z.object({
+          name: z.string().describe("Document filename"),
+          content: z.string().describe("Extracted text content of the document"),
+        })
+      )
+      .describe("Array of documents with name and text content"),
+    caseType: z
+      .enum([
+        "divorce",
+        "annulment",
+        "custody",
+        "support",
+        "property",
+        "landlord-tenant",
+        "contract",
+        "personal-injury",
+        "employment",
+        "immigration",
+        "other",
+      ])
+      .describe("Type of legal case"),
+    role: z
+      .enum(["plaintiff", "defendant", "petitioner", "respondent", "applicant"])
+      .describe("Your role in the case"),
+    jurisdiction: z
+      .string()
+      .default("Singapore")
+      .describe("Jurisdiction (e.g. Singapore, Malaysia, India)"),
+  },
+}, async ({ documentTexts, caseType, role, jurisdiction }) => {
+  const result = await client.request("/api/analyze", {
+    method: "POST",
+    body: { documentTexts, caseType, role, jurisdiction },
+  })
+  return {
+    content: [
+      {
+        type: "text" as const,
+        text: JSON.stringify(result, null, 2),
+      },
+    ],
+  }
+})
+
+// Tool: chat_about_case
+server.registerTool("chat_about_case", {
+  title: "Chat About a Legal Case",
+  description:
+    "Ask evidence-grounded questions about a legal case. Every answer cites specific uploaded documents. Useful for follow-up questions after analyzing a case.",
+  inputSchema: {
+    message: z.string().describe("Your question about the case"),
+    caseId: z
+      .string()
+      .optional()
+      .describe("Case ID from a previous analysis (optional)"),
+  },
+}, async ({ message, caseId }) => {
+  const result = await client.request("/api/chat", {
+    method: "POST",
+    body: {
+      messages: [{ role: "user", content: message }],
+      ...(caseId ? { caseId } : {}),
+    },
+  })
+  return {
+    content: [
+      {
+        type: "text" as const,
+        text: JSON.stringify(result, null, 2),
+      },
+    ],
+  }
+})
+
+// Tool: parse_document
+server.registerTool("parse_document", {
+  title: "Parse Legal Document",
+  description:
+    "Extract text from a legal document file. Supports PDF, DOCX, images (OCR), and email files. Returns the extracted text content.",
+  inputSchema: {
+    fileBase64: z
+      .string()
+      .describe("Base64-encoded file content"),
+    filename: z
+      .string()
+      .describe("Filename with extension (e.g. notice.pdf, contract.docx)"),
+  },
+}, async ({ fileBase64, filename }) => {
+  const result = await client.request("/api/parse", {
+    method: "POST",
+    body: { file: fileBase64, filename },
+  })
+  return {
+    content: [
+      {
+        type: "text" as const,
+        text: JSON.stringify(result, null, 2),
+      },
+    ],
+  }
+})
+
+// Tool: draft_document
+server.registerTool("draft_document", {
+  title: "Draft Legal Document",
+  description:
+    "Generate a court-ready legal document from case analysis. Supported types: notice of contest, reply to defence, affidavit, written submissions, request for discovery.",
+  inputSchema: {
+    caseId: z.string().describe("Case ID from a previous analysis"),
+    documentType: z
+      .enum([
+        "notice-of-contest",
+        "reply-to-defence",
+        "affidavit-general",
+        "affidavit-assets-means",
+        "written-submissions",
+        "request-for-discovery",
+        "notice-act-in-person",
+      ])
+      .describe("Type of legal document to generate"),
+    instructions: z
+      .string()
+      .optional()
+      .describe("Additional instructions for the document"),
+  },
+}, async ({ caseId, documentType, instructions }) => {
+  const result = await client.request("/api/draft", {
+    method: "POST",
+    body: { caseId, documentType, instructions },
+  })
+  return {
+    content: [
+      {
+        type: "text" as const,
+        text: JSON.stringify(result, null, 2),
+      },
+    ],
+  }
+})
+
+// Tool: check_usage
+server.registerTool("check_usage", {
+  title: "Check Usage & Quota",
+  description:
+    "Check your current ArguLens usage and remaining quota for analyses and chat messages.",
+}, async () => {
+  const result = await client.request("/api/usage")
+  return {
+    content: [
+      {
+        type: "text" as const,
+        text: JSON.stringify(result, null, 2),
+      },
+    ],
+  }
+})
+
+// Start the server
+const transport = new StdioServerTransport()
+server.connect(transport).catch((err: Error) => {
+  console.error("Failed to start ArguLens MCP server:", err.message)
+  process.exit(1)
+})

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true
+  },
+  "include": ["src"]
+}