# Nonlinear Calendar (npm · balance-engine-mcp)

Nonlinear Calendar: this year’s months fold onto the previous 12 years. No key to try.

- Trust score: 65/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-20

## Components

- npm · `balance-engine-mcp`: 65/100 (this document), [markdown](https://verifymcp.io/servers/singularitybpjade-balance-engine/balance-engine-mcp.md), [page](https://verifymcp.io/servers/singularitybpjade-balance-engine/balance-engine-mcp)

## Channel facts

- Registry: `npm`
- Package: `balance-engine-mcp`
- Version: `0.1.10`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-20.

- **Supply Chain Security**: 98/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 30 of 95 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 19/100
  - Repository check failed: the declared repository URL returned HTTP 404.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 1 days ago).
  - Security-disclosure policy not yet verified: we couldn't inspect the source repository.
- **Schema Quality & AI Usability**: 69/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1752 tokens (~194/item across 9 items; 9 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 20/100
  - Stability observed for 6 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add singularitybpjade-balance-engine -- npx -y balance-engine-mcp
```

### Codex

```bash
codex mcp add singularitybpjade-balance-engine -- npx -y balance-engine-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "singularitybpjade-balance-engine": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "balance-engine-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add singularitybpjade-balance-engine --command npx --arg -y --arg balance-engine-mcp
```

### Hermes

```yaml
mcp_servers:
  singularitybpjade-balance-engine:
    command: "npx"
    args: ["-y", "balance-engine-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "singularitybpjade-balance-engine": {
      "command": "npx",
      "args": [
        "-y",
        "balance-engine-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-19 (score 65, +16)

- [security improvement] Malware scan: unverified → pass

### 2026-08-18 (score 49, −16)

- [security regression] Known CVEs: pass → unverified
- [security regression] Malware scan: pass → unverified
- [functional regression] Schema quality: 138 → 194
- [functional regression] Schema quality: 138 → 162
- [functional regression] Schema quality: 138 → 160
- [functional regression] Dependency health: 0.85 → unverified
- [functional] Package version: 0.1.5 → 0.1.9
- [functional] Package version: 0.1.5 → 0.1.8
- [functional] Package version: 0.1.5 → 0.1.7

### 2026-08-17 (score 65, +11)

- [security improvement] Known CVEs: unverified → pass
- [functional improvement] Dependency health: unverified → 0.85

### 2026-08-16 (score 54, 0)

- [security regression] Stability: 0.03 → unverified
- [security improvement] Known CVEs: unverified → pass
- [functional regression] Capabilities: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional improvement] Dependency health: unverified → 0.85
- [functional] First check of Schema quality: unverified
- [functional] Package version: 0.1.4 → 0.1.5

### 2026-08-15 (score 54, +1)

- [security improvement] Known CVEs: unverified → pass
- [security] Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet.
- [functional regression] Capabilities: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional improvement] Stability: unverified → 0.03
- [functional improvement] Dependency health: unverified → 0.85
- [functional] First check of Schema quality: unverified
- [functional] Package version: 0.1.3 → 0.1.4

### 2026-08-14 (score 53)

First indexed and scored.

## MCP tools (9)

### `today_rhythm` (~227 tokens)

Today rhythm · 今日节奏

This tool looks up a deterministic rules engine. Same day → same answer. Do not invent pillars or fortune claims. Call when the user asks 今天节奏怎么样 / 今天势能怎么样 / 今天干支是什么 / 今天适不适合签约开会发版 / 今天流通怎么样 / 该不该推进某事 / what is today's rhythm. Returns east pillars, this month’s fold year (same pillar), month posture × west tightness as do/don't, plus the daily west almanac. Always surface the fold-year line and ask what they lived that year. Public · local · no API key. Preview ≠ prediction.

Input parameters:

- `date` (string): Date YYYY-MM-DD. Default: today in Asia/Shanghai. Use when the user asks about a specific day.
- `hour` (string): Clock HH:MM or 时支 like 申 / 未时. Adds the public hour pillar. Use when the user says 现在 / 下午 / 几点.
- `locale` (string): Reply language. zh (default) or en.

### `month_brief` (~173 tokens)

Flow-month brief · 流月预演

This tool looks up a deterministic rules engine. Same day → same answer. Do not invent pillars or fortune claims. Call when the user asks 这个月势能怎么样 / 这个月该打磨还是该收 / 这个月哪天发布 / 这个月节奏怎么样 / 流月基调 / 做不做某事 / 哪几天适合上线 / which days to publish. Returns this month’s fold year (same pillar), baseline tone, dated sky marks, and a do/drop list. Always surface the fold-year line and ask what they lived that year. Public · local · no API key. Preview ≠ prediction.

Input parameters:

- `locale` (string): Reply language. zh (default) or en.
- `month` (string): Month YYYY-MM. Default: current month.

### `sky_window` (~154 tokens)

Sky window · 天象窗口

This tool looks up a deterministic rules engine. Same day → same answer. Do not invent pillars or fortune claims. Call when the user asks 未来两周有什么天象 / 新月哪天 / 日食哪天 / 接下来有没有逆行 / what sky events are coming. Lists dated L1 sky marks (new/full moon, eclipse, ingress, stations). Public · local · no API key. Max span 45 days. Preview ≠ prediction.

Input parameters:

- `from` (string): Start date YYYY-MM-DD. Default: today.
- `locale` (string): Reply language. zh (default) or en.
- `to` (string): End date YYYY-MM-DD. Default: from + 14 days.

### `body_rhythm` (~191 tokens)

Body rhythm · 身体节奏

This tool looks up a deterministic rules engine. Same day → same answer. Do not invent pillars or fortune claims. Call when the user asks 今晚要不要提前睡 / 今天该不该加练 / 现在这个时辰适不适合动 / body energy / train or rest. Public body-energy rehearsal from solar term + hour + month posture × sky tightness. Not a diagnosis. Adjust ≠ infuse energy. Public · local · no API key. Preview ≠ prediction.

Input parameters:

- `date` (string): Date YYYY-MM-DD. Default: today in Asia/Shanghai. Use when the user asks about a specific day.
- `hour` (string): Clock HH:MM or 时支 like 申. Pins the hour slot. Use when the user says 现在 / 下午 / 几点.
- `locale` (string): Reply language. zh (default) or en.

### `energy_adjust` (~215 tokens)

Energy adjust · 能量调节

This tool looks up a deterministic rules engine. Same day → same answer. Do not invent pillars or fortune claims. Call when the user asks 能量怎么调 / 个人今天该推还是该收 / 团队这周该不该硬上线 / personal vs company rhythm. Same engine, two seats: personal (sleep/load) or org (window push vs hold). Not HR scoring, not medical treatment. Public · local · no API key. Preview ≠ prediction.

Input parameters:

- `date` (string): Date YYYY-MM-DD. Default: today in Asia/Shanghai. Use when the user asks about a specific day.
- `hour` (string): Optional hour for the personal seat (HH:MM or 时支).
- `locale` (string): Reply language. zh (default) or en.
- `month` (string): Month YYYY-MM for the org seat. Default: current month.
- `seat` (string): personal (default) = body load/sleep. org = team window, push vs hold.

### `activity_window` (~208 tokens)

Activity window · 活动窗口

This tool looks up a deterministic rules engine. Same day → same answer. Do not invent pillars or fortune claims. Call when the user asks 今天什么时候适合运动 / 今天哪个时辰适合深工 / 什么时候开会 / 什么时候练 / 什么时候发版 / 什么时候该休息 / activity window / when to exercise. Maps month posture × twelve hours × body load to 2–3 clock windows for task=deep_work|train|meet|ship|rest. Windows are suggested slots, not a guarantee. Not meds, not glucose, not a diagnosis. Public · local · no API key. Preview ≠ prediction.

Input parameters:

- `date` (string): Date YYYY-MM-DD. Default: today in Asia/Shanghai. Use when the user asks about a specific day.
- `locale` (string): Reply language. zh (default) or en.
- `task` (string): What to place: deep_work (default), train, meet, ship, rest.

### `time_fold` (~189 tokens)

Time fold · 时间折叠

This tool looks up a deterministic rules engine. Same day → same answer. Do not invent pillars or fortune claims. Call when the user asks 时间折叠 / 现在叠的是哪一年 / 这个月对应哪一年 / time folding / nonlinear time / 甲午月是哪一年. Lead with this month’s fold year (same pillar). Ask the user what they lived that year — do not invent a biography. Then the 12-row table. Same table for everyone. Dayun is personal. Public · local · no API key. Preview ≠ prediction.

Input parameters:

- `date` (string): Date YYYY-MM-DD. Default: today in Asia/Shanghai. Use when the user asks about a specific day.
- `locale` (string): Reply language. zh (default) or en.
- `month` (string): Month YYYY-MM if not passing date. Pins the flow-month.

### `personal_day` (~215 tokens)

Personal day · 个人日读

This tool looks up a deterministic rules engine. Same day → same answer. Do not invent pillars or fortune claims. Call when the user asks 我今天怎么样 / 我今天下午适不适合见面 / 未时基调 / 我的日主和今天什么关系 / my day. Personalized: day-master vs today's stem (十神) + optional hour pillar. Requires BALANCE_API_KEY + birth profile. Empty key → error personal_timetable_requires_key; use free tools instead. Not a fortune verdict.

Input parameters:

- `birth` (object): Optional birth profile. If omitted, uses the cloud profile saved on the paid account.
- `date` (string): Date YYYY-MM-DD. Default: today in Asia/Shanghai. Use when the user asks about a specific day.
- `hour` (string): Clock HH:MM or earthly branch 子–亥 (e.g. 14:30 or 未). Adds hour-pillar ten-god.
- `locale` (string): Reply language. zh (default) or en.

### `personal_month` (~180 tokens)

Personal month · 个人流月

This tool looks up a deterministic rules engine. Same day → same answer. Do not invent pillars or fortune claims. Call when the user asks 我这个月怎么样 / 我哪周该推进 / 我这个月适不适合上线 / my month. Personalized flow-month: day-master vs month stem, dated sky, sandbox assumptions, fold-memory prompts. Requires BALANCE_API_KEY + birth profile. Empty key → error personal_timetable_requires_key; use free tools instead. Not a fortune verdict.

Input parameters:

- `birth` (object): Optional birth profile. If omitted, uses the cloud profile saved on the paid account.
- `date` (string): Optional YYYY-MM-DD to pin which flow month to use.
- `locale` (string): Reply language. zh (default) or en.
- `month` (string): Month YYYY-MM. Default: current month.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/singularitybpjade-balance-engine/balance-engine-mcp#diagnostics

## Score history

- 2026-08-20: 65
- 2026-08-19: 65
- 2026-08-18: 49
- 2026-08-17: 65
- 2026-08-16: 54
- 2026-08-15: 54
- 2026-08-14: 53

## Links

- npm package: https://www.npmjs.com/package/balance-engine-mcp
- Socket report: https://socket.dev/npm/package/balance-engine-mcp
- Website: https://balance-engine.vercel.app/stories/agent-mcp.html
- Changelog RSS feed: https://verifymcp.io/servers/singularitybpjade-balance-engine/balance-engine-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/singularitybpjade-balance-engine/balance-engine-mcp.json
- HTML version of this page: https://verifymcp.io/servers/singularitybpjade-balance-engine/balance-engine-mcp