@interstellar-tools/mcp 1.1.0 → 1.2.1

package/README.md

@@ -88,8 +88,17 @@ returned as `{ "rad": …, "deg": … }`.
 | `convert_anomaly`            | Mean ↔ eccentric ↔ true anomaly (elliptic orbits)               |
 | `convert_time`               | Duration between units, attoseconds to gigayears                |
 | `convert_distance`           | Distance between units, metres to gigaparsecs                   |
+| `great_circle_distance`      | Distance and central angle between two points on a body         |
+| `horizon_distance`           | How far an observer at a height can see                         |
+| `geodetic_to_body_fixed`     | Body-fixed x, y, z from latitude, longitude and height          |
+| `body_fixed_to_geodetic`     | Latitude, longitude and height from body-fixed x, y, z          |
+| `project_point`              | Map x and y of a point in one of seven projections              |
 | `find_body`                  | Look up planets, moons, stars, comets, … by name or id          |
 
+The geodesy and map tools take the shape of the body as a `body` id from
+`find_body`, such as `"mars"`, or as radii in metres. For GPS coordinates on
+Earth, the ellipsoid tools also take `"wgs84"`.
+
 All tools are pure and offline: no network access, no side effects.
 
 ## Resources

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYpE,eAAO,MAAM,WAAW,uBAAuB,CAAC;AAEhD,kFAAkF;AAClF,eAAO,MAAM,cAAc,EAAE,MAEpB,CAAC;AAEV;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,QAAO,SAkB/B,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAcpE,eAAO,MAAM,WAAW,uBAAuB,CAAC;AAEhD,kFAAkF;AAClF,eAAO,MAAM,cAAc,EAAE,MAEpB,CAAC;AAEV;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,QAAO,SAoB/B,CAAC"}

package/dist/server.js

@@ -3,7 +3,9 @@ import { createRequire } from 'node:module';
 import { registerBodies } from './bodies.js';
 import { registerAnomalyTools } from './tools/anomalies.js';
 import { registerDistanceTools } from './tools/distance.js';
+import { registerGeodesyTools } from './tools/geodesy.js';
 import { registerManoeuvreTools } from './tools/manoeuvres.js';
+import { registerMapTools } from './tools/maps.js';
 import { registerOrbitTools } from './tools/orbits.js';
 import { registerStateVectorTools } from './tools/state-vectors.js';
 import { registerTimeTools } from './tools/time.js';
@@ -32,6 +34,8 @@ export const createServer = () => {
     registerAnomalyTools(server);
     registerTimeTools(server);
     registerDistanceTools(server);
+    registerGeodesyTools(server);
+    registerMapTools(server);
     registerBodies(server);
     return server;
 };

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,CAAC,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAEhD,kFAAkF;AAClF,MAAM,CAAC,MAAM,cAAc,GAAW,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAClE,iBAAiB,CAClB,CAAC,OAAO,CAAC;AAEV;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,GAAc,EAAE;IAC1C,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,EAC9C;QACE,YAAY,EACV,2eAA2e;KAC9e,CACF,CAAC;IAEF,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,cAAc,CAAC,MAAM,CAAC,CAAC;IAEvB,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,CAAC,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAEhD,kFAAkF;AAClF,MAAM,CAAC,MAAM,cAAc,GAAW,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAClE,iBAAiB,CAClB,CAAC,OAAO,CAAC;AAEV;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,GAAc,EAAE;IAC1C,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,EAC9C;QACE,YAAY,EACV,2eAA2e;KAC9e,CACF,CAAC;IAEF,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,cAAc,CAAC,MAAM,CAAC,CAAC;IAEvB,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/dist/tools/geodesy.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const registerGeodesyTools: (server: McpServer) => void;
+//# sourceMappingURL=geodesy.d.ts.map

package/dist/tools/geodesy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geodesy.d.ts","sourceRoot":"","sources":["../../src/tools/geodesy.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiCzE,eAAO,MAAM,oBAAoB,GAAI,QAAQ,SAAS,SAiJrD,CAAC"}

package/dist/tools/geodesy.js

