# Horosa Skill

A local MCP server for astrology and metaphysics calculations. Use it when an AI client needs offline tools, traceable results, and saved reports.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 477
- Author: Horace-Maxwell
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Horace-Maxwell/horosa-skill
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/horosa-skill

## What it 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.

## Requirements
- Environment variables: `HOROSA_RUNTIME_ROOT`, `HOROSA_SKILL_DATA_DIR`, `HOROSA_JEV`, `HOROSA_JEV_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- 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
- Run a local Western natal chart calculation and ask me for any parameters that need confirmation.
- Use `horosa_hecan` to compare several techniques, separating agreements from disagreements.
- Create a method report for the latest calculation with `horosa_technique_report` and save it as JSON.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md