Wire Nonlinear Calendar into your AI · MCP setup

Install · empty key is enough

• What’s today’s rhythm?
• Should I sleep earlier tonight?
• When should I do deep work today?
• What’s this month’s potential?
• Which year does this month fold onto?

The product is Nonlinear Calendar. To install, search balance-engine in the official MCP Registry, or paste npx -y balance-engine-mcp. Do not search the Registry for “Nonlinear Calendar”.

Ask the same day twice: a model may invent two different pillars; this engine will not. Empty key can ask the five questions below. Only “my day / my month” needs an account.

How to say it (copy-paste)

Ask the same day twice: a model may invent two different pillars; this engine will not. Not a fortune bot — a deterministic time-coordinate lookup. Install: search balance-engine in the MCP Registry, or npx -y balance-engine-mcp. Empty key: today’s rhythm, sleep earlier, deep work window, this month’s potential, which year this month folds onto.

Should you install

• Install if: you ask an AI when to move, when to sleep, whether this month is for polish or hold, or which year this month folds onto — and you hate a different “daily fortune” every time
• Skip if: you want fortune-telling chat, medical advice, a diet protocol, ad buying, or only a web calendar (use calendar.html)
• Try free first: public sky needs no key and burns no tokens; a personal timetable needs your own account

The product is Nonlinear Calendar. The brand stays Balance Engine — an energy-rhythm engine. Wellness questions in: ask “when should I move today”, “should I sleep earlier”, “what’s this month’s potential”, “which year does this month fold onto” — it looks up rhythm, energy, potential, and the fold year. Same day, same answer. Adjust ≠ infuse energy. Preview ≠ prediction. Not a diet protocol, not a diagnosis.

Connect via MCP in Claude Desktop, Cursor, or any compatible client. The client name is nonlinear-calendar. Leave the key empty to try the public tools, including time_fold. If you want “my day” or “which luck cycle those years sat in”, open an account. Relations and action tips only — no fortune claims.

What this is

• For a person: Life OS — “should I sleep earlier?”, “when should I move today?”, “polish or hold this month?”
• For a company: “how is the company running this stretch?” — push or hold this week (a rhythm barometer, not a performance scorecard)
• For a pet: “how is the dog’s body this stretch?” — same east × west calendars, on a birth or adoption day. Not out yet. Still being built.

This is a personal life system. MCP is not another chat box. It plugs two already-computed time coordinates into the agent: the east calendar (ganzhi, solar terms, flow-month, day and hour pillars) and the west sky (moon, retrogrades, ingresses, eclipses). Same day, both looked up, then crossed into do / don’t.

The readout is not the model thinking. L1 never calls an LLM — tables, formulas, thresholds. The date goes in; pillars and sky come out; the sentences were written when the rules were. Same day, same timezone, same answer. The AI only says the facts in human language. There is still a readout without AI because the meaning lives in the rules.

How to read the fold table: Flow Notes Nonlinear Calendar.

What changed

• Display name: Nonlinear Calendar · install command unchanged
• Lookup stamp: source: rules-engine · Asia/Shanghai · as_of · Preview ≠ prediction
• Today / this month include the fold year; empty key can only use free tools

The client display name is now Nonlinear Calendar (config key nonlinear-calendar). The npm package is still npx -y balance-engine-mcp — existing configs keep working.

Ask about today or this month and the fold year is already there (Bingshen = 2016 Bingshen). Ask what they lived that year — do not invent a story. Call time_fold only for the 12-row table. Ask for a birth date only when someone wants dayun. How others ask, look ahead, and use the table in a team: Nonlinear Calendar · examples.

Three steps

• Install — paste the config below into Claude / Cursor; leave BALANCE_API_KEY empty
• Try five questions in a new chat — “what’s today’s rhythm?”, “should I sleep earlier?”, “when should I do deep work today?”, “what’s this month’s potential?”, “which year does this month fold onto?”
• (Optional) your own timetable — after opening an account, mint a key on join.html, then ask “my day”

The first two steps need no key. “My day / my month” needs an account — that is the personal timetable, not a per-query surcharge.

Config template (copy-paste)

Claude Desktop / Cursor MCP config:

{
  "mcpServers": {
    "nonlinear-calendar": {
      "command": "npx",
      "args": ["-y", "balance-engine-mcp"],
      "env": {
        "BALANCE_API_KEY": ""
      }
    }
  }
}

Leave the key empty to try public sky tools; paste be_… after you open an account. In Cursor you can also use repo .cursor/mcp.json. Flip the MCP toggle on, wait for green, then open a new chat.

Tools

• today_rhythm — “today's rhythm / today's potential / day pillar” (free · local · includes this month’s fold year)
• body_rhythm — “sleep earlier / train or rest / this hour” (free · local)
• energy_adjust — “how to adjust energy / push vs hold” (free · local · seat=personal or org)
• activity_window — “when to move / deep work / rest” (free · local · movement uses task=train)
• month_brief — “this month's potential / polish or hold / which days to publish” (free · local · includes this month’s fold year)
• time_fold — “which year does this month fold onto” (free · local · no biography)
• sky_window — “sky events next 2 weeks / new moon dates” (free · local)
• personal_day — “my day / hour tone” (key; hour like 14:30 or 未)
• personal_month — “my month / which week to push” (key · day-master × month stem + sandbox)

Try agent workflows: when should I move today; which year does this month fold onto; schedule the afternoon from this month’s potential. Watch whether the agent treats the engine as a fact base.

MCP and the calendar are one protocol

We provide a deterministic rhythm node: agents call it over MCP, calendars subscribe over ICS. Both are “they call you” — not another sales line. Web calendar: calendar.html.

How to verify (copy-paste)

• This layer does not use AI: ganzhi, flow-month, and sky come from a rules engine, not a model
• Same day, same timezone (Asia/Shanghai): a model may invent two different pillars; this engine does not
• Year and flow-month pillars come from the engine — do not mental-math 1 January or the lunar month name
• Public sky is free and burns no tokens; “my timetable” is a yearly account, not per-query fortune
• Preview ≠ prediction: relations and do/drop only, no fortune claims

Public ground-truth set (HF-ready): repo eval/date-hallucination/.

How billing works

Install first, decide later: the MCP package and public sky tools are free and do not burn tokens — this layer does not use AI. The personal timetable bills to your existing yearly account (¥365 personal / ¥3,650 company). The key is just the account's agent channel.

Official MCP Registry: search balance-engine or io.github.singularitybpjade/balance-engine. Cursor / Claude pick it up from this feed or downstream directories.

WorkBuddy / CodeBuddy: Plugins → MCP servers → paste the same config into ~/.workbuddy/mcp.json. That works today. A card in Tencent’s MCP market waits until they reopen third-party listings — the official registry does not sync there.

Coze / Dify can import the static OpenAPI: openapi-agent.json.

Full product guide: how it works. How to read the fold: Nonlinear Calendar. Calendar subscribe: calendar.html.