@@ -0,0 +1,109 @@
+import { bodyFixedToGeodetic, centralAngle, eccentricitySquaredOblateSpheroid, geodeticToBodyFixed, horizonDistance, horizonSurfaceDistance } from '@interstellar-tools/equations';
+import { z } from 'zod';
+import { ellipsoidInput, resolveEllipsoid, resolveSphere, sphereInput } from './shape.js';
+import { angleOutput, angleOutputSchema, angleSchema, PURE_TOOL, result, toRadians, vectorOutputSchema, vectorSchema } from './shared.js';
+const latitudeSchema = (which) => angleSchema.describe(`Latitude${which}, north positive, in [-90°, 90°], e.g. { "value": 18.44, "unit": "deg" }.`);
+const longitudeSchema = (which) => angleSchema.describe(`Longitude${which}, east positive, e.g. { "value": 77.45, "unit": "deg" }.`);
+const ellipsoidOutput = {
+    equatorial_radius_m: z.number(),
+    polar_radius_m: z.number()
+};
+export const registerGeodesyTools = (server) => {
+    server.registerTool('great_circle_distance', {
+        title: 'Great-circle distance',
+        description: 'Shortest distance between two points along the surface of a sphere, and the central angle between them, from their latitudes and longitudes. Uses the body’s mean radius; on an oblate body like Earth the error is up to about 0.5%.',
+        inputSchema: {
+            from_latitude: latitudeSchema(' of the first point'),
+            from_longitude: longitudeSchema(' of the first point'),
+            to_latitude: latitudeSchema(' of the second point'),
+            to_longitude: longitudeSchema(' of the second point'),
+            ...sphereInput
+        },
+        outputSchema: {
+            distance_m: z.number(),
+            central_angle: angleOutputSchema,
+            radius_m: z.number()
+        },
+        annotations: PURE_TOOL
+    }, ({ from_latitude, from_longitude, to_latitude, to_longitude, ...shape }) => {
+        const radius_m = resolveSphere(shape);
+        const angle = centralAngle(toRadians(from_latitude), toRadians(from_longitude), toRadians(to_latitude), toRadians(to_longitude));
+        return result({
+            distance_m: radius_m * angle,
+            central_angle: angleOutput(angle),
+            radius_m
+        });
+    });
+    server.registerTool('horizon_distance', {
+        title: 'Distance to the horizon',
+        description: 'How far an observer at a height above a sphere can see: the straight-line distance to the horizon, and the distance along the surface to it. No atmospheric refraction.',
+        inputSchema: {
+            height_m: z
+                .number()
+                .nonnegative()
+                .describe('Height of the observer above the surface, in metres.'),
+            ...sphereInput
+        },
+        outputSchema: {
+            distance_m: z.number(),
+            surface_distance_m: z.number(),
+            radius_m: z.number()
+        },
+        annotations: PURE_TOOL
+    }, ({ height_m, ...shape }) => {
+        const radius_m = resolveSphere(shape);
+        return result({
+            distance_m: horizonDistance(height_m, radius_m),
+            surface_distance_m: horizonSurfaceDistance(height_m, radius_m),
+            radius_m
+        });
+    });
+    server.registerTool('geodetic_to_body_fixed', {
+        title: 'Geodetic to body-fixed coordinates',
+        description: 'Body-fixed Cartesian position [x, y, z] of a point given by geodetic latitude, longitude and height above an oblate ellipsoid. x points to latitude 0, longitude 0; z to the north pole. On Earth, use body "wgs84" for GPS coordinates.',
+        inputSchema: {
+            latitude: latitudeSchema(' (geodetic)'),
+            longitude: longitudeSchema(''),
+            height_m: z
+                .number()
+                .finite()
+                .describe('Height above the ellipsoid, in metres.'),
+            ...ellipsoidInput
+        },
+        outputSchema: { r_m: vectorOutputSchema, ...ellipsoidOutput },
+        annotations: PURE_TOOL
+    }, ({ latitude, longitude, height_m, ...shape }) => {
+        const { a, c } = resolveEllipsoid(shape);
+        return result({
+            r_m: geodeticToBodyFixed(toRadians(latitude), toRadians(longitude), height_m, a, eccentricitySquaredOblateSpheroid(a, c)),
+            equatorial_radius_m: a,
+            polar_radius_m: c
+        });
+    });
+    server.registerTool('body_fixed_to_geodetic', {
+        title: 'Body-fixed to geodetic coordinates',
+        description: 'Geodetic latitude, longitude and height above an oblate ellipsoid, from a body-fixed Cartesian position [x, y, z]. The inverse of geodetic_to_body_fixed. On Earth, use body "wgs84" for GPS coordinates.',
+        inputSchema: {
+            r_m: vectorSchema('Body-fixed position [x, y, z], in metres.'),
+            ...ellipsoidInput
+        },
+        outputSchema: {
+            latitude: angleOutputSchema,
+            longitude: angleOutputSchema,
+            height_m: z.number(),
+            ...ellipsoidOutput
+        },
+        annotations: PURE_TOOL
+    }, ({ r_m, ...shape }) => {
+        const { a, c } = resolveEllipsoid(shape);
+        const { phi, lambda, h } = bodyFixedToGeodetic(...r_m, a, eccentricitySquaredOblateSpheroid(a, c));
+        return result({
+            latitude: angleOutput(phi),
+            longitude: angleOutput(lambda),
+            height_m: h,
+            equatorial_radius_m: a,
+            polar_radius_m: c
+        });
+    });
+};
+//# sourceMappingURL=geodesy.js.map

