@openephemeris/mcp-server 4.14.1 → 4.14.3

package/CHANGELOG.md

@@ -7,6 +7,47 @@ Version numbering follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [4.14.3] — 2026-09-02
+
+### Fixed
+- **`ephemeris_transits` silently dropped requested `asc`/`mc`/`dsc`/`ic` natal points.** The tool
+  matched `natal_points` against `/ephemeris/natal-chart`'s angle field names
+  (`ascendant`/`midheaven`/`descendant`/`imum_coeli`), which never matched the short forms the
+  tool itself documents — so a search for transits to the Ascendant silently returned zero hits,
+  with `success: true` and no indication anything was dropped. Added alias resolution both ways,
+  plus an `unresolved_points` field so a genuine mismatch surfaces instead of hiding.
+- **`ephemeris_progressed_chart` hardcoded `subject.name` to `"Progressed Subject"`** on both the
+  natal and progressed blocks of the response, so no consumer could tell them apart by name. Now
+  an optional `name` argument, defaulting to a neutral label.
+
+### Added
+- `/ephemeris/progressed` responses now include `metadata.angle_method`
+  (`chart_for_progressed_moment` or `solar_arc_directed`), naming which algorithm produced the
+  progressed angles — previously undeclared and silently implied by
+  `progression_options.method`, which only ever described planetary progression.
+
+---
+
+## [4.14.2] — 2026-09-01
+
+### Fixed
+- **Two `CREDIT COST` figures baked into live tool descriptions were wrong** —
+  not just stale plugin docs, the actual strings Claude reads before deciding
+  to call a tool. `ephemeris_transits` claimed 6 credits (the real cost, per
+  the `/predictive/` billing tier, is 5); `acg_hits` claimed 15 (it falls to
+  the generic `/acg/` tier, which is 10 — the 15/20 figures belong to the
+  heatmap and relational-parans routes only). Verified directly against
+  `usage_meter.go` rather than the description strings themselves, since
+  those turned out to be the thing that was wrong.
+
+### Changed
+- Plugin marketing copy no longer leads with "sub-arcsecond" or "JPL DE440"
+  — reframed around the more concrete fact that this runs on NASA
+  mission-grade planetary data. The technical terms stay as backup detail
+  for readers who want them, not the opening line.
+
+---
+
 ## [4.14.1] — 2026-09-01
 
 ### Fixed

package/dist/tools/specialized/acg.js

