Rillsoft Project MCP server

Rillsoft Project MCP server

Deutsch

Rillsoft AI is the AI gateway to Rillsoft Project, the specialist solution formulti-project resource and capacity planning in mid-sized industrialcompanies: an MCP server built into Rillsoft Project 10, on top of itsscheduling engine – not on top of a task list.

The server runs inside the visible, running Rillsoft Project on Windows andexposes the open project to an AI assistant or a script over the ModelContext Protocol: project structure and schedule, roles, people, teams,machines and material, candidate search and staffing assistants, capacityanalysis, baselines and plan/actual comparison, progress and status date, theresource pool, undo and redo.

This repository contains documentation, client configuration and the npmlauncher (launcher.js, see Install via npx).The server itself is part of the Rillsoft Project 10 desktop application; thelauncher only forwards to it, and there is no hosted endpoint.

Full documentation: https://rillsoft.ai/en/mcp/

At a glance

What it is not

• Not a task, to-do or Kanban tool, and not a platform for chat, wiki or teamcollaboration.
• Not a standalone AI product or chat plug-in, but AI access to RillsoftProject as a whole – product, editions and pricing are onwww.rillsoft.com.
• Not an AI that schedules on its own: Rillsoft Project calculates dates,workload and the critical path; the AI reads the result.
• Not a cloud service: the server is reachable on 127.0.0.1 only, insidethe open Rillsoft Project. Rillsoft sends nothing; what your AI client sendsis governed by its provider's privacy policy.
• Not a team server: there is no remote access.
• Not a portfolio editor: portfolios can be opened and evaluated, but notchanged.

Set up

1. Enable the server. In Rillsoft Project open Settings → MCP server,set the active switch and leave read-only mode switched on for now.Alternatively start RillPrj.exe /mcp (port 3928) orRillPrj.exe /mcp:8123 (another port) for one session.Check: the status line shows "running on port 3928".

2. Connect your AI client with clients/generic.json:

   {
     "mcpServers": {
       "rillsoft-project": {
         "type": "http",
         "url": "http://127.0.0.1:3928/mcp"
       }
     }
   }
   

   With an API key set in the settings, useclients/generic-api-key.json(Authorization: Bearer <KEY>). Ready-made entries per client:

   Client	File	Where it goes	Verified
   Claude Code	claude-code.mcp.json	.mcp.json in the project folder, or claude mcp add --transport http rillsoft-project http://127.0.0.1:3928/mcp	12 Oct 2026, 2.1.296
   Claude Desktop	claude-desktop.json	claude_desktop_config.json (Settings → Developer → Edit Config); bridge mcp-remote needs Node.js	12 Oct 2026, 2.31226
   Codex	codex.toml	~/.codex/config.toml, or codex mcp add rillsoft-project --url http://127.0.0.1:3928/mcp	12 Oct 2026, CLI 0.162
   VS Code	vscode.mcp.json	.vscode/mcp.json	12 Oct 2026, 1.117
   Cursor	cursor.mcp.json	~/.cursor/mcp.json	per vendor documentation

   Claude Code and VS Code need Rillsoft Project 10 build 10.0.625 or later.Any other client that speaks MCP over Streamable HTTP uses the addressabove; its documentation names the field names.Check: the client lists the server's tools – in read-only mode only theread-only ones. /mcp is exact, /mcp/ is a 404.

3. Ask the first question, for example: Summarize the current projectstatus: dates, progress, open conflicts, in five paragraphs. Shippedindustry examples with synthetic data let you try it without your ownprojects.

Every mutating call is one ordinary undo step in Rillsoft Project – you takeit back with Ctrl+Z like any of your own edits.

Step by step with success checks: Get started.

Install via npx (launcher)

For catalogues, registries and clients that only start stdio servers there isan npm package,@rillsoft/rillsoft-project-mcp,built from this repository. It is a launcher, not the server:

• With Rillsoft Project 10 running it forwards every request over stdio tothe endpoint http://127.0.0.1:3928/mcp. The address is fixed; there is noenvironment variable for the address and no API key. If an API key is set inRillsoft Project, the launcher reports the 401 – use the HTTP configurationabove instead. For diagnostics only, RILLSOFT_MCP_LOG=<file> writes therequests and answers of a session to a log file.
• Without Rillsoft Project (not running, or not Windows) it answersinitialize and tools/list itself from tools-list.json – the same 118tools as the program – and every tools/call with isError: true and ahint. This is what lets catalogues show the tools on Linux.

{
  "mcpServers": {
    "rillsoft-project": {
      "command": "npx",
      "args": ["-y", "@rillsoft/rillsoft-project-mcp"]
    }
  }
}

Requires Node.js 18 or later; real results only on Windows with RillsoftProject 10 running. Customers do not need the launcher: the configurationsabove connect directly to the running program.

Install as Claude plugin

This repository is also a plugin for Claude Code and Cowork (.claude-plugin/).In Claude Code:

/plugin install rillsoft-project --marketplace rillsoft/rillsoft-project-mcp

What the plugin does on your machine:

• It starts one local MCP server, node ${CLAUDE_PLUGIN_ROOT}/launcher.js(Node.js 18 or later), the same launcher as the npm package above.
• The launcher talks only to http://127.0.0.1:3928/mcp, the MCP endpoint ofRillsoft Project 10 running on the same computer. It sends no data anywhereelse, collects no telemetry, needs no account and no API key.
• Without Rillsoft Project running it reads tools-list.json from the pluginfolder and lists the tools; every tool call then answers with a hint insteadof a result.
• It writes a log file only if you set RILLSOFT_MCP_LOG=<file> yourself.

Your AI client sends the project data that the tools return to its provider,as with every MCP server. Local plugin servers run in Claude Code and Cowork;the chat in Claude Desktop ignores them – use the configuration under“Set up” there.

If something is stuck

Tool catalogue and contract

Tool names carry the prefix rillsoft_ and are English in every languagebuild; arguments, result fields, enum values and error codes are stable,messages follow the language of the running Rillsoft Project. Howtools/list, schemas, errors, undo, read-only mode and sessions work:Developers: the MCP server contract.

The complete tool catalogue – 118 tools of Rillsoft Project 10.0.626.0 withtitle, access class, parameters and description – is inTOOLS.md. It is generated from tools/list of the running programby scripts/generate_tools.py, never edited by hand; the raw result, includingthe output schemas, is in tools-list.json.

Links

• MCP server: https://rillsoft.ai/en/mcp/
• Get started: https://rillsoft.ai/en/get-started/
• Developers: https://rillsoft.ai/en/developers/
• Prompt library: https://rillsoft.ai/en/prompts/
• Product: https://www.rillsoft.com/mcp-server/
• Official MCP Registry: ai.rillsoft/rillsoft-project (entry)

Provider

Rillsoft GmbH, Leonberg, Germany – software for scheduling, resource andmulti-project planning. Rillsoft Project is proprietary software; thisrepository contains its MCP documentation and the launcher.

License

The documentation and the tool catalogue in this repository are licensedunder CC BY 4.0; the launcher code (launcher.js) under theMIT License. Rillsoft Project itself, including its MCPserver, is proprietary software of Rillsoft GmbH and is not covered by eitherlicense.