package/dist/tools/geodesy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geodesy.js","sourceRoot":"","sources":["../../src/tools/geodesy.ts"],"names":[],"mappings":"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"}

package/dist/tools/maps.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const registerMapTools: (server: McpServer) => void;
+//# sourceMappingURL=maps.d.ts.map

package/dist/tools/maps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maps.d.ts","sourceRoot":"","sources":["../../src/tools/maps.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA+BzE,eAAO,MAAM,gBAAgB,GAAI,QAAQ,SAAS,SAuEjD,CAAC"}

package/dist/tools/maps.js

@@ -0,0 +1,61 @@
+import { equirectangular, lambertAzimuthalEqualArea, mercator, mollweide, orthographic, sinusoidal, stereographic } from '@interstellar-tools/maps';
+import { z } from 'zod';
+import { resolveSphere, sphereInput } from './shape.js';
+import { angleSchema, PURE_TOOL, result, toRadians } from './shared.js';
+const PROJECTIONS = {
+    equirectangular,
+    mercator,
+    sinusoidal,
+    mollweide,
+    lambert_azimuthal_equal_area: lambertAzimuthalEqualArea,
+    stereographic,
+    orthographic
+};
+const PROJECTION_NAMES = Object.keys(PROJECTIONS);
+// The projections that take a centre latitude, and the one with a standard
+// parallel
+const CENTRED = new Set([
+    'equirectangular',
+    'lambert_azimuthal_equal_area',
+    'stereographic',
+    'orthographic'
+]);
+export const registerMapTools = (server) => {
+    server.registerTool('project_point', {
+        title: 'Project a point onto a map',
+        description: 'Map coordinates x (east) and y (north), in metres on a sphere, of a latitude and longitude in one of seven projections. equirectangular: plain latitude–longitude grid, as most planetary maps use. mercator: keeps angles, for navigation and web maps; no poles. sinusoidal and mollweide: keep areas, whole-world maps. lambert_azimuthal_equal_area: keeps areas around a centre point. stereographic: keeps angles around a centre point, for polar maps. orthographic: the globe as seen from far away; only the near hemisphere.',
+        inputSchema: {
+            projection: z.enum(PROJECTION_NAMES).describe('The map projection.'),
+            latitude: angleSchema.describe('Latitude of the point, north positive, in [-90°, 90°].'),
+            longitude: angleSchema.describe('Longitude of the point, east positive.'),
+            ...sphereInput,
+            center_longitude: angleSchema
+                .optional()
+                .describe('Longitude of the map’s centre (the central meridian). Defaults to 0.'),
+            center_latitude: angleSchema
+                .optional()
+                .describe('Latitude of the map’s centre, for equirectangular and the azimuthal projections (lambert_azimuthal_equal_area, stereographic, orthographic); 90° gives a north polar map. Defaults to 0.'),
+            standard_parallel: angleSchema
+                .optional()
+                .describe('For equirectangular only: the latitude where the map is true to scale east–west, often the latitude of the area mapped. Defaults to 0, the equator.')
+        },
+        outputSchema: { x_m: z.number(), y_m: z.number(), radius_m: z.number() },
+        annotations: PURE_TOOL
+    }, ({ projection, latitude, longitude, center_longitude, center_latitude, standard_parallel, ...shape }) => {
+        if (center_latitude && !CENTRED.has(projection))
+            throw new Error(`${projection} has no center_latitude: it is centred on the equator.`);
+        if (standard_parallel && projection !== 'equirectangular')
+            throw new Error('Only equirectangular takes a standard_parallel.');
+        const radius_m = resolveSphere(shape);
+        const options = {};
+        if (center_longitude)
+            options.lambda0 = toRadians(center_longitude);
+        if (center_latitude)
+            options.phi0 = toRadians(center_latitude);
+        if (standard_parallel)
+            options.phi1 = toRadians(standard_parallel);
+        const { x, y } = PROJECTIONS[projection](toRadians(latitude), toRadians(longitude), radius_m, options);
+        return result({ x_m: x, y_m: y, radius_m });
+    });
+};
+//# sourceMappingURL=maps.js.map

