# HTML2PDF Converter MCP Server

An MCP (Model Context Protocol) server for HTML2PDF Converter. This server exposes a `generate_pdf` tool, allowing AI models like Claude, Cursor, and others to seamlessly convert HTML or URLs to PDF documents on your behalf.

## Requirements

- Node.js >= 18
- An HTML2PDF Converter API Key (get one at [https://html2pdfconverter.com](https://html2pdfconverter.com))

## Usage

You can run this MCP server directly via `npx` in any MCP-compatible client.

### Claude Desktop Configuration

Add the following to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "html2pdf": {
      "command": "npx",
      "args": ["-y", "@html2pdfconverter/mcp-server"],
      "env": {
        "HTML2PDF_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}
```

### Cursor Configuration

In Cursor, go to **Settings > MCP Servers** and add a new server:
- **Type:** command
- **Command:** `npx -y @html2pdfconverter/mcp-server`
- **Environment Variables:** `HTML2PDF_API_KEY=YOUR_API_KEY_HERE`

## Available Tools

- `generate_pdf`: Converts a URL or raw HTML string into a PDF and saves it to a temporary file, returning the file path.

## Development

```bash
# Install dependencies
npm install

# Build
npm run build

# Run locally (requires HTML2PDF_API_KEY env var)
HTML2PDF_API_KEY=your_key npm start
```