SkillFoxx

Horosa Skill MCP

An MCP server and CLI that compute natal charts, Bazi, Qimen and tarot offline, so the agent works from real chart data

  • 509 ★ on the repository
  • Last commit
  • AGPL-3.0
MCP server

Extended access

Why this level

  • The install downloads an offline engine (about 730 MB) with Java and Node from GitHub and runs it as a local process on 127.0.0.1
  • Birth dates, places and client names are saved in a local SQLite database and end up in reports
  • The optional Jev cloud layer, when enabled, sends an anonymized question text to servers in the US
All reasons and checks

horace-maxwell/horosa-skillAuthor:Horace Maxwell

Install

Manual install

/plugin marketplace add Horace-Maxwell/horosa-skill

Then run `/plugin install horosa@horosa-skill` and install the engine once with the command from the `runtime.not_installed` message.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The install downloads an offline engine (about 730 MB) with Java and Node from GitHub and runs it as a local process on 127.0.0.1
  • Birth dates, places and client names are saved in a local SQLite database and end up in reports
  • The optional Jev cloud layer, when enabled, sends an anonymized question text to servers in the US

This is third-party code. Review the repository files before installing.

What it does

Horosa Skill gives an agent an MCP server and a CLI that compute astrological charts and Chinese divination systems on your own computer. The set has more than a hundred techniques: Western astrology with the natal chart, transits, progressions, primary directions, horary and electional astrology, astrocartography and synastry, then Bazi, Zi Wei Dou Shu, Da Liu Ren, Qimen Dunjia, Tai Yi, Jinkoujue, Liu Yao, tarot, the Chinese almanac and 14 Shenshu systems. After installation the calculations run in a local engine, and birth dates and places stay off the network by default. Before a calculation the server checks whether it has enough data. If a technique needs a time, place, time zone, gender or question type, it stops the agent and returns a question that can be forwarded to the person. Every answer arrives in one format together with a basis card: which technique, whose school, whether all sections came back. The `horosa_hecan` tool runs several techniques on one question and returns a comparison template where disagreements must be disclosed and cannot be averaged. Results are saved into a local SQLite database with full-text search, and one command builds DOCX, PDF and JSON reports from them. Your own notes can go into a local knowledge base and reach the agent's context together with the calculation.

Who it is for. Astrologers and enthusiasts who ask an agent to interpret a chart, and bot developers who need a reliable calculation instead of planet positions from a model's memory.

Good fit when

  • You need a natal chart or transits for a date and the agent must not guess planets and houses
  • Bazi or Zi Wei Dou Shu from a birth date: the engine computes the pillars and palaces and the agent only interprets
  • One question must be examined by several techniques at once: `horosa_hecan` merges them and shows disagreements
  • Consultation history must be stored and found by name, technique and date in a local database
  • The result must be a DOCX or PDF report with a table of contents and page numbers

Not a fit when

  • The decision concerns health, money or a person's fate: the calculation is exact, but the interpretation is traditional and has no scientific check
  • You need a public service for many clients: the streamable-http mode runs without TLS and requires a token, so it has to sit behind a reverse proxy
  • Client data may not be kept on your own computer: consultations are saved in a local SQLite database
  • You need only one Bazi calculation: a narrow server such as Bazi MCP is simpler

Example request

Cast a natal chart for 12 May 1990, 14:30, Moscow, compute Bazi for the same date separately, then compare the conclusions

MCP

Transport
stdio, http
Authentication
not required

Environment variables

HOROSA_RUNTIME_ROOT
Engine directory; on Windows it must be ASCII only.
HOROSA_MCP_TOKEN secret
Token for streamable-http mode, required when binding to 0.0.0.0.
HOROSA_JEV_API_KEY secret
Key for the optional Jev cloud layer, which is off by default.

Limitations

  • The offline engine ships only for macOS (Apple Silicon) and Windows (x64); on Linux the MCP gateway works and the engine must live on another machine.
  • The engine path must be ASCII. If a Windows user name is written in Russian or Chinese, set `HOROSA_RUNTIME_ROOT=C:\horosa`.
  • The PyPI channel is not open yet: `uvx` takes the build from a GitHub release, with the version pinned in the URL.
  • The built-in check compares facts in an interpretation with chart data (positions, pillars, spreads) and does not judge whether predictions are right.

How to disable. Remove the server from the client's configuration, with `claude mcp remove horosa` for Claude Code, and uninstall the plugin through `/plugin`. `uv run horosa-skill uninstall` removes the engine: by default it only prints the removal list, runs with `--yes`, and touches user data only with `--purge-data`.

FAQ

How do I connect Horosa Skill to Claude Code?

Through the plugin: `/plugin marketplace add Horace-Maxwell/horosa-skill`, then `/plugin install horosa@horosa-skill`. Install the engine once with `uv run --directory "<plugin folder>" horosa-skill install`; the `runtime.not_installed` error shows the exact path. Instead of the plugin, `uv run horosa-skill setup --client claude-code` also works.

Do birth dates go to the network?

Not by default: calculations and the database stay on your computer. The exception is the optional Jev cloud layer (`HOROSA_JEV`, off by default). When enabled it sends an anonymized question text in which dates, times, coordinates and place names are replaced by placeholders.

What if the tools do not show up in the client?

Run `uv run horosa-skill client check`: it reads what is actually written in the clients' configurations and points to unexpanded placeholders, moved folders and Codex timeouts. GUI clients do not inherit the shell PATH, so `client config` writes absolute paths.

How many tools does the client get?

Claude Code and clients such as Open WebUI get the full set of 125 tools. VS Code, JetBrains Junie and Agent Plugins v1 plugins get a compact set of 11.

How much space and what software does the install need?

You need `uv`, which prepares Python 3.12 or newer itself. Leave about 5 GB on the disk: the engine downloads about 730 MB and takes about 2 GB unpacked.

Discussion

No questions or reviews yet.

MCP servers

An MCP server with 15 calculation tools: BaZi, Zi Wei Dou Shu, Liu Yao, Qi Men Dun Jia, tarot, Western astrology and the Chinese almanac

MCP serverExtended access762

An MCP server that calculates Bazi charts and true solar time deterministically so the model skips calendar guesswork

MCP serverMinimal access162

An MCP server that calculates a Bazi chart from a birth date and returns the Chinese almanac, with no guessing of characters

MCP serverExtended access436

A skill for BaZi charts and related systems: true solar time, compatibility, date selection and a report citing the classics

SkillMinimal access75

A Chinese destiny-chart skill: scripts compute Bazi and Zi Wei Dou Shu charts and the agent reads them with a fixed method.

SkillMinimal access67

An MCP server with 34 tools: prayer times for any point on Earth, the Hijri calendar, adhkar, zakat and inheritance calculation

MCP serverMinimal access383

README in short

The README starts with the main features and a quick start through `uv`, then gives a table of 25 client integrations and an overview of techniques. Next come the answer format, the data check before a calculation, a trust system with a basis card, a knowledge base and a fact check, the local database and reports. It closes with installation, quality and documentation.

README badge

Report a problem