@openephemeris/mcp-server 4.7.0 → 4.8.0

package/CHANGELOG.md

@@ -7,6 +7,37 @@ Version numbering follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [4.8.0] — 2026-08-02
+
+### Added
+- **Toolsets by tradition.** Tool definitions are re-sent to the model on every
+  message, so callers who work in one tradition can now advertise just that
+  tradition instead of the general-purpose default: `OPENEPHEMERIS_TOOLS=hd`
+  (stdio) or `?profile=hd,bazi` (hosted). Eight toolsets — `astrology`, `moon`,
+  `hd`, `bazi`, `vedic`, `acg`, `electional`, `venus` — each including
+  geocoding, account usage, and the API escape hatch. A Human Design session
+  drops from ~19,100 to ~7,800 advertised tokens (−59%); Vedic to ~3,400
+  (−82%). `astrology,moon` matches the default's tool count at ~1,700 fewer
+  tokens while covering the long tail (dignities, midpoints, hermetic lots,
+  fixed stars, composites) the curated set omits. As with `core`/`full`, this
+  filters `tools/list` only — every tool stays callable by name. Also exposed
+  as the `toolSurface` option in the Smithery config.
+
+### Fixed
+- `explore_human_design` now states its real credit cost: 4 where the bodygraph
+  renders (2 chart + 2 visual), 2 in text-only hosts — it previously claimed a
+  flat 2. `ephemeris_moon_phase` (2, not 1) and `ephemeris_next_lunar_phase`
+  (1–2 per occurrence) corrected the same way.
+- `explore_bi_wheel` in synastry mode now requires Person 2's coordinates (or a
+  resolvable `person2_location`) instead of silently casting Person 2's chart
+  for 0°N 0°E.
+- Chart-wheel widget escapes birth parameters before rendering them into the
+  info chips.
+- OAuth token endpoint binds authorization codes to their `redirect_uri` and
+  `client_id`; both checks were previously skippable by omitting the parameter.
+
+---
+
 ## [4.7.0] — 2026-08-02
 
 Historically correct birth-time conversion. IANA timezone databases — including

package/README.md

