Happy slice of mcp pizzaMCP.pizza
chronulus-mcp

chronulus-mcp

MCP.Pizza Chef: ChronulusAI

Chronulus is a paid outside service, and this add-on is the doorway to it. You describe a situation and a question, hand over text, images or PDFs, and its agents come back with either a forecast over time or a yes-or-no probability, each with a written explanation you can save next to the numbers. Plans start at $7.50 a month with no free tier, and usage is metered in units called chrons. The add-on has not been updated since July 2025, although the service behind it is still active.

Unmaintained · No commits in 13 months.
Data
Web/Research

Use This MCP server To

Forecast next quarter's demand from a written brief Estimate the chance a deal closes this month Turn a PDF report into a forecast with an explanation Save a forecast as a spreadsheet and a written rationale Get a risk scorecard for the question I asked

README

Chronulus AI

MCP Server for Chronulus

Chat with Chronulus AI Forecasting & Prediction Agents in Claude

Quickstart: Claude for Desktop

Install

Claude for Desktop is currently available on macOS and Windows.

Install Claude for Desktop here

Configuration

Follow the general instructions here to configure the Claude desktop client.

You can find your Claude config at one of the following locations:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Then choose one of the following methods that best suits your needs and add it to your claude_desktop_config.json

Using pip

(Option 1) Install release from PyPI

pip install chronulus-mcp

(Option 2) Install from Github

git clone https://github.com/ChronulusAI/chronulus-mcp.git
cd chronulus-mcp
pip install .
{
  "mcpServers": {
    "chronulus-agents": {
      "command": "python",
      "args": ["-m", "chronulus_mcp"],
      "env": {
        "CHRONULUS_API_KEY": "<YOUR_CHRONULUS_API_KEY>"
      }
    }
  }
}

Note, if you get an error like "MCP chronulus-agents: spawn python ENOENT", then you most likely need to provide the absolute path to python. For example /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 instead of just python

Using docker

Here we will build a docker image called 'chronulus-mcp' that we can reuse in our Claude config.

git clone https://github.com/ChronulusAI/chronulus-mcp.git
cd chronulus-mcp
 docker build . -t 'chronulus-mcp'

In your Claude config, be sure that the final argument matches the name you give to the docker image in the build command.

{
  "mcpServers": {
    "chronulus-agents": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "CHRONULUS_API_KEY", "chronulus-mcp"],
      "env": {
        "CHRONULUS_API_KEY": "<YOUR_CHRONULUS_API_KEY>"
      }
    }
  }
}
Using uvx

uvx will pull the latest version of chronulus-mcp from the PyPI registry, install it, and then run it.

{
  "mcpServers": {
    "chronulus-agents": {
      "command": "uvx",
      "args": ["chronulus-mcp"],
      "env": {
        "CHRONULUS_API_KEY": "<YOUR_CHRONULUS_API_KEY>"
      }
    }
  }
}

Note, if you get an error like "MCP chronulus-agents: spawn uvx ENOENT", then you most likely need to either:

  1. install uv or
  2. Provide the absolute path to uvx. For example /Users/username/.local/bin/uvx instead of just uvx
Additional Servers (Filesystem, Fetch, etc)

In our demo, we use third-party servers like fetch and filesystem.

For details on installing and configure third-party server, please reference the documentation provided by the server maintainer.

Below is an example of how to configure filesystem and fetch alongside Chronulus in your claude_desktop_config.json:

{
  "mcpServers": {
    "chronulus-agents": {
      "command": "uvx",
      "args": ["chronulus-mcp"],
      "env": {
        "CHRONULUS_API_KEY": "<YOUR_CHRONULUS_API_KEY>"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/AIWorkspace"
      ]
    },
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    }
  }
}
Claude Preferences

To streamline your experience using Claude across multiple sets of tools, it is best to add your preferences to under Claude Settings.

You can upgrade your Claude preferences in a couple ways:

  • From Claude Desktop: Settings -> General -> Claude Settings -> Profile (tab)
  • From claude.ai/settings: Profile (tab)

Preferences are shared across both Claude for Desktop and Claude.ai (the web interface). So your instruction need to work across both experiences.

Below are the preferences we used to achieve the results shown in our demos:

## Tools-Dependent Protocols
The following instructions apply only when tools/MCP Servers are accessible.

### Filesystem - Tool Instructions
- Do not use 'read_file' or 'read_multiple_files' on binary files (e.g., images, pdfs, docx) .
- When working with binary files (e.g., images, pdfs, docx) use 'get_info' instead of 'read_*' tools to inspect a file.

### Chronulus Agents - Tool Instructions
- When using Chronulus, prefer to use input field types like TextFromFile, PdfFromFile, and ImageFromFile over scanning the files directly.
- When plotting forecasts from Chronulus, always include the Chronulus-provided forecast explanation below the plot and label it as Chronulus Explanation.

chronulus-mcp FAQ

Do I need to pay?
Yes. Chronulus is a subscription with no free tier — plans start at $7.50 a month, and every request spends from a monthly allowance measured in units called chrons.
Do I need an account key?
Yes. You create an account, generate a key in the Chronulus console, and paste it into your assistant's settings file alongside the entry for this add-on.
Can I use this to forecast my own sales?
Yes, within limits. You describe the situation and attach documents, and it reads them and forms a view. It is not fitting a statistical model to a spreadsheet of your own history.
Where do the actual numbers come from?
You supply the scale. The service returns a shape over time, and the save command asks you for the smallest and largest values to expect, so the resulting spreadsheet is that shape stretched between two figures you chose.
Does my material leave my computer?
Yes. The text, images and PDFs you attach are sent to Chronulus to be analyzed, so keep confidential documents out of it unless your organization has cleared the vendor.
Which apps does it work with?
Claude Desktop is the documented one, with three different ways to install it, and it works in anything that accepts a standard MCP entry.
Is it still maintained?
The add-on itself has not changed since July 2025 and its published package dates from March 2025, while the service behind it is still being updated — so expect the add-on to lag the service.
Can it change anything on my computer?
Only by writing files. Two commands save a spreadsheet, a text explanation and an HTML report into a folder you name. Nothing is deleted or moved.
Should I trust a forecast enough to act on it?
Treat it as an informed opinion with its reasoning attached, not a measurement. Read the written explanation that comes with every result before putting the number in front of anyone.