# chronulus-mcp

> MCP Server

This repository provides an MCP server enabling users to chat with Chronulus AI Forecasting & Prediction Agents within the Claude desktop application. It offers installation instructions using pip or Docker,

## Overview

- **Category:** AI
- **Language:** Python
- **Stars:** 110
- **Forks:** 2
- **Owner:** ChronulusAI
- **GitHub:** https://github.com/ChronulusAI/chronulus-mcp
- **Homepage:** https://www.chronulus.com
- **Created:** 2025-02-16T03:33:30+00:00
- **Updated:** 2025-03-28T06:51:08+00:00
- **Source:** https://model-context-protocol.com/servers/chronulus-ai-forecasting-prediction-server

## Setup

## Setup

1.  Install Claude for Desktop from [here](https://claude.ai/download) (available on macOS and Windows).
2.  Follow the general instructions [here](https://modelcontextprotocol.io/quickstart/user) to configure the Claude desktop client.
3.  Find your Claude config at `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows).
4.  Choose one of the following methods (pip, docker, uvx) and add it to your `claude_desktop_config.json`.

   *   **Using pip:**
       *   Install release from PyPI: `pip install chronulus-mcp` or install from Github:
           ```bash
           git clone https://github.com/ChronulusAI/chronulus-mcp.git
           cd chronulus-mcp
           pip install .
           ```
       *   Add the following JSON to your `claude_desktop_config.json`:
           ```json
           {
             "mcpServers": {
               "chronulus-agents": {
                 "command": "python",
                 "args": ["-m", "chronulus_mcp"],
                 "env": {
                   "CHRONULUS_API_KEY": "<YOUR_CHRONULUS_API_KEY>"
                 }
               }
             }
           }
           ```
   *   **Using docker:**
       *   Clone the repository and build the docker image:
           ```bash
           git clone https://github.com/ChronulusAI/chronulus-mcp.git
           cd chronulus-mcp
            docker build . -t 'chronulus-mcp'
           ```
       *   Add the following JSON to your `claude_desktop_config.json`:
           ```json
           {
             "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:**
       *   Add the following JSON to your `claude_desktop_config.json`:
           ```json
           {
             "mcpServers": {
               "chronulus-agents": {
                 "command": "uvx",
                 "args": ["chronulus-mcp"],
                 "env": {
                   "CHRONULUS_API_KEY": "<YOUR_CHRONULUS_API_KEY>"
                 }
               }
             }
           }
           ```
5.  Optionally, configure additional servers like Filesystem and Fetch.
6.  Update Claude preferences via Claude Desktop or claude.ai/settings.

## Tools

## Available Tools

		1. Chronulus AI Forecasting & Prediction Agents (Chat with Chronulus AI in Claude).
		2. Filesystem (Access and manipulate files).
		3. Fetch (Retrieve data from URLs).