package/dist/tools/maps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"maps.js","sourceRoot":"","sources":["../../src/tools/maps.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,UAAU,EACV,aAAa,EACd,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExE,MAAM,WAAW,GAAG;IAClB,eAAe;IACf,QAAQ;IACR,UAAU;IACV,SAAS;IACT,4BAA4B,EAAE,yBAAyB;IACvD,aAAa;IACb,YAAY;CACJ,CAAC;AAIX,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAG/C,CAAC;AACF,2EAA2E;AAC3E,WAAW;AACX,MAAM,OAAO,GAAG,IAAI,GAAG,CAAqB;IAC1C,iBAAiB;IACjB,8BAA8B;IAC9B,eAAe;IACf,cAAc;CACf,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAiB,EAAE,EAAE;IACpD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,4BAA4B;QACnC,WAAW,EACT,ygBAAygB;QAC3gB,WAAW,EAAE;YACX,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,QAAQ,CAAC,qBAAqB,CAAC;YACpE,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAC5B,wDAAwD,CACzD;YACD,SAAS,EAAE,WAAW,CAAC,QAAQ,CAC7B,wCAAwC,CACzC;YACD,GAAG,WAAW;YACd,gBAAgB,EAAE,WAAW;iBAC1B,QAAQ,EAAE;iBACV,QAAQ,CACP,sEAAsE,CACvE;YACH,eAAe,EAAE,WAAW;iBACzB,QAAQ,EAAE;iBACV,QAAQ,CACP,0LAA0L,CAC3L;YACH,iBAAiB,EAAE,WAAW;iBAC3B,QAAQ,EAAE;iBACV,QAAQ,CACP,qJAAqJ,CACtJ;SACJ;QACD,YAAY,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;QACxE,WAAW,EAAE,SAAS;KACvB,EACD,CAAC,EACC,UAAU,EACV,QAAQ,EACR,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,GAAG,KAAK,EACT,EAAE,EAAE;QACH,IAAI,eAAe,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;YAC7C,MAAM,IAAI,KAAK,CACb,GAAG,UAAU,wDAAwD,CACtE,CAAC;QAEJ,IAAI,iBAAiB,IAAI,UAAU,KAAK,iBAAiB;YACvD,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QAErE,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,OAAO,GAA0D,EAAE,CAAC;QAE1E,IAAI,gBAAgB;YAAE,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAEpE,IAAI,eAAe;YAAE,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,eAAe,CAAC,CAAC;QAE/D,IAAI,iBAAiB;YAAE,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAEnE,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,WAAW,CAAC,UAAU,CAAC,CACtC,SAAS,CAAC,QAAQ,CAAC,EACnB,SAAS,CAAC,SAAS,CAAC,EACpB,QAAQ,EACR,OAAO,CACR,CAAC;QAEF,OAAO,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC9C,CAAC,CACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/tools/shape.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+/** A body or a radius in metres: the sphere tools take one of them. */
+export declare const sphereInput: {
+    body: z.ZodOptional<z.ZodString>;
+    radius_m: z.ZodOptional<z.ZodNumber>;
+};
+/** A body or two radii in metres: the ellipsoid tools take one of them. */
+export declare const ellipsoidInput: {
+    body: z.ZodOptional<z.ZodString>;
+    equatorial_radius_m: z.ZodOptional<z.ZodNumber>;
+    polar_radius_m: z.ZodOptional<z.ZodNumber>;
+};
+/** The radius of a sphere, from a body's mean radius or a given radius. */
+export declare const resolveSphere: ({ body, radius_m }: {
+    body?: string;
+    radius_m?: number;
+}) => number;
+/** The radii of an oblate ellipsoid, from a body or given radii. */
+export declare const resolveEllipsoid: ({ body, equatorial_radius_m, polar_radius_m }: {
+    body?: string;
+    equatorial_radius_m?: number;
+    polar_radius_m?: number;
+}) => {
+    a: number;
+    c: number;
+};
+//# sourceMappingURL=shape.d.ts.map

package/dist/tools/shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape.d.ts","sourceRoot":"","sources":["../../src/tools/shape.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgBxB,uEAAuE;AACvE,eAAO,MAAM,WAAW;;;CASvB,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,cAAc;;;;CAc1B,CAAC;AAsBF,2EAA2E;AAC3E,eAAO,MAAM,aAAa,GAAI,oBAG3B;IACD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,KAAG,MAcH,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,gBAAgB,GAAI,+CAI9B;IACD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,KAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CA4CzB,CAAC"}

package/dist/tools/shape.js

@@ -0,0 +1,81 @@
+import { WGS84 } from '@interstellar-tools/constants';
+import { convertDistanceUnit } from '@interstellar-tools/equations';
+import { z } from 'zod';
+import { DATASETS } from '../bodies.js';
+// The shape of a body, from the datasets or given in metres, for the geodesy
+// and map tools
+const describeBody = (extra) => z
+    .string()
+    .min(1)
+    .optional()
+    .describe(`Body id from find_body, such as "earth", "mars" or "moon"${extra}. Give this or the radius in metres, not both.`);
+/** A body or a radius in metres: the sphere tools take one of them. */
+export const sphereInput = {
+    body: describeBody(''),
+    radius_m: z
+        .number()
+        .positive()
+        .optional()
+        .describe('Radius of the sphere, in metres. Earth’s mean radius is 6371008.4.')
+};
+/** A body or two radii in metres: the ellipsoid tools take one of them. */
+export const ellipsoidInput = {
+    body: describeBody(', or "wgs84" for the ellipsoid GPS uses'),
+    equatorial_radius_m: z
+        .number()
+        .positive()
+        .optional()
+        .describe('Equatorial radius a of the ellipsoid, in metres.'),
+    polar_radius_m: z
+        .number()
+        .positive()
+        .optional()
+        .describe('Polar radius c of the ellipsoid, in metres, no larger than the equatorial radius.')
+};
+const metres = (distance) => convertDistanceUnit(distance, 'm').value;
+const findBody = (id) => {
+    const needle = id.trim().toLowerCase();
+    for (const { data } of Object.values(DATASETS))
+        for (const body of data)
+            if (body.id === needle)
+                return body;
+    throw new Error(`Unknown body: ${id}. Use the id that find_body returns, such as "mars".`);
+};
+/** The radius of a sphere, from a body's mean radius or a given radius. */
+export const resolveSphere = ({ body, radius_m }) => {
+    if ((body === undefined) === (radius_m === undefined))
+        throw new Error('Give either body or radius_m.');
+    if (radius_m !== undefined)
+        return radius_m;
+    const found = findBody(body);
+    if (!found.radius)
+        throw new Error(`${found.id} has no radius in the datasets: give radius_m.`);
+    return metres(found.radius);
+};
+/** The radii of an oblate ellipsoid, from a body or given radii. */
+export const resolveEllipsoid = ({ body, equatorial_radius_m, polar_radius_m }) => {
+    const radii = [equatorial_radius_m, polar_radius_m].filter((r) => r !== undefined).length;
+    if (body !== undefined && radii > 0)
+        throw new Error('Give either body or equatorial_radius_m and polar_radius_m, not both.');
+    if (body === undefined) {
+        if (radii < 2)
+            throw new Error('Give either body, or both equatorial_radius_m and polar_radius_m.');
+        if (polar_radius_m > equatorial_radius_m)
+            throw new Error('polar_radius_m must be no larger than equatorial_radius_m: the tools take an oblate ellipsoid.');
+        return { a: equatorial_radius_m, c: polar_radius_m };
+    }
+    const found = body.trim().toLowerCase() === 'wgs84'
+        ? { id: 'wgs84', ellipsoid: WGS84 }
+        : findBody(body);
+    if (found.ellipsoid?.alongOrbitRadius)
+        throw new Error(`${found.id} is a triaxial ellipsoid, and geodetic coordinates need an oblate one. To approximate it, give equatorial_radius_m and polar_radius_m.`);
+    if (found.ellipsoid)
+        return {
+            a: metres(found.ellipsoid.equatorialRadius),
+            c: metres(found.ellipsoid.polarRadius)
+        };
+    // No measured shape: a sphere of the mean radius
+    const r = resolveSphere({ body });
+    return { a: r, c: r };
+};
+//# sourceMappingURL=shape.js.map

package/dist/tools/shape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape.js","sourceRoot":"","sources":["../../src/tools/shape.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@interstellar-tools/mcp",
-  "version": "1.1.0",
-  "description": "Model Context Protocol (MCP) server exposing interstellar-tools orbital mechanics equations and celestial body datasets to AI assistants.",
+  "version": "1.2.1",
+  "description": "Model Context Protocol (MCP) server exposing interstellar-tools orbital mechanics, geodesy and map projection calculations and celestial body datasets to AI assistants.",
   "keywords": [
     "mcp",
     "model-context-protocol",
@@ -52,15 +52,16 @@
     "start": "node dist/bin.js",
     "test": "tsx --test **/__tests__/**/*.spec.ts",
     "pretest:ci": "rm -rf coverage && mkdir -p coverage",
-    "test:ci": "glob-bin -c \"node --import tsx --test --no-warnings --experimental-test-coverage --test-reporter=cobertura --test-reporter-destination=coverage/cobertura-coverage.xml --test-reporter=spec --test-reporter-destination=stdout\" \"**/__tests__/**/*.spec.ts\""
+    "test:ci": "glob-bin -c \"node --import tsx --test --no-warnings --experimental-test-coverage --test-coverage-include='src/**' --test-coverage-exclude='**/__tests__/**' --test-coverage-lines=98.9 --test-coverage-branches=91.7 --test-coverage-functions=93.6 --test-reporter=cobertura --test-reporter-destination=coverage/cobertura-coverage.xml --test-reporter=spec --test-reporter-destination=stdout\" \"**/__tests__/**/*.spec.ts\""
   },
   "dependencies": {
-    "@interstellar-tools/constants": "^1.0.0",
+    "@interstellar-tools/constants": "^1.1.1",
     "@interstellar-tools/equations": "^1.8.0",
+    "@interstellar-tools/maps": "^0.11.0",
     "@interstellar-tools/temporal": "^1.0.0",
     "@interstellar-tools/types": "^1.0.0",
-    "@modelcontextprotocol/sdk": "1.32.2",
-    "zod": "4.6.7"
+    "@modelcontextprotocol/sdk": "^1.32.2",
+    "zod": "^4.6.7"
   },
   "devDependencies": {
     "@types/node": "^24.19.2",