@@ -109,7 +109,7 @@ registerTool({
         "✅  USE THIS TOOL FOR: 'Is [city] good for me?', 'What planets affect me in Tokyo?', " +
         "'What ACG lines run through Paris for my chart?', 'Which cities are under my Jupiter line?'\n" +
         "❌  NOT FOR: Full global map geometry → use acg_power_lines for that instead.\n\n" +
-        "CREDIT COST: 15 credits per call.\n\n" +
+        "CREDIT COST: 10 credits per call.\n\n" +
         "EXAMPLE: All ACG lines within 3° of Paris for a chart born 1990-04-15 in Chicago:\n" +
         "  birth_datetime='1990-04-15T14:30:00', timezone='America/Chicago',\n" +
         "  birth_latitude=41.8781, birth_longitude=-87.6298,\n" +

package/dist/tools/specialized/progressed.js

@@ -36,6 +36,10 @@ registerTool({
                 enum: ["secondary", "solar_arc", "tertiary"],
                 description: "Progression method. Defaults to 'secondary' (1 day = 1 year).",
             },
+            name: {
+                type: "string",
+                description: "Optional label for the subject, echoed back in both natal_subject and progressed_subject. Defaults to a generic label if omitted.",
+            },
             include_aspects: {
                 type: "boolean",
                 description: "Whether to include aspect grid in the response. Default false.",
@@ -67,7 +71,10 @@ registerTool({
         assertZonedDatetime("target_datetime", args.target_datetime);
         const body = {
             subject: {
-                name: "Progressed Subject",
+                // Echoed verbatim into both natal_subject.name and progressed_subject.name
+                // by the API (same person, two instants) — never a role-specific label
+                // like "Progressed Subject", which would be wrong on the natal block.
+                name: args.name || "Subject",
                 birth_datetime: { iso: args.birth_datetime },
                 birth_location: {
                     latitude: { decimal: args.birth_latitude },

package/dist/tools/specialized/transits.js

@@ -17,7 +17,7 @@ registerTool({
         "  Example: Outer planets to natal Sun/Moon → transiting_planets=['saturn','uranus','neptune','pluto'], natal_points=['sun','moon']\n\n" +
         "DEFAULT natal_points (when omitted): sun, moon, mercury, venus, mars, jupiter, saturn.\n" +
         "SEARCH RANGE LIMITS: Explorer/PayG tier → 1 year max; Pro → 5 years; Startup → 10 years.\n" +
-        "CREDIT COST: 6 credits per call.",
+        "CREDIT COST: 5 credits per call.",
     inputSchema: {
         type: "object",
         properties: {
@@ -96,6 +96,7 @@ registerTool({
         const wantedPoints = args.natal_points
             ? new Set(args.natal_points.map((p) => p.toLowerCase()))
             : CORE_BODIES_DEFAULT;
+        const resolvedPoints = new Set();
         for (const planet of planetArray) {
             const name = (planet.name || planet.id || "").toLowerCase();
             const lon = planet.longitude ?? planet.ecliptic_longitude ?? planet.lon;
@@ -105,26 +106,54 @@ registerTool({
                 continue;
             targetDegrees.push(Math.round(lon * 100) / 100);
             natalPositionMap[name] = lon;
+            resolvedPoints.add(name);
         }
-        // Extract angles (ASC, MC) only when explicitly requested
+        // Extract angles (ASC, MC, DSC, IC) only when explicitly requested.
+        // /ephemeris/natal-chart names these "ascendant", "midheaven", "descendant",
+        // "imum_coeli" — but the short forms below are what this tool documents and
+        // what natal_points is usually given as, so map both directions or a caller
+        // asking for "asc" silently gets nothing back (no error, no natal_positions
+        // entry) even though the point exists in the natal chart.
         if (args.natal_points) {
+            const ANGLE_ALIASES = {
+                ascendant: "asc",
+                asc: "ascendant",
+                midheaven: "mc",
+                mc: "midheaven",
+                descendant: "dsc",
+                dsc: "descendant",
+                desc: "descendant",
+                imum_coeli: "ic",
+                ic: "imum_coeli",
+            };
             const angles = natalResult?.angles || natalResult?.data?.angles;
             if (angles) {
                 const angleEntries = Array.isArray(angles)
                     ? angles
                     : Object.entries(angles).map(([k, v]) => ({ name: k, ...(typeof v === "object" ? v : { longitude: v }) }));
                 for (const angle of angleEntries) {
-                    const name = (angle.name || angle.id || "").toLowerCase();
+                    const apiName = (angle.name || angle.id || "").toLowerCase();
                     const lon = angle.longitude ?? angle.ecliptic_longitude ?? angle.lon;
                     if (typeof lon !== "number" || !isFinite(lon))
                         continue;
-                    if (!wantedPoints.has(name))
+                    const matchedAs = wantedPoints.has(apiName)
+                        ? apiName
+                        : (ANGLE_ALIASES[apiName] && wantedPoints.has(ANGLE_ALIASES[apiName]))
+                            ? ANGLE_ALIASES[apiName]
+                            : null;
+                    if (!matchedAs)
                         continue;
                     targetDegrees.push(Math.round(lon * 100) / 100);
-                    natalPositionMap[name] = lon;
+                    natalPositionMap[matchedAs] = lon;
+                    resolvedPoints.add(matchedAs);
                 }
             }
         }
+        // Any requested point that never turned up in natal-chart planets or angles —
+        // surface it instead of silently returning fewer targets than asked for.
+        const unresolvedPoints = args.natal_points
+            ? args.natal_points.filter((p) => !resolvedPoints.has(p.toLowerCase()))
+            : [];
         // Hard cap: never send more than 12 target degrees
         const MAX_TARGETS = 12;
         if (targetDegrees.length > MAX_TARGETS) {
@@ -162,6 +191,7 @@ registerTool({
         // Return combined context so the LLM knows what natal positions were targeted
         return {
             natal_positions: natalPositionMap,
+            ...(unresolvedPoints.length > 0 ? { unresolved_points: unresolvedPoints } : {}),
             target_degrees_used: effectiveTargets,
             aspect_angle: args.aspect_angle ?? 0,
             transit_results: transitResult,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openephemeris/mcp-server",
-  "version": "4.14.1",
+  "version": "4.14.3",
   "description": "Model Context Protocol server for the Open Ephemeris astronomical computation API",
   "type": "module",
   "main": "dist/index.js",