Skip to content
MCP server

Epoch

Time, business-day, cost and PERT/COCOMO estimation maths for AI agents

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API, self-hosted
Runs
Locally
Version
0.6.0
Listing updated
3 days ago

About Epoch

Epoch is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Epoch targets a specific weakness: language models guess how long work will take and cannot perceive elapsed time. It packages classic estimation methods as 26 callable tools, including PERT three-point estimates, an LLM-adapted COCOMO II, sprint velocity, critical path, Monte Carlo simulation and reference-class forecasting.

Beyond estimates, it handles date arithmetic and holiday-aware business-day counts for five countries (US, UK, FR, DE, JP), and a token-to-time bridge covering 16 LLM models with cost comparison. A feedback loop lets you record actual hours so later estimates are corrected from your own history. A bundled reference database ships with the package, and telemetry is off unless you opt in.

The same tools run over MCP (stdio), a command line and a REST server. It is Apache-2.0 licensed, installs with npx, and needs no API keys.

Install

Run in a terminal

claude mcp add epoch -- npx -y @kyanitelabs/epoch

Add to claude_desktop_config.json

{
  "mcpServers": {
    "epoch": {
      "command": "npx",
      "args": [
        "-y",
        "@kyanitelabs/epoch"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "epoch": {
      "command": "npx",
      "args": [
        "-y",
        "@kyanitelabs/epoch"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "epoch": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@kyanitelabs/epoch"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "epoch": {
      "command": "npx",
      "args": [
        "-y",
        "@kyanitelabs/epoch"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "epoch": {
      "command": "npx",
      "args": [
        "-y",
        "@kyanitelabs/epoch"
      ]
    }
  }
}

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

pert_estimate
PERT three-point duration estimate.
cocomo_estimate
COCOMO II effort estimate adapted for LLM-assisted work.

What it does

PERT and COCOMO II
Three-point and size-based estimates for projects.
Monte Carlo and risk
Simulation and schedule-risk scoring.
Business-day maths
Holiday-aware scheduling for five countries.
Token-to-time bridge
Converts token budgets to time and cost across 16 models.
Calibration loop
Record actuals so estimates improve over time.
MCP, CLI and REST
Same 26 tools through three interfaces.

Good for

  • Estimate how long a feature will take with a team of a given size
  • Count working days to a launch date
  • Compare model costs for a large token job
  • Score schedule risk against past estimates
  • Calibrate estimates from recorded actuals

Pricing

Open source

Free, Apache-2.0

Prices change. Check kyanitelabs.github.io before you buy.

Epoch FAQ

How do I install it?

Run claude mcp add epoch -- npx -y @kyanitelabs/epoch@0.8.0, or add the same command to .mcp.json.

Is telemetry on?

No. It is off by default and opt-in, with a preview of what would be shared.

Does it need an API key?

No. The site describes it as zero config with no API keys.

What licence is it under?

Apache-2.0.

Is Epoch free?

Yes. Epoch is open source, so you can use and self-host it for free.

How do I add Epoch to Claude Code?

Run this command in your terminal: claude mcp add epoch -- npx -y @kyanitelabs/epoch

What are the best alternatives to Epoch?

The closest alternatives to Epoch are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Epoch

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity