@openephemeris/mcp-server 3.1.0 → 3.2.2

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,20 @@ 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.
+
+## Legal
+
+This package is licensed under the [MIT License](./LICENSE). However, use of this package to access the OpenEphemeris API constitutes use of the Service and is governed by the [OpenEphemeris Terms of Service](https://openephemeris.com/terms). By using this package, you agree to those terms. See also the [Privacy Policy](https://openephemeris.com/privacy) and [Acceptable Use Policy](https://openephemeris.com/acceptable-use).
 
 ## Development
 
@@ -136,6 +143,15 @@ npm run check:readme
 npm run verify:release
 ```
 
+### Deploying the SSE Server to Fly.io
+
+When you update the MCP server logic (handlers, bug fixes, hardening), you should deploy it so clients connecting via our remote `https://mcp.openephemeris.com/sse` endpoint get the updates immediately.
+
+1. Navigate to `apps/api/mcp-server`
+2. Run `fly deploy --remote-only`
+
+*Note on NPM:* Deploying to Fly.io instantly updates the web-accessible SSE tool. However, users installing your tool locally in Cursor/Desktop via `npx @openephemeris/mcp-server` will *only* receive the updates once a new version is published to NPM. If your changes are critical, you should bump the version in `package.json` and run `npm publish` (or your CI release pipeline) *after* deploying to Fly.
+
 `npm run verify:release` is the release gate. It checks:
 - allowlist freshness against OpenAPI
 - schema pack freshness
@@ -161,25 +177,38 @@ OpenEphemeris API
 
 Generated by `npm run sync:readme` from `config/dev-allowlist.json` and the live tool registry.
 
-- Allowlisted operations: **67**
-- Methods: `GET=22`, `POST=45`, `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`
-- Generic tools: `dev.call`, `dev.list_allowed`
+- 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`, `dev_call`, `dev_list_allowed`, `ephemeris_electional`, `ephemeris_moon_phase`, `ephemeris_natal_chart`, `ephemeris_next_eclipse`, `ephemeris_relocation`, `ephemeris_synastry`, `ephemeris_transits`, `human_design_chart`
+- Generic tools: 
 
 ### Allowlist Families
 
 | Family | Operations | Example |
 |---|---:|---|
-| `acg` | 4 | `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` |
+| `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` | 29 | `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 -->
+
+
+NPM publish
+
+publish from /c/src/openephemeris/apps/api/mcp-server
+npm login
+npm publish