aidocx-mcp-server 0.3.0 → 0.4.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,8 +1,10 @@
 # aidocx-mcp-server
 
-MCP (Model Context Protocol) server for [AiDocX](https://aidocx.ai) — AI-powered contract & document management platform.
+MCP (Model Context Protocol) server for [AiDocX](https://aidocx.ai) — AI-powered document management platform.
 
-Create, upload, and manage contracts directly from AI assistants like Claude Desktop, Claude Code, and other MCP-compatible clients.
+Create, upload, and manage business documents directly from AI assistants like Claude Desktop, Claude Code, and other MCP-compatible clients.
+
+**Supported document types:** Contracts, Proposals, Quotations, Resumes, Business Plans, Reports, Official Letters, Purchase Orders, Manuals/SOPs, and more.
 
 ## Quick Start
 
@@ -44,32 +46,48 @@ claude mcp add aidocx \
 
 Ask your AI assistant:
 
-- "계약서 양식 만들어서 AiDocX에 올려줘" (Create a contract and upload to AiDocX)
-- "NDA 계약서 작성해줘" (Draft an NDA)
+- "NDA 계약서 작성해줘" (Draft an NDA contract)
+- "견적서 만들어줘" (Create a quotation)
+- "이력서 작성해줘" (Create a resume)
+- "제안서 만들어줘" (Create a proposal)
 - "내 문서 목록 보여줘" (Show my documents)
-- "이 계약서 AI로 분석해줘" (Analyze this contract with AI)
-- "계약서 검색해줘" (Search my contracts)
+- "이 문서 AI로 분석해줘" (Analyze this document with AI)
 
 ## Available Tools
 
 | Tool | Description |
 |------|-------------|
-| `create_contract` | Create a new contract — auto-generates a professionally formatted PDF |
-| `upload_contract` | Upload a PDF or Office file (DOC, DOCX, HWP, XLS, XLSX, PPT, PPTX) |
-| `list_contracts` | List contracts with optional pagination |
-| `get_contract` | Get contract details and extracted text |
-| `delete_contract` | Delete a contract |
+| `create_document` | Create a new document (contract, proposal, quotation, resume, report, etc.) — auto-generates PDF |
+| `upload_document` | Upload a PDF or Office file (DOC, DOCX, HWP, XLS, XLSX, PPT, PPTX) |
+| `list_documents` | List documents with optional pagination |
+| `get_document` | Get document details and extracted text |
+| `delete_document` | Delete a document |
 | `list_folders` | List folders |
 | `create_folder` | Create a new folder |
 | `delete_folder` | Delete a folder (optionally with all contents) |
-| `search_contracts` | Search contracts with text query, date filters, and pagination |
-| `analyze_contract` | AI-powered contract analysis with risk score and insights |
+| `search_documents` | Search documents with text query, date filters, and pagination |
+| `analyze_document` | AI-powered document analysis with risk score and insights |
+
+## Document Types
+
+| Type | Examples |
+|------|----------|
+| `contract` | Service agreements, NDAs, employment contracts |
+| `proposal` | Project proposals, consulting proposals |
+| `quotation` | Price quotes, cost estimates |
+| `plan` | Project plans, strategy documents |
+| `business-plan` | Investor pitch business plans |
+| `report` | Analysis reports, audit reports |
+| `official-letter` | Official letters, notices, requests |
+| `resume` | Resumes, CVs, cover letters |
+| `purchase-order` | Purchase orders, delivery notes |
+| `manual` | SOPs, user manuals, guides |
 
 ## Workflow
 
-1. **AI generates a contract** → calls `create_contract` → PDF is created in AiDocX
-2. **Open the signing workspace URL** returned by the tool
-3. **Place signature fields** and send to signers in the AiDocX web app
+1. **AI generates a document** → calls `create_document` → PDF is created in AiDocX
+2. **Open the URL** returned by the tool to view, download, or share
+3. **For contracts:** open the signing workspace URL to place signature fields and send to signers
 
 ## Environment Variables
 

package/build/index.js

@@ -4,16 +4,16 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { loadConfig } from "./config.js";
 import { AiDocxClient } from "./api-client.js";
-import { register as registerCreateContract } from "./tools/create-contract.js";
-import { register as registerUploadContract } from "./tools/upload-contract.js";
-import { register as registerListContracts } from "./tools/list-contracts.js";
-import { register as registerGetContract } from "./tools/get-contract.js";
+import { register as registerCreateDocument } from "./tools/create-document.js";
+import { register as registerUploadDocument } from "./tools/upload-document.js";
+import { register as registerListDocuments } from "./tools/list-documents.js";
+import { register as registerGetDocument } from "./tools/get-document.js";
 import { register as registerListFolders } from "./tools/list-folders.js";
 import { register as registerCreateFolder } from "./tools/create-folder.js";
-import { register as registerDeleteContract } from "./tools/delete-contract.js";
+import { register as registerDeleteDocument } from "./tools/delete-document.js";
 import { register as registerDeleteFolder } from "./tools/delete-folder.js";
-import { register as registerSearchContracts } from "./tools/search-contracts.js";
-import { register as registerAnalyzeContract } from "./tools/analyze-contract.js";
+import { register as registerSearchDocuments } from "./tools/search-documents.js";
+import { register as registerAnalyzeDocument } from "./tools/analyze-document.js";
 const require = createRequire(import.meta.url);
 const { version } = require("../package.json");
 async function main() {
@@ -23,16 +23,16 @@ async function main() {
         name: "aidocx",
         version,
     });
-    registerCreateContract(server, client);
-    registerUploadContract(server, client);
-    registerListContracts(server, client);
-    registerGetContract(server, client);
+    registerCreateDocument(server, client);
+    registerUploadDocument(server, client);
+    registerListDocuments(server, client);
+    registerGetDocument(server, client);
     registerListFolders(server, client);
     registerCreateFolder(server, client);
-    registerDeleteContract(server, client);
+    registerDeleteDocument(server, client);
     registerDeleteFolder(server, client);
-    registerSearchContracts(server, client);
-    registerAnalyzeContract(server, client);
+    registerSearchDocuments(server, client);
+    registerAnalyzeDocument(server, client);
     const transport = new StdioServerTransport();
     await server.connect(transport);
     console.error("[AiDocX MCP] Server running on stdio");

package/build/tools/analyze-document.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AiDocxClient } from "../api-client.js";
+export declare function register(server: McpServer, client: AiDocxClient): void;

package/build/tools/analyze-document.js

@@ -0,0 +1,36 @@
+import { z } from "zod";
+const inputSchema = {
+    id: z.string().describe("Document ID to analyze"),
+};
+export function register(server, client) {
+    server.registerTool("analyze_document", {
+        description: "Analyze a document using AI. For contracts, returns a risk score (0-100), key clauses, " +
+            "and missing protections. For other document types, returns a summary and improvement suggestions.\n\n" +
+            "NOTE: This operation consumes AI tokens from the user's subscription plan. " +
+            "The analysis may take 10-30 seconds depending on document length.",
+        inputSchema,
+    }, async ({ id }) => {
+        try {
+            const result = await client.post("/ai/analyze", { id });
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            documentId: id,
+                            summary: result.summary,
+                            riskScore: result.riskScore,
+                            insights: result.insights,
+                            tokensUsed: result.tokensUsed,
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/build/tools/create-document.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AiDocxClient } from "../api-client.js";
+export declare function register(server: McpServer, client: AiDocxClient): void;

package/build/tools/create-document.js

@@ -0,0 +1,77 @@
+import { z } from "zod";
+const DOCUMENT_TYPES = [
+    "contract", "proposal", "quotation", "plan", "business-plan",
+    "business-trip-plan", "business-trip-report", "report",
+    "official-letter", "resume", "purchase-order", "manual",
+];
+export function register(server, client) {
+    server.registerTool("create_document", {
+        description: "Create a new document in AiDocX. The content is rendered to a professionally formatted PDF " +
+            "(A4, proper margins) and stored in document management.\n\n" +
+            "Supported document types:\n" +
+            "- contract: Contracts, NDAs, employment agreements, service agreements\n" +
+            "- proposal: Project proposals, consulting proposals\n" +
+            "- quotation: Price quotes, cost estimates, invoices\n" +
+            "- plan: Project plans, strategy documents\n" +
+            "- business-plan: Investor pitch business plans, startup plans\n" +
+            "- business-trip-plan: Travel plans with itinerary and budget\n" +
+            "- business-trip-report: Post-trip reports with outcomes and expenses\n" +
+            "- report: Analysis reports, audit reports, due diligence\n" +
+            "- official-letter: Official letters, notices, requests\n" +
+            "- resume: Resumes, CVs, cover letters\n" +
+            "- purchase-order: Purchase orders, delivery notes, invoices\n" +
+            "- manual: SOPs, user manuals, guides\n\n" +
+            "IMPORTANT: Before calling this tool, you MUST confirm the following with the user:\n" +
+            "1. Document type (e.g., contract, quotation, resume, proposal)\n" +
+            "2. Key details (parties, terms, items, or sections depending on type)\n" +
+            "3. Any special requirements or clauses\n\n" +
+            "Generate professional, well-structured HTML appropriate for the document type. " +
+            "Do NOT include <html>/<head>/<body> wrapper — only the inner content.\n" +
+            "- Contracts: include signature blocks at the bottom\n" +
+            "- Quotations: include item tables with totals\n" +
+            "- Resumes: include profile, experience, education sections\n" +
+            "- Proposals: include executive summary, scope, timeline, pricing",
+        inputSchema: {
+            name: z.string().describe("Document title"),
+            html: z.string().describe("Document body content as HTML"),
+            documentType: z.enum(DOCUMENT_TYPES).optional().describe("Document type. Determines formatting and structure. Default: 'contract'"),
+            folderId: z.string().optional().describe("Target folder ID"),
+        },
+    }, async ({ name, html, documentType, folderId }) => {
+        try {
+            const result = await client.post("/contracts/create-from-html", {
+                name, html, folderId,
+                ...(documentType ? { label: documentType } : {}),
+            });
+            const viewUrl = `${client.appUrl}/contracts/${result.id}`;
+            const signingUrl = `${client.appUrl}/contracts/${result.id}/signing`;
+            const isContract = !documentType || documentType === "contract";
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            documentId: result.id,
+                            name: result.name,
+                            documentType: documentType || "contract",
+                            fileSize: result.fileSize,
+                            message: `Document "${result.name}" created successfully.`,
+                            viewUrl,
+                            ...(isContract ? {
+                                signingWorkspaceUrl: signingUrl,
+                                nextStep: "Open the signing workspace URL to place signature fields and send to signers.",
+                            } : {
+                                nextStep: "Open the view URL to preview, download, or share the document.",
+                            }),
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/build/tools/delete-document.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AiDocxClient } from "../api-client.js";
+export declare function register(server: McpServer, client: AiDocxClient): void;

package/build/tools/delete-document.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+const inputSchema = {
+    id: z.string().describe("Document ID to delete"),
+};
+export function register(server, client) {
+    server.registerTool("delete_document", {
+        description: "Delete a document from AiDocX document management. This action is irreversible.\n\n" +
+            "IMPORTANT: Always confirm with the user before deleting a document.",
+        inputSchema,
+    }, async ({ id }) => {
+        try {
+            await client.delete(`/contracts/${id}`);
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            message: `Document ${id} has been deleted.`,
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/build/tools/delete-folder.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 const inputSchema = {
     id: z.string().describe("Folder ID to delete"),
-    recursive: z.boolean().optional().describe("If true, delete the folder and all its contents (subfolders and contracts). " +
+    recursive: z.boolean().optional().describe("If true, delete the folder and all its contents (subfolders and documents). " +
         "If false or omitted, the folder must be empty to delete."),
 };
 export function register(server, client) {
@@ -10,9 +10,7 @@ export function register(server, client) {
             "IMPORTANT: Always confirm with the user before deleting. " +
             "Use recursive=true only when the user explicitly wants to delete all contents.",
         inputSchema,
-    }, 
-    // @ts-expect-error -- MCP SDK generic recursion with zod v3.25+ optional()
-    async ({ id, recursive }) => {
+    }, async ({ id, recursive }) => {
         try {
             const params = {};
             if (recursive)

package/build/tools/get-document.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AiDocxClient } from "../api-client.js";
+export declare function register(server: McpServer, client: AiDocxClient): void;

package/build/tools/get-document.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+const inputSchema = {
+    id: z.string().describe("Document ID"),
+};
+export function register(server, client) {
+    server.registerTool("get_document", {
+        description: "Get details of a specific document in AiDocX. " +
+            "Returns name, type, labels, size, and extracted text content.",
+        inputSchema,
+    }, async ({ id }) => {
+        try {
+            const result = await client.get(`/contracts/${id}`);
+            const doc = result.contract || result;
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            id: doc.id, name: doc.name,
+                            fileName: doc.fileName, fileType: doc.fileType,
+                            fileSize: doc.fileSize, contentType: doc.contentType,
+                            folderId: doc.folderId, labels: doc.labels,
+                            textExtract: doc.textExtract,
+                            createdAt: doc.createdAt, updatedAt: doc.updatedAt,
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/build/tools/list-documents.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AiDocxClient } from "../api-client.js";
+export declare function register(server: McpServer, client: AiDocxClient): void;

package/build/tools/list-documents.js

@@ -0,0 +1,52 @@
+import { z } from "zod";
+const inputSchema = {
+    folderId: z.string().optional().describe("Folder ID to list. Omit for root folder."),
+    limit: z.number().optional().describe("Maximum number of documents to return. Default: 50"),
+    offset: z.number().optional().describe("Number of documents to skip. Default: 0"),
+};
+export function register(server, client) {
+    server.registerTool("list_documents", {
+        description: "List documents in the user's AiDocX document management. " +
+            "Returns all document types (contracts, proposals, quotations, resumes, reports, etc.). " +
+            "Supports pagination.",
+        inputSchema,
+    }, async ({ folderId, limit, offset }) => {
+        try {
+            const params = {};
+            if (folderId)
+                params.folderId = folderId;
+            const result = await client.get("/contracts", params);
+            const documents = result.contracts || result;
+            const all = Array.isArray(documents)
+                ? documents.map((d) => ({
+                    id: d.id, name: d.name, labels: d.labels,
+                    fileType: d.fileType, fileSize: d.fileSize,
+                    contentType: d.contentType,
+                    createdAt: d.createdAt, updatedAt: d.updatedAt,
+                }))
+                : documents;
+            const effectiveLimit = limit ?? 50;
+            const effectiveOffset = offset ?? 0;
+            const paginated = Array.isArray(all)
+                ? all.slice(effectiveOffset, effectiveOffset + effectiveLimit)
+                : all;
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            total: Array.isArray(all) ? all.length : 0,
+                            count: Array.isArray(paginated) ? paginated.length : 0,
+                            documents: paginated,
+                            pagination: { limit: effectiveLimit, offset: effectiveOffset },
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/build/tools/search-documents.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AiDocxClient } from "../api-client.js";
+export declare function register(server: McpServer, client: AiDocxClient): void;

package/build/tools/search-documents.js

@@ -0,0 +1,69 @@
+import { z } from "zod";
+const inputSchema = {
+    query: z.string().optional().describe("Search query text. Searches document names and content."),
+    sortBy: z.enum(["relevance", "date", "name"]).optional().describe("Sort results by relevance, date, or name. Default: relevance"),
+    sortOrder: z.enum(["asc", "desc"]).optional().describe("Sort order. Default: desc"),
+    dateFrom: z.string().optional().describe("Filter results from this date (ISO 8601, e.g., '2024-01-01')"),
+    dateTo: z.string().optional().describe("Filter results up to this date (ISO 8601)"),
+    limit: z.number().optional().describe("Maximum results to return (1-100). Default: 20"),
+    offset: z.number().optional().describe("Number of results to skip for pagination. Default: 0"),
+};
+export function register(server, client) {
+    server.registerTool("search_documents", {
+        description: "Search documents in AiDocX. Searches across all document types " +
+            "(contracts, proposals, quotations, resumes, reports, etc.). " +
+            "Supports text search, date filtering, and pagination. " +
+            "Returns matching documents sorted by relevance by default.",
+        inputSchema,
+    }, async ({ query, sortBy, sortOrder, dateFrom, dateTo, limit, offset }) => {
+        try {
+            const params = {};
+            if (query)
+                params.q = query;
+            if (sortBy)
+                params.sortBy = sortBy;
+            if (sortOrder)
+                params.sortOrder = sortOrder;
+            if (dateFrom)
+                params.dateFrom = dateFrom;
+            if (dateTo)
+                params.dateTo = dateTo;
+            if (limit !== undefined)
+                params.limit = String(limit);
+            if (offset !== undefined)
+                params.offset = String(offset);
+            const result = await client.get("/search", params);
+            const items = result.results || result;
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            total: result.total ?? (Array.isArray(items) ? items.length : 0),
+                            results: Array.isArray(items)
+                                ? items.map((item) => ({
+                                    id: item.id,
+                                    name: item.name,
+                                    type: item.type,
+                                    labels: item.labels,
+                                    fileType: item.fileType,
+                                    fileSize: item.fileSize,
+                                    createdAt: item.createdAt,
+                                    updatedAt: item.updatedAt,
+                                }))
+                                : items,
+                            pagination: {
+                                limit: limit ?? 20,
+                                offset: offset ?? 0,
+                            },
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/build/tools/upload-document.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AiDocxClient } from "../api-client.js";
+export declare function register(server: McpServer, client: AiDocxClient): void;

package/build/tools/upload-document.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+const inputSchema = {
+    fileName: z.string().describe("File name with extension (e.g., 'proposal.pdf', 'resume.docx')"),
+    fileBase64: z.string().describe("Base64-encoded file content (max 50MB)"),
+    fileType: z.string().describe("MIME type (e.g., 'application/pdf')"),
+    folderId: z.string().optional().describe("Target folder ID. Omit for root."),
+};
+export function register(server, client) {
+    server.registerTool("upload_document", {
+        description: "Upload a PDF or Office document (DOC, DOCX, HWP, XLS, XLSX, PPT, PPTX) to AiDocX. " +
+            "Office files are auto-converted to PDF. " +
+            "Works for any document type: contracts, proposals, quotations, resumes, reports, etc.",
+        inputSchema,
+    }, async ({ fileName, fileBase64, fileType, folderId }) => {
+        try {
+            const result = await client.post("/contracts/upload", {
+                file: fileBase64, fileName, fileType, folderId,
+            });
+            const viewUrl = `${client.appUrl}/contracts/${result.id}`;
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            documentId: result.id,
+                            name: result.name,
+                            fileSize: result.fileSize,
+                            message: `File "${result.name}" uploaded successfully.`,
+                            viewUrl,
+                            nextStep: "Open the view URL to preview, share, or set up e-signatures.",
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "aidocx-mcp-server",
-  "version": "0.3.0",
-  "description": "MCP server for AiDocX - Create, upload, and manage contracts from Claude Desktop and other AI assistants",
+  "mcpName": "io.github.aidocx/mcp-server",
+  "version": "0.4.0",
+  "description": "MCP server for AiDocX - Create, upload, and manage documents (contracts, proposals, quotations, resumes, reports) from AI assistants",
   "type": "module",
   "license": "MIT",
   "author": "AiDocX <contact@aidocx.ai> (https://aidocx.ai)",
@@ -15,6 +16,10 @@
     "model-context-protocol",
     "aidocx",
     "contract",
+    "proposal",
+    "quotation",
+    "resume",
+    "report",
     "e-signature",
     "document-management",
     "pdf",