Horosa Skill — Claude Code MCP server: what it does, install
A local MCP server for astrology and metaphysics calculations. Use it when an AI client needs offline tools, traceable results, and saved reports.
Open on GitHubWhat Horosa Skill does
Horosa Skill exposes 110 astrology and metaphysics techniques to AI clients through MCP and a JSON-first CLI. Calculations run on the local machine and work without network access. The available methods include Western astrology, progressions, horary work, date selection, and other techniques; responses use a shared envelope with a technique evidence card.
Calls are stored in SQLite and JSON artifacts, while horosa_technique_report creates a method report. A structured clarification gate asks for details such as time, place, timezone, and other parameters before a calculation. horosa_hecan can combine several techniques and keeps agreements separate from disagreements. You need uv, Python ≥ 3.12, and about 5 GB of disk space. The offline runtime ships for macOS (arm64) and Windows (x64); on Linux, the container runs the MCP gateway and needs the runtime on a host or another machine.
What it helps with
- run an astrology calculation locally
- compare results from several techniques
- search previous calls and saved records
- export a report as DOCX, PDF, or JSON
- check chart parameters before calculating
Example prompts for the agent
- Run a local Western natal chart calculation and ask me for any parameters that need confirmation.
- Use
horosa_hecanto compare several techniques, separating agreements from disagreements. - Create a method report for the latest calculation with
horosa_technique_reportand save it as JSON.
How to install Horosa Skill
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Horosa Skill
How do I install Horosa Skill in Claude Code?
Install uv, then run git clone https://github.com/Horace-Maxwell/horosa-skill.git, cd horosa-skill/horosa-skill, uv sync, uv run horosa-skill install, uv run horosa-skill doctor, uv run horosa-skill selfcheck, and uv run horosa-skill serve.
What does Horosa Skill do?
It gives an AI client access to 110 local astrology and metaphysics techniques through MCP and a CLI. Calculations, records, and reports stay on the user’s machine.
Which systems support the offline runtime?
The released runtime payloads target macOS (arm64) and Windows (x64). A Linux container can run the MCP gateway, but the runtime must be hosted on another machine or the host.
