# CanUSign MCP Server

MCP (Model Context Protocol) server for CanUSign. Allows Claude to create and manage contracts.

## Installation

```bash
git clone https://github.com/devin-lemcke/canusign-mcp-server
cd canusign-mcp-server
npm install
npm run build
```

## Configuration

### 1. Get your API Key

Go to [CanUSign Settings](https://canusign.com/settings) and create an API key.

### 2. Configure Claude Code

Add the following to your Claude Code MCP settings (`~/.claude/claude_desktop_config.json` or via Claude Code settings):

```json
{
  "mcpServers": {
    "canusign": {
      "command": "node",
      "args": ["/path/to/canusign-mcp-server/dist/index.js"],
      "env": {
        "CANUSIGN_API_KEY": "canu_your_api_key_here"
      }
    }
  }
}
```

Or if using npx (after publishing to npm):

```json
{
  "mcpServers": {
    "canusign": {
      "command": "npx",
      "args": ["canusign-mcp-server"],
      "env": {
        "CANUSIGN_API_KEY": "canu_your_api_key_here"
      }
    }
  }
}
```

## Available Tools

### `create_contract`

Create a new contract for signing.

**Parameters:**
- `title` (required): Title of the contract
- `content`: HTML content of the contract (give this or `document`)
- `document`: Your own PDF, as `{ path }` (a file on this machine) or `{ pdf }` (base64), up to 3 MB
- `language`: de, en, es or fr (default en)
- `signatureFields`: Array of `{ label }` for HTML content. With a `document` each field also
  takes `page`, `x`, `y`, `width`, `height` in percent of the page, origin top-left, where `x`/`y`
  is the top-left corner of the field
- `signers`: Array of `{ label, email }`. Each signer gets a signing link of their own by e-mail.
  The link opens only the fields of that label, and the audit certificate records the address as
  "link delivered to". Signers without an address keep using the shared signing URL
- `tags`: Array of tags for organization
- `finalize`: If true (default), contract is ready for signing

**Example:**
```text
Create a service agreement contract between Acme Corp (client) and John Doe (provider) for web development services at $5000. Add signature fields for both parties.
```

**Example with delivered links:**
```text
Create a service agreement between Acme Corp and John Doe. Send the signing link for "Client" to anna@acme.example and let John sign on my laptop.
```

### `update_contract`

Rename, retag or finalize a draft, and send or resend signing links.

**Parameters:**
- `id` (required): Contract ID or token
- `title`, `tags`, `finalize`
- `signers`: Array of `{ label, email }`. The same address resends the link, a new address
  replaces it and the old link stops working. At most 5 sends per signer in 24 hours

### `list_contracts`

List all contracts with optional filtering.

**Parameters:**
- `status`: Filter by status (draft, pending, pending_payment, fully_signed)
- `limit`: Maximum number of results

### `get_contract`

Get details of a specific contract.

**Parameters:**
- `id` (required): Contract ID or token

### `delete_contract`

Delete a contract (refused once anyone has signed).

**Parameters:**
- `id` (required): Contract ID or token

## Environment Variables

- `CANUSIGN_API_KEY` (required): Your CanUSign API key
- `CANUSIGN_API_URL` (optional): API base URL (default: https://canusign.com)

## Development

```bash
# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev
```

## License

MIT