eSign MCP Server

What is eSign MCP Server?

eSign MCP Server is an MCP (Model Context Protocol) server that provides tools for signing PDF documents by adding signature images at specified coordinates. It wraps the signpdf utility with a modern MCP interface and is intended for developers using AI assistants like Claude Desktop or Claude Code.

How to use eSign MCP Server?

Install dependencies via uv pip install -r requirements.txt and run uv run python mcp_server.py. Configure your MCP client (e.g., Claude Desktop) with the command uv run python /ABSOLUTE/PATH/TO/esign-mcp/mcp_server.py. Use the tools sign_pdf and get_pdf_info with Base64-encoded file content.

Key features of eSign MCP Server

• Sign PDF with precise coordinate positioning
• Get PDF metadata including page count and dimensions
• Support for PNG and JPG signature images
• Optional date stamping next to the signature
• Base64 encoding for all file transfers
• Input validation and descriptive error handling

Use cases of eSign MCP Server

• Signing business contracts or agreements on specific pages
• Adding digital signatures to PDF documents at precise locations
• Obtaining PDF page dimensions before placing a signature
• Automating document signing workflows in AI-assisted environments

FAQ from eSign MCP Server

What dependencies does eSign MCP Server require?

Python 3.11+, along with the packages fastmcp, pypdf, reportlab, and pillow. Install via uv pip install -r requirements.txt.

How do I configure eSign MCP Server for Claude Desktop?

Edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\) and add an entry with command uv and args ["run", "python", "/ABSOLUTE/PATH/TO/esign-mcp/mcp_server.py"].

What coordinate system does eSign MCP Server use?

PDF standard units (1/72 inch) with origin (0,0) at the bottom-left corner of the page. X increases rightward, Y increases upward.

Can eSign MCP Server run without uv?

Yes, you can use standard pip install -r requirements.txt and then run python mcp_server.py instead of uv run python mcp_server.py.

What should I do if the MCP server doesn't appear in Claude Desktop?

Ensure the path in the config file is absolute, restart Claude Desktop, and check the logs at ~/Library/Logs/Claude/mcp*.log on macOS. Also verify dependencies are installed.