@dversum/mcp-server

Official Model Context Protocol (MCP) server for the dVersum business management API. Lets AI assistants like Claude Desktop, Cursor, and Windsurf interact with your dVersum workspace — managing clients, projects, tasks, invoices, time tracking, and more.

Quick Start

Claude Desktop

Add this to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "dversum": {
      "command": "npx",
      "args": ["-y", "@dversum/mcp-server"],
      "env": {
        "DVERSUM_API_URL": "https://api.dversum.com/api/v1",
        "DVERSUM_API_TOKEN": "your-jwt-token"
      }
    }
  }
}

Cursor / Windsurf

Add to your MCP settings:

{
  "mcpServers": {
    "dversum": {
      "command": "npx",
      "args": ["-y", "@dversum/mcp-server"],
      "env": {
        "DVERSUM_API_URL": "https://api.dversum.com/api/v1",
        "DVERSUM_API_TOKEN": "your-jwt-token"
      }
    }
  }
}

Docker (Production)

Quick start

cd mcp-server

# Create .env file
echo "DVERSUM_API_URL=https://api.dversum.com/api/v1" > .env
echo "DVERSUM_API_TOKEN=your-jwt-token" >> .env

# Run
docker compose up -d

The server starts on port 3100 with a health check at /health and the MCP endpoint at /mcp.

Build & run manually

docker build -t dversum-mcp .
docker run -d \
  -p 3100:3100 \
  -e DVERSUM_API_URL=https://api.dversum.com/api/v1 \
  -e DVERSUM_API_TOKEN=your-jwt-token \
  --name dversum-mcp \
  --restart unless-stopped \
  dversum-mcp

Connect remote MCP to Claude Desktop

Once the Docker container is running, point Claude Desktop to the remote endpoint:

{
  "mcpServers": {
    "dversum": {
      "url": "http://your-server:3100/mcp"
    }
  }
}

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | DVERSUM_API_URL | Yes | Base URL of your dVersum API (e.g. https://api.dversum.com/api/v1) | | DVERSUM_API_TOKEN | Yes | Your JWT authentication token | | MCP_TRANSPORT | No | stdio (default) or http (for Docker/remote) | | MCP_PORT | No | HTTP port when using http transport (default: 3100) |

Available Tools (152)

Clients (5)

| Tool | Description | |------|-------------| | list_clients | List all clients with pagination | | get_client | Get client details | | create_client | Create a new client | | update_client | Update client details | | delete_client | Delete a client |

Contacts (5)

| Tool | Description | |------|-------------| | list_contacts | List all contacts | | get_contact | Get contact details | | create_contact | Create a new contact | | update_contact | Update contact details | | delete_contact | Delete a contact |

Projects (12)

| Tool | Description | |------|-------------| | list_projects | List all projects | | get_project | Get project details | | create_project | Create a new project | | update_project | Update project details | | delete_project | Delete a project | | get_project_board | Get full kanban board (columns + tasks) | | list_project_members | List project members | | add_project_member | Add a member to a project | | remove_project_member | Remove a member from a project | | get_project_time_stats | Get project time statistics | | get_gantt_data | Get Gantt chart data with dependencies | | create_column | Create a kanban column |

Tasks (16)

| Tool | Description | |------|-------------| | get_task | Get task details (assignees, subtasks, tags) | | create_task | Create a task in a project column | | update_task | Update task properties | | delete_task | Delete a task | | move_task | Move task to a different column | | assign_task | Add an assignee to a task | | remove_assignee | Remove an assignee from a task | | list_task_comments | List comments on a task | | `create_comme

... View full README on GitHub