Back to Directory/Developer Tools

io.github.aidocx/mcp-server

Create, upload, and manage contracts from AI assistants. AI analysis and e-signatures.

Developer ToolsTypeScriptv0.3.1

aidocx-mcp-server

MCP (Model Context Protocol) server for AiDocX — AI-powered document management platform.

Create, upload, and manage business documents and presentation decks 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.

Presentation decks: Convert any text content into professionally designed slide decks using AI.

Quick Start

1. Get API Keys

Sign up at app.aidocx.ai and go to Settings > API Keys to generate your credentials.

2. Configure Your AI Client

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "aidocx": {
      "command": "npx",
      "args": ["aidocx-mcp-server"],
      "env": {
        "AIDOCX_API_KEY": "ak_xxxxxxxx",
        "AIDOCX_API_SECRET": "your_secret_here"
      }
    }
  }
}
Claude Code
claude mcp add aidocx \
  -e AIDOCX_API_KEY=ak_xxxxxxxx \
  -e AIDOCX_API_SECRET=your_secret_here \
  -- npx aidocx-mcp-server

3. Start Using

Ask your AI assistant:

  • "NDA 계약서 작성해줘" (Draft an NDA contract)
  • "견적서 만들어줘" (Create a quotation)
  • "이력서 작성해줘" (Create a resume)
  • "제안서 만들어줘" (Create a proposal)
  • "내 문서 목록 보여줘" (Show my documents)
  • "이 문서 AI로 분석해줘" (Analyze this document with AI)
  • "이 기사로 IR 덱 만들어줘" (Create an IR deck from this article)
  • "내 덱 목록 보여줘" (Show my decks)
  • "이 덱 제목 바꿔줘" (Rename this deck)

Available Tools

Document Management

ToolDescription
create_documentCreate a new document (contract, proposal, quotation, resume, report, etc.) — auto-generates PDF
upload_documentUpload a PDF or Office file (DOC, DOCX, HWP, XLS, XLSX, PPT, PPTX)
list_documentsList documents with optional pagination
get_documentGet document details and extracted text
delete_documentDelete a document
search_documentsSearch documents with text query, date filters, and pagination
analyze_documentAI-powered document analysis with risk score and insights

Folder Management

ToolDescription
list_foldersList folders
create_folderCreate a new folder
delete_folderDelete a folder (optionally with all contents)

Presentation Decks

ToolDescription
create_deckCreate a presentation deck from text content using AI (dark/light themes, 16:9 slides)
list_decksList presentation decks with folder filtering and pagination
get_deckGet deck details and full slide design JSON
edit_deckEdit deck title, folder, or slide design components
delete_deckDelete a deck and all its slide designs

Document Types

TypeExamples
contractService agreements, NDAs, employment contracts
proposalProject proposals, consulting proposals
quotationPrice quotes, cost estimates
planProject plans, strategy documents
business-planInvestor pitch business plans
reportAnalysis reports, audit reports
official-letterOfficial letters, notices, requests
resumeResumes, CVs, cover letters
purchase-orderPurchase orders, delivery notes
manualSOPs, user manuals, guides

Workflow

Documents

  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

Presentation Decks

  1. Provide text content (article, notes, data) -> calls create_deck -> AI generates multi-slide deck
  2. Open the editor URL to preview, customize slides, and adjust design
  3. Share the deck with viewers or export as needed

Security

  • API credentials are transmitted via X-API-Key and X-API-Secret headers over HTTPS only
  • Credentials are never logged — the MCP server does not write API keys to stdout, files, or any persistent storage
  • Per-key rate limiting is enforced server-side (plan-dependent: 30-600 req/min)
  • All inputs are validated with strict schemas — UUID format for IDs, length limits on text fields, bounded pagination
  • API keys can be rotated or revoked at any time from Settings > API Keys
  • Each key has an optional expiry (7d / 30d / 90d / never) — use short-lived keys for CI/CD or shared environments
  • Destructive operations (delete document/deck/folder) require explicit confirmation by the AI assistant

Environment Variables

VariableRequiredDescription
AIDOCX_API_KEYYesAPI key (starts with ak_)
AIDOCX_API_SECRETYesAPI secret (64-char hex)
AIDOCX_API_URLNoAPI base URL (default: https://api.aidocx.ai)
AIDOCX_APP_URLNoApp base URL (default: https://app.aidocx.ai)

Changelog

v0.5.0

  • Added 5 presentation deck tools: create_deck, list_decks, get_deck, edit_deck, delete_deck
  • Added PUT method support to API client
  • Strengthened input validation across all tools (UUID format, length limits, bounded pagination)

v0.4.1

  • Tool rename: contract -> document for broader document type support
  • Improved error messages with actionable guidance

v0.4.0

  • Added search_documents and analyze_document tools
  • Added folder management tools

v0.1.0

  • Initial release with document CRUD and upload

Links

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y aidocx-mcp-server

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-aidocx-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "aidocx-mcp-server"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

aidocx-mcp-servernpm

Compatible MCP Clients

io.github.aidocx/mcp-server works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More