Wire Balance Engine into your AI · MCP setup

What this is

• Free: today rhythm · flow-month brief (local compute, zero network)
• Paid: personal day brief (day-master × today's stem · needs account key)
• Outputs link back: Flow Notes · subscribe page · free calendar

Balance Engine is a deterministic tool layer for AI agents: the agent talks and plans; the engine returns reproducible rhythm facts. Ask a hundred times — the day pillar and sky anchors stay the same.

Connect via MCP (Model Context Protocol) in Claude Desktop, Cursor, or any compatible client. Preview ≠ prediction — relations and action tips only, no fortune claims.

Three steps

• Install — client runs npx -y balance-engine-mcp (see template below)
• Mint a key — after opening an account, open join.html → Agent API key, generate, copy once
• Paste & reload — set BALANCE_API_KEY, reload, start a new chat: “What's today's rhythm?”

Leave the key empty to try free tools only. Personal day (“my day”) needs the key.

Config template (copy-paste)

Claude Desktop / Cursor MCP config:

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

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 (free)
• month_brief — flow-month sandbox brief (free)
• personal_day — personal day brief (key required; defaults to your cloud birth profile)

Try agent workflows: schedule the afternoon from today's tone; pick a publish day this month. Watch whether the agent treats the engine as a fact base.

How billing works

The MCP package is free. Paid tools bill to your existing subscription (¥365 personal / ¥3,650 company) — the key is just the account's agent channel.

Full product guide: how it works. Calendar subscribe: calendar.html.