@openephemeris/mcp-server 3.0.1 → 3.2.0

package/README.md

@@ -7,7 +7,7 @@ Model Context Protocol server for OpenEphemeris. This package exposes typed astr
 ### One-click install (Cursor)
 
 <!-- GENERATED:CURSOR_INSTALL:BEGIN -->
-[![Install in Cursor](https://img.shields.io/badge/Install%20in-Cursor-1f6feb)](cursor://anysphere.cursor-deeplink/mcp/install?name=openephemeris&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBvcGVuZXBoZW1lcmlzL21jcC1zZXJ2ZXIiXSwiZW52Ijp7IkFTVFJPTUNQX1BST0ZJTEUiOiJkZXYiLCJBU1RST01DUF9CQUNLRU5EX1VSTCI6Imh0dHBzOi8vYXBpLm9wZW5lcGhlbWVyaXMuY29tIiwiQVNUUk9NQ1BfQVBJX0tFWSI6IllPVVJfQVBJX0tFWV9IRVJFIn19)
+[![Install in Cursor](https://img.shields.io/badge/Install%20in-Cursor-1f6feb)](cursor://anysphere.cursor-deeplink/mcp/install?name=openephemeris&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBvcGVuZXBoZW1lcmlzL21jcC1zZXJ2ZXIiXSwiZW52Ijp7Ik9QRU5FUEhFTUVSSVNfUFJPRklMRSI6ImRldiIsIk9QRU5FUEhFTUVSSVNfQkFDS0VORF9VUkwiOiJodHRwczovL2FwaS5vcGVuZXBoZW1lcmlzLmNvbSIsIk9QRU5FUEhFTUVSSVNfQVBJX0tFWSI6IllPVVJfQVBJX0tFWV9IRVJFIn19)
 
 > Replace `YOUR_API_KEY_HERE` in Cursor MCP settings with your API key from https://openephemeris.com/dashboard.
 
@@ -20,9 +20,9 @@ Cursor deeplink payload:
     "@openephemeris/mcp-server"
   ],
   "env": {
-    "ASTROMCP_PROFILE": "dev",
-    "ASTROMCP_BACKEND_URL": "https://api.openephemeris.com",
-    "ASTROMCP_API_KEY": "YOUR_API_KEY_HERE"
+    "OPENEPHEMERIS_PROFILE": "dev",
+    "OPENEPHEMERIS_BACKEND_URL": "https://api.openephemeris.com",
+    "OPENEPHEMERIS_API_KEY": "YOUR_API_KEY_HERE"
   }
 }
 ```
@@ -37,9 +37,9 @@ Cursor deeplink payload:
       "command": "npx",
       "args": ["-y", "@openephemeris/mcp-server"],
       "env": {
-        "ASTROMCP_PROFILE": "dev",
-        "ASTROMCP_BACKEND_URL": "https://api.openephemeris.com",
-        "ASTROMCP_API_KEY": "YOUR_API_KEY_HERE"
+        "OPENEPHEMERIS_PROFILE": "dev",
+        "OPENEPHEMERIS_BACKEND_URL": "https://api.openephemeris.com",
+        "OPENEPHEMERIS_API_KEY": "YOUR_API_KEY_HERE"
       }
     }
   }
@@ -48,6 +48,8 @@ Cursor deeplink payload:
 
 ### Platform guide
 
+> **Detailed setup walkthroughs** for each platform are in [SETUP.md](./SETUP.md).
+
 | Client | Install mode | Config location |
 |---|---|---|
 | Cursor | One-click deeplink or manual | `~/.cursor/mcp.json` |
@@ -112,15 +114,16 @@ This package runs as a local stdio MCP server. Remote-only clients require a hos
 
 | Variable | Required | Description |
 |---|---|---|
-| `ASTROMCP_API_KEY` | Yes (unless service key/JWT used) | API key for OpenEphemeris |
-| `ASTROMCP_BACKEND_URL` | No | Defaults to `https://api.openephemeris.com` |
-| `ASTROMCP_PROFILE` | No | `dev` by default |
-| `ASTROMCP_SERVICE_KEY` | No | Internal service auth |
-| `ASTROMCP_JWT` | No | Bearer token auth |
-| `ASTROMCP_DEV_ALLOWLIST_PATH` | No | Override allowlist file path |
+| `OPENEPHEMERIS_API_KEY` | Yes (unless service key/JWT used) | API key for OpenEphemeris |
+| `ASTROMCP_API_KEY` | No | Legacy alias for `OPENEPHEMERIS_API_KEY` (checked as fallback) |
+| `OPENEPHEMERIS_BACKEND_URL` | No | Defaults to `https://api.openephemeris.com` |
+| `OPENEPHEMERIS_PROFILE` | No | `dev` by default |
+| `OPENEPHEMERIS_SERVICE_KEY` | No | Internal service auth |
+| `OPENEPHEMERIS_JWT` | No | Bearer token auth |
+| `OPENEPHEMERIS_DEV_ALLOWLIST_PATH` | No | Override allowlist file path |
 | `MCP_USER_ID` | No | Per-instance user identifier |
 
-Legacy aliases (`MERIDIAN_*`) remain supported.
+Legacy aliases (`ASTROMCP_*`, `MERIDIAN_*`) remain supported.
 
 ## Development
 
@@ -161,24 +164,31 @@ OpenEphemeris API
 
 Generated by `npm run sync:readme` from `config/dev-allowlist.json` and the live tool registry.
 
-- Allowlisted operations: **68**
-- Methods: `GET=22`, `POST=46`, `PUT=0`, `PATCH=0`, `DELETE=0`
-- Registered tools (`ASTROMCP_PROFILE=dev`): **10**
-- Typed tools: `ephemeris.electional`, `ephemeris.moon_phase`, `ephemeris.natal_chart`, `ephemeris.next_eclipse`, `ephemeris.relocation`, `ephemeris.synastry`, `ephemeris.transits`, `human_design.chart`
+- Allowlisted operations: **97**
+- Methods: `GET=41`, `POST=56`, `PUT=0`, `PATCH=0`, `DELETE=0`
+- Registered tools (`OPENEPHEMERIS_PROFILE=dev`): **13**
+- Typed tools: `auth.login`, `auth.logout`, `auth.status`, `ephemeris.electional`, `ephemeris.moon_phase`, `ephemeris.natal_chart`, `ephemeris.next_eclipse`, `ephemeris.relocation`, `ephemeris.synastry`, `ephemeris.transits`, `human_design.chart`
 - Generic tools: `dev.call`, `dev.list_allowed`
 
 ### Allowlist Families
 
 | Family | Operations | Example |
 |---|---:|---|
-| `acg` | 5 | `POST /acg/ccg`, `GET /acg/health` |
+| `acg` | 12 | `POST /acg/aspects`, `POST /acg/ccg` |
+| `calendar` | 3 | `GET /calendar/astrology/cross-quarter`, `GET /calendar/astrology/lunar-standstill` |
 | `catalogs` | 3 | `GET /catalogs/bodies`, `GET /catalogs/fixed-stars` |
-| `comparative` | 6 | `POST /comparative/composite`, `POST /comparative/composite/midpoint` |
+| `chinese` | 2 | `POST /chinese/bazi`, `GET /chinese/zodiac` |
+| `comparative` | 5 | `POST /comparative/composite`, `POST /comparative/composite/midpoint` |
+| `eclipse` | 5 | `GET /eclipse/besselian-elements`, `GET /eclipse/lunar/global` |
 | `electional` | 5 | `GET /electional/aspect-search`, `GET /electional/find-window` |
-| `ephemeris` | 30 | `POST /ephemeris/angles-points`, `POST /ephemeris/aspect-check` |
+| `ephemeris` | 33 | `GET /ephemeris/agro/calendar`, `GET /ephemeris/agro/daily` |
 | `health` | 1 | `GET /health` |
-| `human-design` | 6 | `POST /human-design/bodygraph`, `POST /human-design/chart` |
+| `human-design` | 5 | `POST /human-design/chart`, `POST /human-design/composite` |
 | `location` | 2 | `GET /location/autocomplete`, `GET /location/reverse` |
 | `predictive` | 8 | `POST /predictive/events`, `POST /predictive/returns` |
+| `tidal` | 2 | `GET /tidal/forcing`, `GET /tidal/forcing/deep-time` |
+| `time` | 6 | `GET /time/delta-t`, `GET /time/equation-of-time` |
 | `timezone` | 2 | `POST /timezone/lookup`, `POST /timezone/offset` |
+| `vedic` | 1 | `POST /vedic/chart` |
+| `visualization` | 2 | `POST /visualization/bi-wheel`, `POST /visualization/chart-wheel` |
 <!-- GENERATED:RUNTIME_SNAPSHOT:END -->