@@ -358,6 +358,38 @@ On the remote HTTP server, append `?profile=full` to the connector URL (or send
 https://mcp.openephemeris.com/mcp?profile=full
 ```
 
+### Toolsets by tradition
+
+If you work in one tradition, ask for it by name instead of taking the general-purpose default. You get that tradition in full — including the long-tail tools the core set leaves out — for a fraction of the context.
+
+```bash
+OPENEPHEMERIS_TOOLS=hd npx -y @openephemeris/mcp-server        # Human Design
+OPENEPHEMERIS_TOOLS=astrology,moon npx -y @openephemeris/mcp-server
+```
+
+```
+https://mcp.openephemeris.com/mcp?profile=hd,bazi
+```
+
+| Toolset | What it covers | Tools | Approx. tokens |
+|---|---|---:|---:|
+| `astrology` | Natal, transits, synastry, progressions, returns, relocation, dignities, midpoints, lots, fixed stars, composites | 32 | 15,800 |
+| `hd` | Human Design charts, transits, connection charts, penta, bodygraph | 14 | 7,800 |
+| `bazi` | Four Pillars, Ten Gods, element balance, luck pillars, compatibility | 13 | 7,200 |
+| `electional` | Timing windows, angle crossings, stations, moment analysis | 10 | 4,600 |
+| `moon` | Phases, void-of-course, eclipses | 9 | 4,100 |
+| `venus` | Star points, phases, elongations, stations | 11 | 3,700 |
+| `acg` | Astrocartography lines and hits | 7 | 3,700 |
+| `vedic` | Jyotish Rashi chart | 7 | 3,400 |
+| — | *core (default)* | 36 | 19,100 |
+| — | *full* | 70 | 34,600 |
+
+Every selection also includes geocoding (`location_search`, `timezone_resolve`), `account_usage`, and the allowlist-gated proxy — so a birthplace is always resolvable and nothing is stranded.
+
+Combine with commas; unknown names are ignored rather than rejected, so a typo degrades to a smaller surface instead of a dead connector. As with `core`/`full`, this only filters `tools/list` — every tool remains callable by name.
+
+Why it matters: tool definitions are re-sent to the model on **every** pass. `astrology,moon` advertises the same number of tools as the default but costs ~1,700 fewer tokens per message and covers more of the tradition.
+
 The surface is fixed when the session initializes — this server does not advertise `tools.listChanged`, so switching requires reconnecting. `dev_list_allowed` enumerates every operation reachable through the generic proxy regardless of surface.
 
 ## Contributing & Support
@@ -443,8 +475,8 @@ Generated by `npm run sync:readme` from `config/dev-allowlist.json` and the live
 - Allowlisted operations: **31**
 - Methods: `GET=5`, `POST=26`, `PUT=0`, `PATCH=0`, `DELETE=0`
 - Registered tools (`OPENEPHEMERIS_PROFILE=dev`): **92**
-- Typed tools: `account_usage`, `acg_hits`, `acg_power_lines`, `auth_login`, `auth_logout`, `auth_status`, `bazi_annual_pillar`, `bazi_chart`, `bazi_compatibility`, `bazi_element_balance`, `bazi_luck_pillars`, `bazi_recalculate`, `bazi_ten_gods`, `bi_wheel_on_cross_aspect_click`, `bi_wheel_on_house_click`, `bi_wheel_on_planet_click`, `bi_wheel_recalculate`, `bi_wheel_synopsis`, `bodygraph_recalculate`, `chart_wheel_on_aspect_click`, `chart_wheel_on_house_click`, `chart_wheel_on_planet_click`, `chart_wheel_recalculate`, `chinese_bazi`, `dev_list_allowed`, `dev_read_api`, `dev_write_api`, `electional_angle_crossings`, `electional_aspect_search`, `electional_moment_analysis`, `electional_station_tracker`, `ephemeris_angles_points`, `ephemeris_aspect_check`, `ephemeris_bi_wheel`, `ephemeris_chart_wheel`, `ephemeris_composite`, `ephemeris_composite_midpoint`, `ephemeris_dignities`, `ephemeris_electional`, `ephemeris_fixed_stars`, `ephemeris_hermetic_lots`, `ephemeris_house_cusps`, `ephemeris_lunar_return`, `ephemeris_midpoints`, `ephemeris_moon_phase`, `ephemeris_natal_batch`, `ephemeris_natal_chart`, `ephemeris_natal_transits`, `ephemeris_next_eclipse`, `ephemeris_next_lunar_phase`, `ephemeris_overlay`, `ephemeris_planet_position`, `ephemeris_planetary_return`, `ephemeris_progressed_chart`, `ephemeris_relocation`, `ephemeris_retrograde_status`, `ephemeris_solar_return`, `ephemeris_synastry`, `ephemeris_transits`, `explore_bazi_chart`, `explore_bi_wheel`, `explore_human_design`, `explore_human_design_connection`, `explore_human_design_transit`, `explore_moon_phase`, `explore_natal_chart`, `explore_transit_timeline`, `explore_vedic_chart`, `hd_on_center_click`, `hd_on_channel_click`, `hd_on_connection_channel_click`, `hd_on_gate_click`, `hd_on_planet_click`, `hd_on_transit_channel_click`, `hd_on_variable_click`, `hd_opposition`, `hd_planetary_return`, `human_design_bodygraph`, `human_design_chart`, `human_design_composite`, `human_design_penta`, `location_search`, `moon_phase_recalculate`, `timezone_resolve`, `vedic_chart`, `vedic_chart_recalculate`, `venus_eight_year_star`, `venus_elongations`, `venus_phase`, `venus_star_points`, `venus_star_points_conjunctions`, `venus_stations`
-- Generic tools: 
+- Typed tools: `account_usage`, `acg_hits`, `acg_power_lines`, `auth_login`, `auth_logout`, `auth_status`, `bazi_annual_pillar`, `bazi_chart`, `bazi_compatibility`, `bazi_element_balance`, `bazi_luck_pillars`, `bazi_recalculate`, `bazi_ten_gods`, `bi_wheel_on_cross_aspect_click`, `bi_wheel_on_house_click`, `bi_wheel_on_planet_click`, `bi_wheel_recalculate`, `bi_wheel_synopsis`, `bodygraph_recalculate`, `chart_wheel_on_aspect_click`, `chart_wheel_on_house_click`, `chart_wheel_on_planet_click`, `chart_wheel_recalculate`, `chinese_bazi`, `electional_angle_crossings`, `electional_aspect_search`, `electional_moment_analysis`, `electional_station_tracker`, `ephemeris_angles_points`, `ephemeris_aspect_check`, `ephemeris_bi_wheel`, `ephemeris_chart_wheel`, `ephemeris_composite`, `ephemeris_composite_midpoint`, `ephemeris_dignities`, `ephemeris_electional`, `ephemeris_fixed_stars`, `ephemeris_hermetic_lots`, `ephemeris_house_cusps`, `ephemeris_lunar_return`, `ephemeris_midpoints`, `ephemeris_moon_phase`, `ephemeris_natal_batch`, `ephemeris_natal_chart`, `ephemeris_natal_transits`, `ephemeris_next_eclipse`, `ephemeris_next_lunar_phase`, `ephemeris_overlay`, `ephemeris_planet_position`, `ephemeris_planetary_return`, `ephemeris_progressed_chart`, `ephemeris_relocation`, `ephemeris_retrograde_status`, `ephemeris_solar_return`, `ephemeris_synastry`, `ephemeris_transits`, `explore_bazi_chart`, `explore_bi_wheel`, `explore_human_design`, `explore_human_design_connection`, `explore_human_design_transit`, `explore_moon_phase`, `explore_natal_chart`, `explore_transit_timeline`, `explore_vedic_chart`, `hd_on_center_click`, `hd_on_channel_click`, `hd_on_connection_channel_click`, `hd_on_gate_click`, `hd_on_planet_click`, `hd_on_transit_channel_click`, `hd_on_variable_click`, `hd_opposition`, `hd_planetary_return`, `human_design_bodygraph`, `human_design_chart`, `human_design_composite`, `human_design_penta`, `location_search`, `moon_phase_recalculate`, `timezone_resolve`, `vedic_chart`, `vedic_chart_recalculate`, `venus_eight_year_star`, `venus_elongations`, `venus_phase`, `venus_star_points`, `venus_star_points_conjunctions`, `venus_stations`
+- Generic tools: `dev_list_allowed`, `dev_read_api`, `dev_write_api`
 
 ### Allowlist Families
 
@@ -466,5 +498,5 @@ Most LLMs (like Claude and ChatGPT) struggle heavily with astronomical calculati
 
 By pairing LLMs with the OpenEphemeris MCP server, your agents can instantly access:
 - **Zero-hallucination coordinates**: Direct, sub-arcsecond NASA JPL DE440 calculations spanning 1,100 years of astronomical data.
-- **LLM-optimized tokens (`format=llm`)**: We compress standard 25,000 token JSON chart responses into minimal text blocks, cutting your inference costs by 50%.
+- **LLM-optimized tokens (`format=llm`)**: We compress standard 25,000 token JSON chart responses into minimal text blocks, cutting your inference costs by 50–73% depending on endpoint.
 - **Ready-to-use astrology layers**: Built-in support for Astrocartography geoJSON lines, Hermetic Lots, Fixed Stars, and complex Human Design matrix generation.

package/dist/index.js

@@ -73,9 +73,12 @@ const server = new Server({
         "See the 'welcome_to_open_ephemeris' prompt for orientation.\n\n" +
         DATETIME_CONTRACT_INSTRUCTIONS,
 });
-// Which slice of the registry this process advertises. Tools outside the core
+// Which slice of the registry this process advertises. Tools outside the
 // surface stay callable by name — this only controls what tools/list returns.
-// Set OPENEPHEMERIS_TOOLS=full to advertise everything.
+//   OPENEPHEMERIS_TOOLS=full      advertise everything
+//   OPENEPHEMERIS_TOOLS=hd,bazi   advertise those traditions (+ geocoding,
+//                                 account and the escape hatch)
+//   unset                          the curated core set
 const STDIO_SURFACE = parseToolSurface(process.env.OPENEPHEMERIS_TOOLS);
 /**
  * Stable pseudonymous id for this install. Derived from the configured

package/dist/oauth/token.js

@@ -106,11 +106,38 @@ async function handleAuthorizationCode(req, res, store) {
         });
         return;
     }
-    // Verify redirect_uri exact match
-    if (redirect_uri && !timingSafeStringEqual(redirect_uri, stored.redirect_uri)) {
+    // Verify redirect_uri exact match.
+    //
+    // This used to read `if (redirect_uri && ...)`, so a client that simply omitted
+    // the parameter skipped the check entirely. RFC 6749 §4.1.3 requires the value
+    // to be present AND identical whenever the authorization request carried one,
+    // precisely so a dropped parameter cannot be the bypass. PKCE still gates the
+    // exchange, but that is the last line, not the only one.
+    if (stored.redirect_uri) {
+        if (!redirect_uri) {
+            res.status(400).json({
+                error: "invalid_request",
+                error_description: "Missing redirect_uri. It is required because the authorization request included one.",
+            });
+            return;
+        }
+        if (!timingSafeStringEqual(redirect_uri, stored.redirect_uri)) {
+            res.status(400).json({
+                error: "invalid_grant",
+                error_description: "redirect_uri does not match the value used during authorization.",
+            });
+            return;
+        }
+    }
+    // Bind the code to the client it was issued to. `client_id` was read off the
+    // request but never compared, so any client holding the verifier could redeem
+    // another client's code. DCR client_ids are deterministic and non-secret
+    // (see oauth/dcr.ts), which makes this binding the only thing distinguishing
+    // one registered client from another.
+    if (stored.client_id && client_id && !timingSafeStringEqual(client_id, stored.client_id)) {
         res.status(400).json({
             error: "invalid_grant",
-            error_description: "redirect_uri does not match the value used during authorization.",
+            error_description: "client_id does not match the client the authorization code was issued to.",
         });
         return;
     }

package/dist/server-sse.js

@@ -23,7 +23,7 @@ import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/
 import { InMemoryEventStore } from "./event-store.js";
 import { captureEvent, distinctIdFor } from "./analytics.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, isInitializeRequest, } from "@modelcontextprotocol/sdk/types.js";
-import { initTools, toolRegistry, formatToolResponse, formatToolError, modelVisibleTools, parseToolSurface } from "./tools/index.js";
+import { initTools, toolRegistry, formatToolResponse, formatToolError, modelVisibleTools, parseToolSurface, describeSurface } from "./tools/index.js";
 import { DATETIME_CONTRACT_INSTRUCTIONS } from "./tools/datetime.js";
 import { BackendClient, runWithClient } from "./backend/client.js";
 import { CHART_WHEEL_RESOURCE_URI, CHART_WHEEL_MIME_TYPE, getChartWheelBundle, } from "./tools/apps/chart-wheel-app.js";
@@ -215,7 +215,10 @@ function transportProps(server, surface) {
     const info = server.getClientVersion();
     return {
         transport: "http",
-        surface,
+        // describeSurface, not the raw value: a toolset selection is an object and
+        // would land in PostHog as "[object Object]", making the property useless
+        // for exactly the question it exists to answer — which surfaces get used.
+        surface: describeSurface(surface),
         client_name: info?.name ?? "unknown",
         client_version: info?.version ?? "unknown",
         server_version: version,
@@ -848,6 +851,8 @@ export async function createSseApp() {
         // `tools.listChanged`, so a host has no obligation to re-fetch the list.
         // Opt into the full surface with `?profile=full` on the connector URL, or
         // an `X-OE-Tool-Surface: full` header where the host allows custom headers.
+        // A comma list of traditions works the same way — `?profile=hd,bazi` —
+        // and advertises just those plus geocoding, account and the escape hatch.
         const surface = parseToolSurface(req.query.profile ?? req.headers["x-oe-tool-surface"]);
         const server = createMcpServer(analyticsId, surface);
         // Fire session_init after the handshake so getClientVersion() is populated

package/dist/tools/apps/bazi-app.js

@@ -115,9 +115,9 @@ registerTool({
         "(Year = ancestry/early life, Month = parents/career, Day = self/spouse, Hour = children/later life).\n\n" +
         "CREDIT COST: 3 credits per call (1 base + 2 visual render).\n\n" +
         "Use this for a rich, interactive BaZi experience in MCP Apps-capable hosts (Claude Desktop). " +
-        "Falls back to a text summary in other hosts. For non-visual data lookups, use chinese_bazi " +
-        "instead; deeper derivations (Ten Gods, element balance, luck pillars) have dedicated tools " +
-        "on the full tool surface (`?profile=full`).",
+        "Falls back to a text summary in other hosts, so it is also the right call without a " +
+        "renderer. Deeper derivations (Ten Gods, element balance, luck pillars) and a plain " +
+        "non-visual pillars lookup have dedicated tools on the full surface (`?profile=full`).",
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/apps/bi-wheel-app.js

@@ -104,13 +104,21 @@ const HOUSE_SYSTEM_MAP = {
     campanus: "C", regiomontanus: "R",
 };
 function buildNatalBody(datetime, lat, lon, timezone, houseSystem = "placidus") {
+    // A natal chart with no birthplace is never meaningful — houses and angles are
+    // derived entirely from it. This used to read `lat ?? 0`, which cast the chart
+    // for 0°N 0°E and returned it as though nothing were wrong. Callers that can
+    // legitimately omit coords resolve them first (see coordsFromArgsOrLocation) or
+    // fall back to Person 1's; anything reaching here without them is a bug.
+    if (lat == null || lon == null) {
+        throw new Error("Internal: buildNatalBody requires latitude and longitude — refusing to cast a chart for 0°N 0°E.");
+    }
     const body = {
         subject: {
             name: "MCP Request",
             birth_datetime: { iso: datetime },
             birth_location: {
-                latitude: { decimal: lat ?? 0 },
-                longitude: { decimal: lon ?? 0 },
+                latitude: { decimal: lat },
+                longitude: { decimal: lon },
             },
         },
         configuration: {
@@ -413,16 +421,15 @@ registerTool({
         "CREDIT COST: 2 credits per call for most modes (1 per wheel computed); " +
         "solar_return/lunar_return modes cost 6 (5 for the return + 1 for the natal wheel).\n\n" +
         "The inner wheel is always Person 1's natal chart. The outer ring depends on mode:\n" +
-        "• synastry     — Person 2's natal chart (two-person compatibility). 1 credit.\n" +
-        "• transit      — Transiting planets for a given date. 1 credit.\n" +
-        "• progressed   — Secondary progressed positions (person2_datetime = target date). 1 credit.\n" +
-        "• solar_return — Nearest solar return chart (person2_datetime = year to return for). 5 credits.\n" +
-        "• lunar_return — Nearest lunar return chart (person2_datetime = target month). 5 credits.\n" +
-        "• solar_arc    — Solar arc directed positions (person2_datetime = target date). 1 credit.\n" +
-        "Cross-aspects between both wheels are computed and displayed as coloured dashed lines. " +
-        "Click any planet, aspect line, or house cusp for interpretation. " +
-        "Prefer this whenever the user should SEE the comparison — it renders interactively in " +
-        "MCP Apps-capable hosts (Claude Desktop) and falls back to static SVG in other hosts. " +
+        "• synastry     — Person 2's natal chart (needs Person 2's own birthplace).\n" +
+        "• transit      — Transiting planets for a given date.\n" +
+        "• progressed   — Secondary progressed positions (person2_datetime = target date).\n" +
+        "• solar_return — Nearest solar return chart (person2_datetime = year to return for).\n" +
+        "• lunar_return — Nearest lunar return chart (person2_datetime = target month).\n" +
+        "• solar_arc    — Solar arc directed positions (person2_datetime = target date).\n" +
+        "Cross-aspects are drawn as coloured dashed lines; click any planet, aspect line, or " +
+        "house cusp for interpretation. Prefer this whenever the user should SEE the comparison " +
+        "— it renders interactively in MCP Apps hosts and falls back to static SVG elsewhere. " +
         "For raw synastry data without a visual, use ephemeris_synastry.",
     inputSchema: {
         type: "object",
@@ -444,8 +451,8 @@ registerTool({
                     "synastry = Person 2 birth datetime; transit/progressed/solar_arc = target date; " +
                     "solar_return/lunar_return = any date within the target year/month. " + DATETIME_DESC,
             },
-            person2_latitude: { type: "number", description: "Birth latitude for Person 2 (synastry) or return/transit location. Defaults to Person 1 coords for single-person modes." },
-            person2_longitude: { type: "number", description: "Birth longitude for Person 2 (synastry) or return/transit location. Defaults to Person 1 coords for single-person modes." },
+            person2_latitude: { type: "number", description: "Birth latitude for Person 2. REQUIRED in synastry unless `person2_location` is given — never inferred from Person 1. Other modes default to Person 1's coords." },
+            person2_longitude: { type: "number", description: "Birth longitude for Person 2. REQUIRED in synastry unless `person2_location` is given. Other modes default to Person 1's coords." },
             person2_timezone: timezoneProperty("Person 2 / the outer chart", "America/Chicago"),
             person2_name: {
                 type: "string",
@@ -453,7 +460,11 @@ registerTool({
             },
             location: {
                 type: "string",
-                description: "Person 1 / Natal location. Prefer a plain place name like 'New York, NY' — the server resolves it via the same lookup `location_search` uses (unambiguous names → coords + timezone; ambiguous names throw with a disambiguation hint). Supplied person1_latitude/person1_longitude always win.",
+                description: "Person 1 / Natal location. Prefer a plain place name like 'New York, NY' — resolved via the same lookup `location_search` uses; ambiguous names throw with a disambiguation hint. Supplied person1_latitude/person1_longitude win.",
+            },
+            person2_location: {
+                type: "string",
+                description: "Person 2 / outer-chart place name, resolved like `location`. person2_latitude/person2_longitude win.",
             },
             mode: {
                 type: "string",
@@ -493,10 +504,26 @@ registerTool({
         const lat1 = resolved1.latitude;
         const lon1 = resolved1.longitude;
         const tz1 = args.person1_timezone ?? resolved1.timezone;
+        const resolved2 = await coordsFromArgsOrLocation({
+            latitude: args.person2_latitude,
+            longitude: args.person2_longitude,
+            timezone: args.person2_timezone,
+            location: args.person2_location,
+        });
+        // Only synastry casts a standalone chart from Person 2's own birthplace. The
+        // other modes either fall back to Person 1's coords (transit, *_return) or
+        // ignore lat2/lon2 entirely (progressed, solar_arc), so an unresolved Person 2
+        // is a hard error there alone. Without this the coords fell through to
+        // `lat ?? 0` in buildNatalBody and silently produced a chart cast for
+        // 0°N 0°E — no error, no warning, wrong houses and angles.
+        if (mode === "synastry" && (resolved2.latitude == null || resolved2.longitude == null)) {
+            throw new Error("explore_bi_wheel in synastry mode requires either `person2_latitude` + `person2_longitude` " +
+                "or a resolvable `person2_location` name. Person 2's birthplace is never inferred from Person 1's.");
+        }
         const dt2 = String(args.person2_datetime);
-        const lat2 = args.person2_latitude;
-        const lon2 = args.person2_longitude;
-        const tz2 = args.person2_timezone;
+        const lat2 = resolved2.latitude;
+        const lon2 = resolved2.longitude;
+        const tz2 = args.person2_timezone ?? resolved2.timezone;
         const loc1 = String(args.person1_name ?? resolved1.location ?? args.location ?? `${lat1},${lon1}`);
         const loc2 = MODE_META[mode].outerLabel(dt2, args.person2_name);
         // Fetch inner (natal) and outer (mode-dependent) charts in parallel where possible
@@ -575,6 +602,13 @@ registerTool({
         const lat2 = args.person2_latitude;
         const lon2 = args.person2_longitude;
         const tz2 = args.person2_timezone;
+        // Same 0°N 0°E trap as explore_bi_wheel: person1 coords are required by the
+        // schema but person2's cannot be (they are only needed in synastry mode), so
+        // the mode-specific requirement is enforced here. The widget always supplies
+        // them; a hand-rolled call need not.
+        if (mode === "synastry" && (lat2 == null || lon2 == null)) {
+            throw new Error("bi_wheel_recalculate in synastry mode requires `person2_latitude` and `person2_longitude`.");
+        }
         const loc1 = String(args.person1_name ?? args.location ?? `${lat1 ?? "?"},${lon1 ?? "?"}`);
         const loc2 = MODE_META[mode].outerLabel(dt2, args.person2_name);
         const [innerData, outerData] = await Promise.all([

package/dist/tools/apps/bodygraph-app.js

@@ -306,7 +306,10 @@ function buildHdSummary(payload, location) {
 registerTool({
     name: "explore_human_design",
     description: "Generate an interactive Human Design Bodygraph with clickable centers, gates, and channels.\n\n" +
-        "CREDIT COST: 2 credits per call.\n\n" +
+        "CREDIT COST: 4 credits where the bodygraph renders (2 for the chart + 2 for the " +
+        "visual), 2 in text-only hosts that skip the render. For chart data alone at 2 " +
+        "credits — including the activations, design, personality, strategy and variables " +
+        "this tool does not return — use human_design_chart.\n\n" +
         "Returns an embedded visual bodygraph explorer that lets you click any center or gate " +
         "for instant Human Design interpretation. " +
         "Shows defined/undefined centers, active gates, channels, Type, Profile, Authority, " +

package/dist/tools/index.d.ts

@@ -57,7 +57,11 @@ export interface ToolDefinition {
  * multi-tenant HTTP server cannot vary it per session, and an unregistered
  * tool becomes uncallable rather than merely hidden.
  */
-export type ToolSurface = "core" | "full";
+export type ToolSurface = "core" | "full" | ToolsetSurface;
+/** A caller-chosen set of traditions, e.g. `?profile=hd,bazi`. */
+export interface ToolsetSurface {
+    readonly toolsets: readonly string[];
+}
 /**
  * The default advertised surface: everyday astrology work, one tool per job.
  *
@@ -80,6 +84,28 @@ export type ToolSurface = "core" | "full";
  * explore_natal_chart are present. Do not remove those four.
  */
 export declare const CORE_TOOL_NAMES: ReadonlySet<string>;
+/**
+ * Tool surfaces grouped by tradition, so a caller pays context only for the
+ * work they actually do: `?profile=hd,bazi` on HTTP, `OPENEPHEMERIS_TOOLS=hd`
+ * on stdio. BASE_TOOLSET is always included.
+ *
+ * This is the same *view* filter as `core`/`full` — nothing is unregistered,
+ * every tool stays callable by name — so a toolset is a context-budget choice,
+ * never a capability one.
+ *
+ * Why this exists: the core surface is re-sent on every model pass and sat at
+ * its ceiling with ~0 headroom, and the only levers left were deleting the
+ * disambiguation prose that makes tool selection work. Grouping by tradition
+ * is the structural fix — a Human Design user should not pay for Venus Star
+ * Points on every message.
+ *
+ * Names here are asserted against the registry by a test; a typo fails the
+ * build rather than silently narrowing someone's surface.
+ */
+export declare const TOOLSETS: Readonly<Record<string, readonly string[]>>;
+export declare const TOOLSET_NAMES: readonly string[];
+/** Resolve a toolset selection to the tool names it advertises. */
+export declare function toolsetSelectionNames(names: readonly string[]): Set<string>;
 /**
  * Returns tools that should be exposed to Claude in the ListTools response.
  * Filters out tools that have visibility restricted to the UI (app-only),
@@ -87,8 +113,21 @@ export declare const CORE_TOOL_NAMES: ReadonlySet<string>;
  * "core" — everything outside CORE_TOOL_NAMES.
  */
 export declare function modelVisibleTools(transport?: "stdio" | "http", surface?: ToolSurface): ToolDefinition[];
-/** Parses a caller-supplied surface hint. Anything unrecognised means "core". */
+/**
+ * Parses a caller-supplied surface hint.
+ *
+ *   "full"          -> every model-visible tool
+ *   "hd" | "hd,bazi" -> those traditions plus BASE_TOOLSET
+ *   anything else   -> "core" (the curated default)
+ *
+ * Unknown names in a comma list are ignored rather than rejected: a typo
+ * degrades to a smaller surface, never to an error at `initialize` that would
+ * leave the connector dead. If NO name in the list is recognised, fall back to
+ * "core" so a mistyped profile can't strand a caller on BASE alone.
+ */
 export declare function parseToolSurface(raw: unknown): ToolSurface;
+/** Stable label for logs/analytics — an object surface has no useful toString. */
+export declare function describeSurface(surface: ToolSurface): string;
 export declare const toolRegistry: Record<string, ToolDefinition>;
 export declare function registerTool(tool: ToolDefinition): void;
 export type ToolProfile = "dev" | "legacy";

package/dist/tools/index.js

@@ -12,6 +12,9 @@ export const SERVER_VERSION = (() => {
         return "0.0.0-unknown";
     }
 })();
+function isToolsetSurface(s) {
+    return typeof s === "object" && Array.isArray(s.toolsets);
+}
 /**
  * The default advertised surface: everyday astrology work, one tool per job.
  *
@@ -53,6 +56,13 @@ export const CORE_TOOL_NAMES = new Set([
     "ephemeris_transits",
     "ephemeris_synastry",
     "ephemeris_retrograde_status",
+    // Promoted 2026-08-02 on usage: both were reachable only via profile=full,
+    // yet ephemeris_aspect_check drew 19 calls from 3 users over 90 days (more
+    // than 20 of the tools already in this set) and ephemeris_angles_points drew
+    // 9. People found them while they were hidden; advertising them is cheap
+    // (202 and 227 tokens) and earns its place.
+    "ephemeris_aspect_check",
+    "ephemeris_angles_points",
     "ephemeris_next_eclipse",
     "ephemeris_relocation",
     "ephemeris_progressed_chart",
@@ -60,13 +70,31 @@ export const CORE_TOOL_NAMES = new Set([
     // Traditions
     "human_design_chart",
     "vedic_chart",
-    "chinese_bazi",
     "bazi_annual_pillar",
+    // chinese_bazi demoted 2026-08-02: explore_bazi_chart POSTs the same
+    // /chinese/bazi at the same 1-credit base and keeps every substantive field
+    // (year/month/day/hour pillars + day_master), dropping only the `metadata`
+    // and `success` envelope keys — verified against a live response, not
+    // inferred from the names. It also degrades to a text summary on hosts that
+    // cannot render the iframe, so nothing is lost without an MCP Apps host.
+    // chinese_bazi drew 0 calls in 90 days while advertised; explore_bazi_chart
+    // drew 3. Still registered and callable by name, and still in profile=full.
+    //
+    // NOTE: this reasoning does NOT extend to the sibling pairs. vedic_chart (1
+    // credit) vs explore_vedic_chart (3), and human_design_chart (2 credits, full
+    // response) vs explore_human_design (4 credits, and buildHdModelPayload drops
+    // activations/design/personality/strategy/variables) are not folds — they
+    // would cost users money and data. Verify in the handler before adding to
+    // this list.
     // Timing
     "ephemeris_electional",
     "electional_moment_analysis",
     "electional_station_tracker",
-    "electional_angle_crossings",
+    // electional_angle_crossings demoted 2026-08-02: 715 tokens (the fattest
+    // non-proxy tool in this set) for 0 calls in 90 days, and at 5 credits it is
+    // advanced-practitioner work rather than an everyday ask. Three electional
+    // entry points remain advertised; this one is a profile=full / skill-named
+    // tool now.
     // Astrocartography
     "acg_power_lines",
     "acg_hits",
@@ -83,6 +111,141 @@ export const CORE_TOOL_NAMES = new Set([
     "auth_status",
     "auth_logout",
 ]);
+/**
+ * Tools every session needs regardless of tradition: turning a place name into
+ * coordinates, checking credits, and the allowlist-gated escape hatch. Always
+ * unioned into a toolset selection — a caller who asks for `hd` still has to be
+ * able to resolve a birthplace, or they are back to recalling coordinates from
+ * memory, which is the bug BASE exists to prevent.
+ */
+const BASE_TOOLSET = [
+    "location_search",
+    "timezone_resolve",
+    "account_usage",
+    "dev_read_api",
+    // The write half of the escape hatch. 26 of the 31 allowlisted operations
+    // are POST — BASE without dev_write_api would strand a toolset caller with
+    // only the 5 GET proxies. (Deliberately NOT advertised in `core`, where the
+    // curated typed tools cover the write surface; a toolset selection has no
+    // such coverage, so it needs the proxy whole.)
+    "dev_write_api",
+    "dev_list_allowed",
+    "auth_login",
+    "auth_status",
+    "auth_logout",
+];
+/**
+ * Tool surfaces grouped by tradition, so a caller pays context only for the
+ * work they actually do: `?profile=hd,bazi` on HTTP, `OPENEPHEMERIS_TOOLS=hd`
+ * on stdio. BASE_TOOLSET is always included.
+ *
+ * This is the same *view* filter as `core`/`full` — nothing is unregistered,
+ * every tool stays callable by name — so a toolset is a context-budget choice,
+ * never a capability one.
+ *
+ * Why this exists: the core surface is re-sent on every model pass and sat at
+ * its ceiling with ~0 headroom, and the only levers left were deleting the
+ * disambiguation prose that makes tool selection work. Grouping by tradition
+ * is the structural fix — a Human Design user should not pay for Venus Star
+ * Points on every message.
+ *
+ * Names here are asserted against the registry by a test; a typo fails the
+ * build rather than silently narrowing someone's surface.
+ */
+export const TOOLSETS = {
+    /** Western natal/predictive work — the default tradition. */
+    astrology: [
+        "ephemeris_natal_chart",
+        "explore_natal_chart",
+        "ephemeris_planet_position",
+        "ephemeris_house_cusps",
+        "ephemeris_angles_points",
+        "ephemeris_aspect_check",
+        "ephemeris_transits",
+        "ephemeris_natal_transits",
+        "explore_transit_timeline",
+        "ephemeris_synastry",
+        "explore_bi_wheel",
+        "bi_wheel_synopsis",
+        "ephemeris_retrograde_status",
+        "ephemeris_progressed_chart",
+        "ephemeris_solar_return",
+        "ephemeris_lunar_return",
+        "ephemeris_planetary_return",
+        "ephemeris_relocation",
+        "ephemeris_dignities",
+        "ephemeris_midpoints",
+        "ephemeris_hermetic_lots",
+        "ephemeris_fixed_stars",
+        "ephemeris_composite",
+        "ephemeris_composite_midpoint",
+        "ephemeris_overlay",
+        "ephemeris_chart_wheel",
+        "ephemeris_bi_wheel",
+        "ephemeris_natal_batch",
+    ],
+    /** Lunar phase, void-of-course and eclipse work. */
+    moon: [
+        "ephemeris_moon_phase",
+        "explore_moon_phase",
+        "ephemeris_next_lunar_phase",
+        "ephemeris_next_eclipse",
+    ],
+    /** Human Design. */
+    hd: [
+        "human_design_chart",
+        "explore_human_design",
+        "explore_human_design_transit",
+        "explore_human_design_connection",
+        "human_design_bodygraph",
+        "human_design_composite",
+        "human_design_penta",
+        "hd_opposition",
+        "hd_planetary_return",
+    ],
+    /** Chinese BaZi / Four Pillars. */
+    bazi: [
+        "explore_bazi_chart",
+        "chinese_bazi",
+        "bazi_chart",
+        "bazi_ten_gods",
+        "bazi_element_balance",
+        "bazi_luck_pillars",
+        "bazi_annual_pillar",
+        "bazi_compatibility",
+    ],
+    /** Vedic / Jyotish. */
+    vedic: ["vedic_chart", "explore_vedic_chart"],
+    /** Astrocartography. */
+    acg: ["acg_hits", "acg_power_lines"],
+    /** Electional timing. */
+    electional: [
+        "ephemeris_electional",
+        "electional_moment_analysis",
+        "electional_station_tracker",
+        "electional_angle_crossings",
+        "electional_aspect_search",
+    ],
+    /** Venus Star Point / synodic-cycle work. */
+    venus: [
+        "venus_star_points",
+        "venus_star_points_conjunctions",
+        "venus_phase",
+        "venus_elongations",
+        "venus_stations",
+        "venus_eight_year_star",
+    ],
+};
+export const TOOLSET_NAMES = Object.keys(TOOLSETS);
+/** Resolve a toolset selection to the tool names it advertises. */
+export function toolsetSelectionNames(names) {
+    const out = new Set(BASE_TOOLSET);
+    for (const n of names) {
+        for (const t of TOOLSETS[n] ?? [])
+            out.add(t);
+    }
+    return out;
+}
 /**
  * Returns tools that should be exposed to Claude in the ListTools response.
  * Filters out tools that have visibility restricted to the UI (app-only),
@@ -90,6 +253,9 @@ export const CORE_TOOL_NAMES = new Set([
  * "core" — everything outside CORE_TOOL_NAMES.
  */
 export function modelVisibleTools(transport = "stdio", surface = "full") {
+    const allowed = isToolsetSurface(surface)
+        ? toolsetSelectionNames(surface.toolsets)
+        : null;
     return Object.values(toolRegistry).filter((t) => {
         if (transport === "http" && t.stdioOnly)
             return false;
@@ -97,14 +263,45 @@ export function modelVisibleTools(transport = "stdio", surface = "full") {
         // If visibility is explicitly ["app"] (no "model"), hide from model
         if (vis && !vis.includes("model") && vis.includes("app"))
             return false;
+        if (allowed)
+            return allowed.has(t.name);
         if (surface === "core" && !CORE_TOOL_NAMES.has(t.name))
             return false;
         return true;
     });
 }
-/** Parses a caller-supplied surface hint. Anything unrecognised means "core". */
+/**
+ * Parses a caller-supplied surface hint.
+ *
+ *   "full"          -> every model-visible tool
+ *   "hd" | "hd,bazi" -> those traditions plus BASE_TOOLSET
+ *   anything else   -> "core" (the curated default)
+ *
+ * Unknown names in a comma list are ignored rather than rejected: a typo
+ * degrades to a smaller surface, never to an error at `initialize` that would
+ * leave the connector dead. If NO name in the list is recognised, fall back to
+ * "core" so a mistyped profile can't strand a caller on BASE alone.
+ */
 export function parseToolSurface(raw) {
-    return typeof raw === "string" && raw.toLowerCase() === "full" ? "full" : "core";
+    if (typeof raw !== "string")
+        return "core";
+    const value = raw.trim().toLowerCase();
+    if (value === "full")
+        return "full";
+    if (value === "" || value === "core")
+        return "core";
+    const requested = value
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    const known = requested.filter((n) => Object.hasOwn(TOOLSETS, n));
+    if (known.length === 0)
+        return "core";
+    return { toolsets: known };
+}
+/** Stable label for logs/analytics — an object surface has no useful toString. */
+export function describeSurface(surface) {
+    return isToolsetSurface(surface) ? surface.toolsets.join("+") : surface;
 }
 export const toolRegistry = {};
 export function registerTool(tool) {

package/dist/tools/specialized/moon.js

@@ -6,20 +6,16 @@ import { localToUtcIsoHistorical } from "../datetime-historical.js";
 registerTool({
     name: "ephemeris_moon_phase",
     description: "Get the Moon's current phase angle, illumination, sign and void-of-course status AT a " +
-        "specific point in time. Returns phase name (New, Waxing Crescent, First Quarter, etc.), exact " +
-        "angle, illumination %, the zodiac sign and degree the Moon occupies, and next void-of-course " +
-        "period.\n\n" +
+        "specific point in time. Returns phase name (New, Waxing Crescent, etc.), illumination %, " +
+        "the zodiac sign and degree the Moon occupies, and next void-of-course period.\n\n" +
         "⚠️  THIS TOOL ANSWERS: 'What phase is the moon in right now (or at a given datetime)?' and " +
         "'What sign is the moon in?'\n" +
         "❌  THIS TOOL DOES NOT ANSWER: 'When is the next new moon / full moon?'\n" +
         "→   For upcoming phase DATES use ephemeris_next_lunar_phase instead.\n\n" +
         "For a user-facing interactive moon-phase dial, use explore_moon_phase instead.\n\n" +
-        "CREDIT COST: 1 credit per call.\n\n" +
-        "If no datetime is provided, returns the current (live) moon phase.\n\n" +
-        "EXAMPLE: Get moon phase for a specific date/time:\n" +
-        "  datetime='2026-03-20T12:00:00Z'\n\n" +
-        "EXAMPLE: Get the current moon phase right now:\n" +
-        "  (call with no arguments)",
+        "CREDIT COST: 2 credits — phase and void-of-course are metered separately. For " +
+        "phase alone at 1 credit, use dev_read_api path='/ephemeris/moon/phase'.\n\n" +
+        "If no datetime is provided, returns the current (live) moon phase.",
     inputSchema: {
         type: "object",
         properties: {
@@ -74,8 +70,9 @@ registerTool({
         "'What date is the next quarter moon?', or any question about UPCOMING phase dates.\n" +
         "❌  NOT FOR: 'What phase is the moon in right now?' or 'What sign is the moon in?'\n" +
         "→   For the phase, sign and degree AT a moment, use ephemeris_moon_phase.\n\n" +
-        "CREDIT COST: about 1 credit per occurrence returned — count=1 costs 1 credit, " +
-        "count=3 costs 3.\n\n" +
+        "CREDIT COST: 1-2 credits per occurrence returned — each occurrence takes one " +
+        "calendar search, plus a second search when the first window misses. So count=3 " +
+        "costs 3-6 credits.\n\n" +
         "EXAMPLE: Find the next new moon:\n" +
         "  phase='new_moon'\n\n" +
         "EXAMPLE: Find the next full moon after a specific date:\n" +

package/dist/ui/chart-wheel.html

@@ -7690,8 +7690,8 @@ function Cy(e5) {
 vy.ontoolresult = (e5) => {
   var t2;
   let n2 = ny(e5);
-  if (qy(), !n2 || !n2.planets) {
-    console.error("[ChartWheel] \u274C No chart data found in tool result"), Jy("Chart data could not be parsed from the server response.", Yy);
+  if (Jy(), !n2 || !n2.planets) {
+    console.error("[ChartWheel] \u274C No chart data found in tool result"), Yy("Chart data could not be parsed from the server response.", Xy);
     return;
   }
   if ($ = n2, yy = (t2 = n2.house_system) == null ? "placidus" : t2, !by) {
@@ -7718,9 +7718,9 @@ vy.ontoolresult = (e5) => {
 };
 function wy(e5) {
   var t2, n2, r2, i2, a2, o2, s2;
-  ky = null, ly.setAttribute("hidden", ""), uy.removeAttribute("hidden"), _y.removeAttribute("hidden"), py.removeAttribute("hidden"), zv(uy, e5, Ly, Ry, zy, Wy, Sy ? By() : void 0), mv(Cy), Hv(py, yy, Gy), Ty(e5), ty("chart-wheel", uy);
+  Ay = null, ly.setAttribute("hidden", ""), uy.removeAttribute("hidden"), _y.removeAttribute("hidden"), py.removeAttribute("hidden"), zv(uy, e5, Ry, zy, By, Gy, Sy ? Vy() : void 0), mv(Cy), Hv(py, yy, Ky), Ey(e5), ty("chart-wheel", uy);
   let c2 = K_(e5.planets), l2 = (n2 = (r2 = (i2 = ((t2 = e5.houses) == null ? [] : t2)[0]) == null ? void 0 : i2.cusp_lon) == null ? e5.ascendant : r2) == null ? 0 : n2, u2 = (a2 = e5.aspects) == null ? [] : a2;
-  c2.length > 0 && Dy(c2, u2), Ay(cv(u2, c2), c2, l2), Fy();
+  c2.length > 0 && Oy(c2, u2), jy(cv(u2, c2), c2, l2), Iy();
   let d2 = document.getElementById("cw-action-bar");
   if (!d2) {
     d2 = document.createElement("div"), d2.id = "cw-action-bar", d2.className = "hd-action-bar";
@@ -7731,9 +7731,12 @@ function wy(e5) {
       (f2 = document.getElementById("app")) == null || f2.prepend(d2);
     }
   }
-  d2.innerHTML = '\n    <button class="action-btn action-btn--primary" id="cw-interpret-btn">\u2728 Interpret this chart</button>\n    <button class="action-btn" id="cw-questions-btn">\u{1F52E} What should I ask?</button>\n  ', (o2 = document.getElementById("cw-interpret-btn")) == null || o2.addEventListener("click", () => void Hy()), (s2 = document.getElementById("cw-questions-btn")) == null || s2.addEventListener("click", () => void Uy());
+  d2.innerHTML = '\n    <button class="action-btn action-btn--primary" id="cw-interpret-btn">\u2728 Interpret this chart</button>\n    <button class="action-btn" id="cw-questions-btn">\u{1F52E} What should I ask?</button>\n  ', (o2 = document.getElementById("cw-interpret-btn")) == null || o2.addEventListener("click", () => void Uy()), (s2 = document.getElementById("cw-questions-btn")) == null || s2.addEventListener("click", () => void Wy());
 }
 function Ty(e5) {
+  return String(e5).replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function Ey(e5) {
   var t2, n2, r2, i2, a2, o2, s2, c2, l2, u2;
   if (!dy) return;
   let d2 = (t2 = e5._birth_params) == null ? {} : t2, f2 = (n2 = (r2 = (i2 = d2.datetime) == null ? e5.datetime : i2) == null ? e5.birth_datetime : r2) == null ? "" : n2, p2 = (a2 = (o2 = d2.location) == null ? e5.location : o2) == null ? "" : a2, m2 = (s2 = (c2 = d2.timezone) == null ? e5.timezone : c2) == null ? "" : s2, h2 = (l2 = d2.latitude) == null ? e5.latitude : l2, g2 = (u2 = d2.longitude) == null ? e5.longitude : u2;
@@ -7747,14 +7750,14 @@ function Ty(e5) {
   } catch (e6) {
   }
   let y2 = typeof h2 == "number" && typeof g2 == "number" ? "".concat(Math.abs(h2).toFixed(2), "\xB0").concat(h2 >= 0 ? "N" : "S", ", ").concat(Math.abs(g2).toFixed(2), "\xB0").concat(g2 >= 0 ? "E" : "W") : "", b2 = [];
-  if (ee2 && b2.push('<span class="info-chip" title="Birth datetime">\u{1F4C5} '.concat(ee2, "</span>")), p2 && b2.push('<span class="info-chip" title="Birth location">\u{1F4CD} '.concat(p2, "</span>")), y2 && !p2 && b2.push('<span class="info-chip" title="Coordinates">\u{1F4CD} '.concat(y2, "</span>")), m2 && b2.push('<span class="info-chip" title="Timezone">\u{1F550} '.concat(m2, "</span>")), v2 && b2.push('<span class="info-chip sect" title="Sect">'.concat(v2, "</span>")), b2.length === 0) {
+  if (ee2 && b2.push('<span class="info-chip" title="Birth datetime">\u{1F4C5} '.concat(Ty(ee2), "</span>")), p2 && b2.push('<span class="info-chip" title="Birth location">\u{1F4CD} '.concat(Ty(p2), "</span>")), y2 && !p2 && b2.push('<span class="info-chip" title="Coordinates">\u{1F4CD} '.concat(Ty(y2), "</span>")), m2 && b2.push('<span class="info-chip" title="Timezone">\u{1F550} '.concat(Ty(m2), "</span>")), v2 && b2.push('<span class="info-chip sect" title="Sect">'.concat(Ty(v2), "</span>")), b2.length === 0) {
     dy.setAttribute("hidden", "");
     return;
   }
   dy.innerHTML = b2.join(""), dy.removeAttribute("hidden");
 }
-var Ey = /* @__PURE__ */ new Set(["mean_lilith", "lilith", "true_lilith", "ceres", "juno", "vesta", "pallas", "pholus", "vertex", "part_of_fortune", "part of fortune", "eris", "sedna"]);
-function Dy(e5, t2) {
+var Dy = /* @__PURE__ */ new Set(["mean_lilith", "lilith", "true_lilith", "ceres", "juno", "vesta", "pallas", "pholus", "vertex", "part_of_fortune", "part of fortune", "eris", "sedna"]);
+function Oy(e5, t2) {
   if (!gy || e5.length === 0) return;
   let n2 = ["sun", "moon", "mercury", "venus", "mars", "jupiter", "saturn", "uranus", "neptune", "pluto", "chiron", "north node", "south node", "true node"], r2 = [...e5].sort((e6, t3) => {
     let r3 = n2.indexOf(e6.name.toLowerCase()), i3 = n2.indexOf(t3.name.toLowerCase());
@@ -7766,7 +7769,7 @@ function Dy(e5, t2) {
   }
   let s2 = (e6) => e6.replace(/(^|\s|_)\w/g, (e7) => e7.toUpperCase()).replace(/_/g, " "), c2 = (e6) => ["Aries", "Taurus", "Gemini", "Cancer", "Leo", "Virgo", "Libra", "Scorpio", "Sagittarius", "Capricorn", "Aquarius", "Pisces"][Math.floor((e6 % 360 + 360) % 360 / 30)], l2 = r2.map((e6) => {
     var t3, n3, r3, a3;
-    let o3 = e6.name.toLowerCase(), l3 = (t3 = j_[o3]) == null ? "\u2605" : t3, u3 = (n3 = e6.sign) == null ? c2(e6.longitude) : n3, d3 = Math.floor((e6.longitude % 360 + 360) % 360 % 30), f3 = Math.floor((e6.longitude % 360 + 360) % 360 % 1 * 60), p3 = Ey.has(o3), m2 = e6.retrograde ? '<span class="retro-mark">\u211E</span>' : "", h2 = (r3 = i2[o3]) == null ? 0 : r3;
+    let o3 = e6.name.toLowerCase(), l3 = (t3 = j_[o3]) == null ? "\u2605" : t3, u3 = (n3 = e6.sign) == null ? c2(e6.longitude) : n3, d3 = Math.floor((e6.longitude % 360 + 360) % 360 % 30), f3 = Math.floor((e6.longitude % 360 + 360) % 360 % 1 * 60), p3 = Dy.has(o3), m2 = e6.retrograde ? '<span class="retro-mark">\u211E</span>' : "", h2 = (r3 = i2[o3]) == null ? 0 : r3;
     return '<tr class="'.concat(p3 ? "extended-row" : "", '" data-planet="').concat(o3, '">\n      <td><span class="planet-sym">').concat(l3, "</span> ").concat(s2(e6.name)).concat(m2, "</td>\n      <td>").concat(d3, "\xB0 ").concat(u3, " ").concat(String(f3).padStart(2, "0"), "\u2032</td>\n      <td>H").concat((a3 = e6.house) == null ? "\u2013" : a3, "</td>\n      <td>").concat(h2 > 0 ? h2 : "\u2013", "</td>\n    </tr>");
   }).join(""), u2 = "| Body | Sign | Degree | House | Retrograde |\n| --- | --- | --- | --- | --- |\n" + r2.map((e6) => {
     var t3;
@@ -7784,7 +7787,7 @@ function Dy(e5, t2) {
         d2.textContent = "Copy", d2.classList.remove("copied");
       }, 1600);
     } catch (e7) {
-      Oy("Copy unavailable");
+      ky("Copy unavailable");
     }
   });
   let f2 = gy.querySelector(".overview-toggle"), p2 = gy.querySelector(".overview-body");
@@ -7803,7 +7806,7 @@ function Dy(e5, t2) {
       let t4 = document.querySelector("svg");
       t4 && (t4.querySelectorAll(".planet-glyph-group").forEach((e7) => {
         var t5;
-        let n4 = Ey.has((t5 = e7.dataset.planet) == null ? "" : t5);
+        let n4 = Dy.has((t5 = e7.dataset.planet) == null ? "" : t5);
         e7.style.opacity = n4 ? "0.65" : "1";
       }), e6.classList.remove("active-row"));
     }), e6.addEventListener("click", () => {
@@ -7814,7 +7817,7 @@ function Dy(e5, t2) {
     }));
   });
 }
-function Oy(e5) {
+function ky(e5) {
   var t2;
   (t2 = document.getElementById("copy-toast")) == null || t2.remove();
   let n2 = document.createElement("div");
@@ -7822,8 +7825,8 @@ function Oy(e5) {
     n2.classList.remove("visible"), setTimeout(() => n2.remove(), 300);
   }, 2500);
 }
-var ky = null;
-function Ay(e5, t2, n2) {
+var Ay = null;
+function jy(e5, t2, n2) {
   if (!my) return;
   if (e5.length === 0) {
     my.setAttribute("hidden", ""), my.innerHTML = "";
@@ -7838,10 +7841,10 @@ function Ay(e5, t2, n2) {
     let t3 = document.createElement("button");
     t3.className = "pattern-ask-claude-btn", t3.textContent = "\u2728 Ask Claude", t3.style.display = "none", my.appendChild(t3), t3.addEventListener("click", () => {
       var n3;
-      let r3 = ky;
+      let r3 = Ay;
       if (r3 === null) return;
       let i2 = e5[r3];
-      t3.disabled = true, t3.textContent = "\u23F3 Sending\u2026", Wy({ type: "pattern", data: { name: i2.name, planets: i2.planets, description: (n3 = i2.description) == null ? "" : n3 } }).then(() => {
+      t3.disabled = true, t3.textContent = "\u23F3 Sending\u2026", Gy({ type: "pattern", data: { name: i2.name, planets: i2.planets, description: (n3 = i2.description) == null ? "" : n3 } }).then(() => {
         t3.textContent = "\u2713 Sent", setTimeout(() => {
           t3.textContent = "\u2728 Ask Claude", t3.disabled = false;
         }, 2500);
@@ -7854,12 +7857,12 @@ function Ay(e5, t2, n2) {
     r3.addEventListener("click", () => {
       var i2;
       let a2 = Number(r3.dataset.idx), o2 = e5[a2], s2 = (i2 = r3.dataset.color) == null ? "#888" : i2, c2 = my.querySelector(".pattern-ask-claude-btn");
-      ky === a2 ? (ky = null, Mv(), c2 && (c2.style.display = "none"), my.querySelectorAll(".pattern-pill").forEach((e6) => {
+      Ay === a2 ? (Ay = null, Mv(), c2 && (c2.style.display = "none"), my.querySelectorAll(".pattern-pill").forEach((e6) => {
         var t3;
         e6.classList.remove("active");
         let n3 = (t3 = e6.dataset.color) == null ? "#888" : t3;
         e6.style.color = n3, e6.style.borderColor = n3, e6.style.background = "transparent";
-      })) : (ky = a2, my.querySelectorAll(".pattern-pill").forEach((e6) => {
+      })) : (Ay = a2, my.querySelectorAll(".pattern-pill").forEach((e6) => {
         var t3;
         e6.classList.remove("active");
         let n3 = (t3 = e6.dataset.color) == null ? "#888" : t3;
@@ -7868,8 +7871,8 @@ function Ay(e5, t2, n2) {
     });
   });
 }
-var jy = [{ label: "Tight", maxOrb: 4 }, { label: "Standard", maxOrb: 8 }, { label: "Wide", maxOrb: 12 }], My = true, Ny = 8, Py = "true";
-function Fy() {
+var My = [{ label: "Tight", maxOrb: 4 }, { label: "Standard", maxOrb: 8 }, { label: "Wide", maxOrb: 12 }], Ny = true, Py = 8, Fy = "true";
+function Iy() {
   var e5;
   if (!hy) return;
   let t2 = (() => {
@@ -7881,9 +7884,9 @@ function Fy() {
     let n3 = t3.some((e7) => e7 === "north node" || e7 === "north node (mean)" || e7 === "mean node"), r3 = t3.some((e7) => e7 === "true node" || e7 === "north node (true)");
     return n3 && r3;
   })();
-  W_(Py);
-  let n2 = t2 ? '\n      <div class="asp-section">\n        <span class="asp-section-label">Nodes</span>\n        <button class="orb-preset-btn node-btn'.concat(Py === "mean" ? " active" : "", '" data-node="mean" title="Mean lunar node (averaged orbit)">Mean</button>\n        <button class="orb-preset-btn node-btn').concat(Py === "true" ? " active" : "", '" data-node="true" title="True (osculating) lunar node">True</button>\n      </div>') : "";
-  My = true, hy.innerHTML = '\n    <div class="asp-panel">\n      <div class="asp-section">\n        <span class="asp-section-label">Aspects</span>\n        <button class="aspect-toggle-btn active" id="cw-aspect-vis-toggle"\n          title="Toggle all natal aspect lines">\n          <span class="toggle-icon">\u2295</span> Natal aspects\n        </button>\n      </div>\n      <div class="asp-section">\n        <span class="asp-section-label">Orb</span>\n        '.concat(jy.map((e6) => '<button class="orb-preset-btn'.concat(e6.maxOrb === Ny ? " active" : "", '" data-orb="').concat(e6.maxOrb, '" title="').concat(e6.label, ' orbs">').concat(e6.label, "</button>")).join(""), "\n      </div>").concat(n2, "\n    </div>\n  ");
+  W_(Fy);
+  let n2 = t2 ? '\n      <div class="asp-section">\n        <span class="asp-section-label">Nodes</span>\n        <button class="orb-preset-btn node-btn'.concat(Fy === "mean" ? " active" : "", '" data-node="mean" title="Mean lunar node (averaged orbit)">Mean</button>\n        <button class="orb-preset-btn node-btn').concat(Fy === "true" ? " active" : "", '" data-node="true" title="True (osculating) lunar node">True</button>\n      </div>') : "";
+  Ny = true, hy.innerHTML = '\n    <div class="asp-panel">\n      <div class="asp-section">\n        <span class="asp-section-label">Aspects</span>\n        <button class="aspect-toggle-btn active" id="cw-aspect-vis-toggle"\n          title="Toggle all natal aspect lines">\n          <span class="toggle-icon">\u2295</span> Natal aspects\n        </button>\n      </div>\n      <div class="asp-section">\n        <span class="asp-section-label">Orb</span>\n        '.concat(My.map((e6) => '<button class="orb-preset-btn'.concat(e6.maxOrb === Py ? " active" : "", '" data-orb="').concat(e6.maxOrb, '" title="').concat(e6.label, ' orbs">').concat(e6.label, "</button>")).join(""), "\n      </div>").concat(n2, "\n    </div>\n  ");
   let r2 = K_($ == null ? void 0 : $.planets), i2 = /* @__PURE__ */ new Set(), a2 = [];
   for (let e6 of r2) {
     let t3 = e6.name.toLowerCase();
@@ -7902,21 +7905,21 @@ function Fy() {
   hy.insertAdjacentHTML("beforeend", Kv([{ title: "Bodies", items: a2 }, { title: "Aspects", items: o2 }])), hy.removeAttribute("hidden");
   let s2 = document.getElementById("cw-aspect-vis-toggle");
   s2 == null || s2.addEventListener("click", () => {
-    My = !My, Lv(My), s2.classList.toggle("active", My), s2.querySelector(".toggle-icon").textContent = My ? "\u2295" : "\u2296";
+    Ny = !Ny, Lv(Ny), s2.classList.toggle("active", Ny), s2.querySelector(".toggle-icon").textContent = Ny ? "\u2295" : "\u2296";
   }), hy.querySelectorAll(".orb-preset-btn:not(.node-btn)").forEach((e6) => {
     e6.addEventListener("click", () => {
       var t3;
       let n3 = parseFloat((t3 = e6.dataset.orb) == null ? "8" : t3);
-      n3 !== Ny && (Ny = n3, hy.querySelectorAll(".orb-preset-btn:not(.node-btn)").forEach((e7) => e7.classList.toggle("active", e7.dataset.orb === String(n3))), Rv(n3));
+      n3 !== Py && (Py = n3, hy.querySelectorAll(".orb-preset-btn:not(.node-btn)").forEach((e7) => e7.classList.toggle("active", e7.dataset.orb === String(n3))), Rv(n3));
     });
   }), hy.querySelectorAll(".node-btn").forEach((e6) => {
     e6.addEventListener("click", () => {
       let t3 = e6.dataset.node === "mean" ? "mean" : "true";
-      t3 === Py || !$ || (Py = t3, W_(t3), wy($));
+      t3 === Fy || !$ || (Fy = t3, W_(t3), wy($));
     });
   });
 }
-async function Iy(e5, t2) {
+async function Ly(e5, t2) {
   if (xy) try {
     let n2 = "[Chart Wheel] Selected ".concat(e5, " \u2014 ").concat(Object.entries(t2).filter(([, e6]) => e6 != null && e6 !== false && e6 !== "").map(([e6, t3]) => "".concat(e6, ": ").concat(t3)).join(", "));
     await vy.updateModelContext({ content: [{ type: "text", text: n2 }] });
@@ -7924,24 +7927,24 @@ async function Iy(e5, t2) {
     console.warn("[ChartWheel] \u26A0\uFE0F updateModelContext failed:", e6);
   }
 }
-async function Ly(e5) {
+async function Ry(e5) {
   var t2, n2, r2, i2;
-  ky = null, my == null || my.querySelectorAll(".pattern-pill").forEach((e6) => {
+  Ay = null, my == null || my.querySelectorAll(".pattern-pill").forEach((e6) => {
     var t3;
     e6.classList.remove("active");
     let n3 = (t3 = e6.dataset.color) == null ? "#888" : t3;
     e6.style.color = n3, e6.style.borderColor = n3, e6.style.background = "transparent";
-  }), await Iy("planet", { planet: e5.name, longitude: e5.longitude, sign: (t2 = e5.sign) == null ? null : t2, house: (n2 = e5.house) == null ? null : n2, retrograde: (r2 = e5.retrograde) == null ? false : r2, speed: (i2 = e5.speed) == null ? null : i2 });
+  }), await Ly("planet", { planet: e5.name, longitude: e5.longitude, sign: (t2 = e5.sign) == null ? null : t2, house: (n2 = e5.house) == null ? null : n2, retrograde: (r2 = e5.retrograde) == null ? false : r2, speed: (i2 = e5.speed) == null ? null : i2 });
 }
-async function Ry(e5) {
+async function zy(e5) {
   var t2, n2;
-  await Iy("house", { house_number: e5.number, sign: (t2 = e5.sign) == null ? null : t2, cusp_longitude: e5.cusp_lon, ruler: (n2 = e5.ruler) == null ? null : n2 });
+  await Ly("house", { house_number: e5.number, sign: (t2 = e5.sign) == null ? null : t2, cusp_longitude: e5.cusp_lon, ruler: (n2 = e5.ruler) == null ? null : n2 });
 }
-async function zy(e5) {
+async function By(e5) {
   var t2, n2, r2, i2;
-  await Iy("aspect", { planet1: e5.planet1, planet2: e5.planet2, aspect_type: (t2 = e5.type) == null ? null : t2, orb: (n2 = e5.orb) == null ? null : n2, applying: (r2 = e5.applying) == null ? null : r2, angle: (i2 = e5.angle) == null ? null : i2 });
+  await Ly("aspect", { planet1: e5.planet1, planet2: e5.planet2, aspect_type: (t2 = e5.type) == null ? null : t2, orb: (n2 = e5.orb) == null ? null : n2, applying: (r2 = e5.applying) == null ? null : r2, angle: (i2 = e5.angle) == null ? null : i2 });
 }
-function By() {
+function Vy() {
   return async (e5) => {
     try {
       var t2, n2;
@@ -7952,30 +7955,30 @@ function By() {
     }
   };
 }
-async function Vy(e5) {
+async function Hy(e5) {
   try {
     (await vy.sendMessage({ role: "user", content: [{ type: "text", text: e5 }] })).isError && console.error("[ChartWheel] Host rejected sendMessage");
   } catch (e6) {
     console.error("[ChartWheel] sendMessage failed:", e6);
   }
 }
-async function Hy() {
+async function Uy() {
   var e5, t2, n2, r2;
   if (!$) return;
   let i2 = $, a2 = (e5 = i2._birth_params) == null ? {} : e5, o2 = (t2 = (n2 = a2.name) == null ? a2.location : n2) == null ? "this person" : t2, s2 = K_(i2.planets), c2 = ((r2 = i2.aspects) == null ? [] : r2).filter((e6) => {
     var t3;
     return ["conjunction", "opposition", "trine", "square", "sextile"].includes((t3 = e6.type) == null ? "" : t3);
   }).slice(0, 8).map((e6) => "  \u2022 ".concat(e6.planet1, " ").concat(e6.type, " ").concat(e6.planet2, " (").concat(Number(e6.orb).toFixed(1), "\xB0, ").concat(e6.applying ? "applying" : "separating", ")")).join("\n") || "  \u2022 No major aspects found";
-  await Vy("Please give a complete natal chart interpretation for ".concat(o2, ".\n\nKey planet placements:\n").concat(s2.slice(0, 5).map((e6) => {
+  await Hy("Please give a complete natal chart interpretation for ".concat(o2, ".\n\nKey planet placements:\n").concat(s2.slice(0, 5).map((e6) => {
     var t3;
     return "  \u2022 ".concat(e6.name, " in ").concat((t3 = e6.sign) == null ? "?" : t3).concat(e6.house ? ", House ".concat(e6.house) : "").concat(e6.retrograde ? " \u211E" : "");
   }).join("\n"), "\n\nMajor aspects:\n").concat(c2, "\n\nCover: (1) Core identity and soul purpose (Sun, Moon, Ascendant), (2) The chart's dominant element, modality, and overall signature, (3) The most significant aspects and their psychological themes, (4) Key life areas of focus and challenge, (5) A practical synthesis \u2014 who is this person and what is their path?"));
 }
-async function Uy() {
+async function Wy() {
   var e5, t2, n2, r2;
   if (!$) return;
   let i2 = $, a2 = (e5 = i2._birth_params) == null ? {} : e5;
-  await Vy("I'm exploring the natal chart for ".concat((t2 = (n2 = a2.name) == null ? a2.location : n2) == null ? "this chart" : t2, ". Key placements: ").concat(K_(i2.planets).slice(0, 4).map((e6) => {
+  await Hy("I'm exploring the natal chart for ".concat((t2 = (n2 = a2.name) == null ? a2.location : n2) == null ? "this chart" : t2, ". Key placements: ").concat(K_(i2.planets).slice(0, 4).map((e6) => {
     var t3;
     return "".concat(e6.name, " in ").concat((t3 = e6.sign) == null ? "?" : t3).concat(e6.house ? " H".concat(e6.house) : "");
   }).join(", ") || "unknown placements", ". Major aspects: ").concat(((r2 = i2.aspects) == null ? [] : r2).filter((e6) => {
@@ -7983,7 +7986,7 @@ async function Uy() {
     return ["conjunction", "opposition", "trine", "square", "sextile"].includes((t3 = e6.type) == null ? "" : t3);
   }).slice(0, 5).map((e6) => "".concat(e6.planet1, " ").concat(e6.type, " ").concat(e6.planet2, " (").concat(Number(e6.orb).toFixed(1), "\xB0)")).join(", ") || "none detected", ".\n\nBased on this chart, please suggest 3-4 specific, insightful questions I could ask to understand this person more deeply \u2014 such as how particular placements manifest in real life, the most significant aspect dynamics, or how to integrate the chart's core tensions. Present each as a tappable question I can ask you."));
 }
-async function Wy(e5) {
+async function Gy(e5) {
   let t2 = "";
   if (e5.type === "planet") {
     var n2;
@@ -8018,7 +8021,7 @@ async function Wy(e5) {
     throw console.error("[ChartWheel] \u274C sendMessage failed:", e6), e6;
   }
 }
-async function Gy(e5) {
+async function Ky(e5) {
   if (!($ != null && $._birth_params)) {
     Uv(py, yy);
     return;
@@ -8031,21 +8034,21 @@ async function Gy(e5) {
     console.error("[Chart] Recalculate failed:", e6), Uv(py, yy);
   }
 }
-var Ky;
-function qy() {
-  Ky && (clearTimeout(Ky), Ky = void 0);
+var qy;
+function Jy() {
+  qy && (clearTimeout(qy), qy = void 0);
 }
-function Jy(e5, t2) {
-  qy(), ly.setAttribute("hidden", ""), iy({ container: uy, message: e5, onRetry: t2 });
+function Yy(e5, t2) {
+  Jy(), ly.setAttribute("hidden", ""), iy({ container: uy, message: e5, onRetry: t2 });
 }
-function Yy() {
-  qy(), uy.setAttribute("hidden", ""), ly.removeAttribute("hidden"), Ky = setTimeout(() => {
-    Jy("The chart didn't load. Tap to try again.", Yy);
+function Xy() {
+  Jy(), uy.setAttribute("hidden", ""), ly.removeAttribute("hidden"), qy = setTimeout(() => {
+    Yy("The chart didn't load. Tap to try again.", Xy);
   }, 3e4), vy.sendMessage({ role: "user", content: [{ type: "text", text: "Please regenerate the chart wheel." }] }).catch(() => {
   });
 }
-oy(vy, { loadingEl: ly, contentEl: uy, statusFn: Cy, paramControls: () => by }), Ky = setTimeout(() => {
-  Jy("Chart data is taking longer than expected.", Yy);
+oy(vy, { loadingEl: ly, contentEl: uy, statusFn: Cy, paramControls: () => by }), qy = setTimeout(() => {
+  Yy("Chart data is taking longer than expected.", Xy);
 }, 3e4), (async () => {
   try {
     await vy.connect();
@@ -8054,7 +8057,7 @@ oy(vy, { loadingEl: ly, contentEl: uy, statusFn: Cy, paramControls: () => by }),
       $ && wy($);
     }), $ && wy($);
   } catch (e5) {
-    console.error("[ChartWheel] \u274C app.connect() FAILED:", e5), Jy("The chart didn't load. Tap to try again.", Yy);
+    console.error("[ChartWheel] \u274C app.connect() FAILED:", e5), Yy("The chart didn't load. Tap to try again.", Xy);
   }
 })();
 </script>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openephemeris/mcp-server",
-  "version": "4.7.0",
+  "version": "4.8.0",
   "description": "Model Context Protocol server for the Open Ephemeris astronomical computation API",
   "type": "module",
   "main": "dist/index.js",
@@ -41,6 +41,7 @@
     "check:schema-packs": "tsx scripts/schema-packs.ts --check",
     "sync:readme": "tsx scripts/sync-readme.ts --write",
     "check:readme": "tsx scripts/sync-readme.ts --check",
+    "check:counts": "tsx scripts/check-counts.ts",
     "check:pack": "tsx scripts/pack-audit.ts",
     "regen:plugin": "tsx scripts/plugin-audit.ts --write",
     "check:plugin": "tsx scripts/plugin-audit.ts --check",
@@ -48,7 +49,8 @@
     "check:skills": "node scripts/build-skills.mjs --check",
     "sync:public": "node scripts/sync-public-repo.mjs --write",
     "check:public": "node scripts/sync-public-repo.mjs --check",
-    "verify:release": "npm run check:dev-allowlist && npm run check:schema-packs && npm run check:readme && npm run check:skills && npm run check:plugin && npm run check:public && npm run typecheck && npm test && npm run build && npm run check:pack",
+    "check:public:strict": "node scripts/sync-public-repo.mjs --check --require-mirror",
+    "verify:release": "npm run check:dev-allowlist && npm run check:schema-packs && npm run check:readme && npm run check:counts && npm run check:skills && npm run check:plugin && npm run check:public:strict && npm run typecheck && npm test && npm run build && npm run check:pack",
     "prepack": "npm run build",
     "prepublishOnly": "npm run verify:release",
     "capture:fixtures": "tsx scripts/capture-harness-fixtures.ts"

package/smithery.yaml

@@ -7,12 +7,12 @@
 
 name: Open Ephemeris
 description: >
-  NASA JPL DE440-backed astronomical computation engine for AI agents. 90+ typed tools covering
+  NASA JPL DE440-backed astronomical computation engine for AI agents. Typed tools spanning
   natal charts, transit forecasting, Human Design charts, eclipses, astrocartography power
   lines, Venus Star Points, electional timing windows, synastry, composite charts, Vedic
   charts, Chinese BaZi, and more — powered by JPL DE440 ephemerides for sub-arcsecond
   zero-hallucination accuracy. Includes an LLM-optimized output format
-  (format=llm) that compresses chart responses by ~50%. Free Explorer tier available.
+  (format=llm) that compresses chart responses by 50–73%. Free Explorer tier available.
 iconUrl: https://mcp.openephemeris.com/icon.png
 homepage: https://openephemeris.com
 
@@ -38,7 +38,7 @@ configSchema:
         - llm
       description: >
         Default output format for all tools. 'llm' returns compact,
-        token-optimized output (~50% smaller). 'json' returns full verbose JSON.
+        token-optimized output (50–73% smaller). 'json' returns full verbose JSON.
         Individual tool calls can override this setting.
       default: json
     baseUrl:
@@ -49,6 +49,16 @@ configSchema:
         default production endpoint (https://api.openephemeris.com). Useful
         for self-hosted or staging deployments.
       default: ""
+    toolSurface:
+      type: string
+      title: Tool Surface
+      description: >
+        Which tools to advertise. Leave blank for the curated default set,
+        'full' for the whole catalog, or a comma list of traditions —
+        astrology, moon, hd, bazi, vedic, acg, electional, venus — to pay
+        context only for the work you do (e.g. 'hd,bazi'). Every tool stays
+        callable by name regardless of surface.
+      default: ""
 
 # How to start the server locally (stdio transport for Claude Desktop / Cursor)
 startCommand:
@@ -61,5 +71,6 @@ startCommand:
         OPENEPHEMERIS_API_KEY: config.apiKey,
         ...(config.format && config.format !== "json" ? { OPENEPHEMERIS_FORMAT: config.format } : {}),
         ...(config.baseUrl ? { OPENEPHEMERIS_BACKEND_URL: config.baseUrl } : {}),
+        ...(config.toolSurface ? { OPENEPHEMERIS_TOOLS: config.toolSurface } : {}),
       }
     })