@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