README.md

# Astro Jyotish

Astro Jyotish connects a Hidden World account to Jyotish services by professional astrologer Volodymyr Kraine with 20+ years of experience. The package supports Codex, ChatGPT, and Claude through a production HTTPS MCP server and Hidden World OAuth.

User commands:

- `/astro-help`
- `/astro-login`
- `/astro-status`
- `/astro-chart-images`
- `/astro-services`
- `/astro-chart-setup`
- `/astro-create-chart`
- `/astro-charts`
- `/astro-set-active-chart`
- `/astro-contact`
- `/astro-natal`
- `/astro-pdf`
- `/astro-forecast`
- `/astro-prashna`
- `/astro-panchanga`
- `/astro-lunar-calendar`
- `/astro-sade-sati`
- `/astro-question`
- `/astro-referral`

User-facing help follows the current chat language when requested. Paid service output language and astrologer mode remain explicit choices. Public destinations are rendered as clickable Markdown links.

The plugin uses a remote HTTPS MCP server and Hidden World OAuth. Passwords, identity tokens, authorization codes, and internal request identifiers are never copied through chat.

`/astro-login` checks the installed plugin connection. If authorization is needed, Codex or ChatGPT opens its own Hidden World OAuth flow; otherwise the user can connect Astro Jyotish in the host's Plugins settings. The plugin does not invoke a separate local MCP login.

In Claude, install the plugin from the `hidden-world` marketplace (`.claude-plugin/marketplace.json` at the repository root). Claude runs the Hidden World OAuth flow for the MCP server itself: in Claude Code use `/mcp` → `astro-jyotish` → Authenticate; in the Claude desktop app or claude.ai press Connect. The Codex manifest stays in `.codex-plugin/plugin.json`, the Claude manifest in `.claude-plugin/plugin.json`.

Runtime tools and routing are private implementation details. User-facing operation is through the `/astro-*` commands above. Service mode names are Parashara and Kraine; do not describe them as standard or premium tiers.

Users may also start workflows in natural language, for example: "Connect my Hidden World account", "Show my Astro Jyotish status", "Show my active chart images", "Create and save a new chart for <birth date> at <birth time>, <city>, <country>, and name it <chart name>", "List my saved charts", "Make the saved chart named <chart name> active", "Make Kraine Panchanga in Russian for today", "Create a Kraine forecast in Russian for 2026-09-01", "Create a Kraine Prashna question chart in Russian for this situation: <question>", or "Ask Kraine AI about my active natal chart in Russian: <question about my chart>".

Chart creation is exposed through `/astro-create-chart`. The plugin calculates, saves, and activates the chart in the connected Hidden World account.

`/astro-lunar-calendar` returns the website's public Kyiv calendar data directly in chat without stars or subscription requests. The bare command shows the full current month, its key dates, favorable and unfavorable days, best days by activity, today's detail, and help for other views. `/astro-sade-sati` uses the website calculation model: one free calculation per connected account without a subscription, then access through an active subscription. Neither service spends stars or subscription requests.

`/astro-pdf` uses the website's complete natal PDF pipeline for the active chart. It requires a verified email and an explicitly confirmed star price. Subscription requests are not used. Orders are asynchronous; the plugin exposes status, short-lived download links, and an explicitly confirmed resend to the verified email.

The plugin may use stars, trial access, or subscription requests already available in the connected account. It does not sell subscriptions, credits, or digital services and does not initiate checkout. Before a service consumes an existing entitlement, the user sees the server-provided cost and confirms the exact request.

Support: [Hidden World contacts](https://hidden-world.space/en/contacts)

Version 1.1.0 adds inviter-email referral status and explicitly confirmed claims, not referral links. Rules, bonuses, and limits are server-owned. New capabilities require the matching server deployment and tool scan; this source package alone does not make them available.

Version 1.2.0 adds the free public lunar calendar data and one free Sade Sati calculation per account without a subscription. The same-account trial is stored by the MCP server; an active subscription continues to include Sade Sati.

Parashara presents technical factors and traditional meanings for self-interpretation. Kraine presents holistic relationships and synthesis by professional astrologer Volodymyr Kraine with 20+ years of experience. Help explains both modes in English, Russian, and Ukrainian.

Accepted services and same-request results show the server's fresh stars and subscription quota when available. Missing balance data never triggers another paid call. Insufficient stars are explained as lack of stars, not a service outage; referral claim errors are explained without automatic retries.

Privacy: [Privacy Policy](https://hidden-world.space/en/policy)

Terms: [Terms of Use](https://hidden-world.space/en/terms)