geoprimsField-grade geospatial math

Use with agents

geoprims runs as a local MCP server, so an AI agent gets the same calculators and the same answers as this site. It runs on your machine over stdio, has no npm dependencies, and stays offline unless you explicitly allow verified optional-data downloads.

Get the server

Clone the v0.1.0 release. It carries the built calculators, so it runs with Node 22 or newer and nothing else. Then replace /abs/path/geoprims below with your clone's path.

git clone --branch v0.1.0 --depth 1 https://github.com/clay-good/geoprims

Or download the release as a zip from GitHub. Claude Desktop can also install thegeoprims-0.1.0.mcpb file from the same page in one click. To build from source instead, clonemain and run npm run build (it needs Rust via rustup and binaryen wasm-opt).

Add it to your client

Claude Code

Run in a terminal

claude mcp add geoprims -- node /abs/path/geoprims/mcp/server.mjs

Claude Desktop

Settings, Developer, Edit Config: claude_desktop_config.json

{
  "mcpServers": {
    "geoprims": {
      "command": "node",
      "args": [
        "/abs/path/geoprims/mcp/server.mjs"
      ]
    }
  }
}

VS Code

.vscode/mcp.json in your workspace

{
  "servers": {
    "geoprims": {
      "type": "stdio",
      "command": "node",
      "args": [
        "/abs/path/geoprims/mcp/server.mjs"
      ]
    }
  }
}

Cursor

.cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "geoprims": {
      "command": "node",
      "args": [
        "/abs/path/geoprims/mcp/server.mjs"
      ]
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "geoprims": {
      "command": "node",
      "args": [
        "/abs/path/geoprims/mcp/server.mjs"
      ]
    }
  }
}

What the agent sees

Six tools that reach every calculator, so the tool list stays small:

Results are the same envelope this site computes, byte for byte, with the plain-language summary, the model, accuracy, and warnings. Aviation, drone, navigation, and magnetic results also carry the notice that they are planning aids and not for primary navigation.

Equipment profiles exported from this site (a geoprims-profile file for an aircraft, drone, camera, lidar sensor, GNSS receiver, or radio) can be passed inline as the profile argument of geoprims_run. The profile fills the equipment inputs your args leave out, meta.profileFilled names them, and the server keeps nothing between calls.

Workflow prompts

Options

OptionEffect
--toolsets=<name,...>Also lists each stable tool in the named toolsets as its own tool, named gp_ plus the id with dots as underscores.
--no-metaWith --toolsets, lists only those tools.
--timeout=<ms>Per-call time limit (default 10,000).
--debugLogs argument values to stderr (off by default).
--allow-asset-downloadFetches a missing registered data file only from the geoprims asset origin, verifies it, and keeps it in the operating system's cache for offline reuse. Without the flag, the server names the missing file and its size.

Toolsets

Only stable tools join a toolset, so toolsets grow as tools are promoted.

ToolsetTools now
geodesy-coreHelmert transformation (7 or 14 parameters), Transform between ITRF and WGS 84 realizations, Legacy datum to or from WGS 84, Transform between NAD 83 and ITRF or WGS 84, Old US datums to NAD 83 (NADCON5), Move a position between epochs (ITRF2020 plate motion), Transform between reference frames, Auxiliary latitudes, Length of a degree of latitude and longitude, Meridian arc length, Ellipsoid parameters, Radii of curvature and degree lengths, Azimuth, elevation, and range to east, north, up, ECEF to latitude, longitude, and height, ENU and NED frame converter, East, north, up to azimuth, elevation, and range, Local ENU, NED, or AER to point, Latitude, longitude, and height to ECEF, ECEF to local frame rotation matrix, Point to local ENU, NED, and AER, Latitude and longitude to GARS, GARS to latitude and longitude, Latitude and longitude to GEOREF, GEOREF to latitude and longitude, Grid zone and 100 km square in MGRS, Latitude and longitude to Maidenhead locator, Maidenhead locator to latitude and longitude, Latitude and longitude to MGRS, MGRS to latitude and longitude, Precision of an MGRS reference, Latitude and longitude to USNG, USNG to latitude and longitude, Latitude and longitude to UPS, UPS to latitude and longitude, Latitude and longitude to UTM, UTM to latitude and longitude, UTM zone and band lookup
coordinate-notationAdd and subtract DMS angles, Difference between two bearings, Read any coordinate, Format a coordinate, Coordinates in decimal degrees, Coordinates in degrees and decimal minutes, Coordinates in degrees, minutes, and seconds, Degrees and decimal minutes to decimal degrees, Degrees, minutes, and seconds to decimal degrees
heightsGeoid height (EGM96), Ellipsoidal and orthometric height, Ellipsoidal height to orthometric height, Orthometric height to ellipsoidal height
magneticMagnetic declination, Grid variation (grivation), Isogonic lines and compass zones, Magnetic bearing to true bearing, Compare WMM and IGRF declination, True and magnetic bearings, Compass reliability zone
projectionsLatitude and longitude to Albers Equal Area, Albers Equal Area to latitude and longitude, Arc-to-chord correction (t − T), Latitude and longitude to Azimuthal Equidistant, Azimuthal Equidistant to latitude and longitude, Grid convergence in UTM, Latitude and longitude to Equidistant Cylindrical, Equidistant Cylindrical to latitude and longitude, Latitude and longitude to Gnomonic, Gnomonic to latitude and longitude, Latitude and longitude to Hotine Oblique Mercator, Hotine Oblique Mercator to latitude and longitude, Latitude and longitude to Lambert Conformal Conic, Lambert Conformal Conic to latitude and longitude, Latitude and longitude to Orthographic, Orthographic to latitude and longitude, Latitude and longitude to Polar Stereographic, Polar Stereographic to latitude and longitude, Point scale factor in UTM, Latitude and longitude to exact Transverse Mercator, Exact Transverse Mercator to latitude and longitude, Latitude and longitude to Transverse Mercator, Transverse Mercator to latitude and longitude, Latitude and longitude to Web Mercator, Web Mercator to latitude and longitude, Latitude and longitude to state plane (SPCS2022 beta), State plane (SPCS2022 beta) to latitude and longitude, Latitude and longitude to state plane (SPCS83), State plane (SPCS83) to latitude and longitude, State plane zone lookup, Latitude and longitude to UPS, UPS to latitude and longitude, Latitude and longitude to UTM, UTM to latitude and longitude, UTM zone and band lookup
navigationCelestial almanac (GHA and declination), Sextant altitude corrections, step by step, Sight reduction by the intercept method, Destination from a start, course, and distance (geodesic), Haversine distance (spherical), Point part way along a great circle, Where two geodesic segments cross, Distance between two points (geodesic), Midpoint on the geodesic, Great-circle destination (spherical), Great-circle distance and course (spherical), Highest point of a geodesic (vertex), Vincenty direct (legacy), Vincenty inverse (legacy), Waypoints along a route line, Dip of the horizon, Fresnel zone and radio link clearance, Distance to the horizon, Can two points see each other?, Current triangle (set and drift), Destination on a constant course (rhumb line), Rhumb line distance and course, Closest point on a route, Where two courses cross, Closest point of approach, Cross-track and along-track distance, Fly-by turn anticipation, Intercept a moving target, Route legs, courses, and totals, Range rings, Time, speed, and distance, Plane sailing, Tidal datum conversion, Tide prediction from harmonic constituents, 3D distance between two points, Look angles to a target, Vector sum, dot, and cross product, Vector components and direction
geometryPolygon area and perimeter on the ellipsoid, Buffer a point, line, or polygon, Compare two tracks, Delaunay triangulation of points, Voronoi cells around points, Overlap, union, or difference of two polygons, Point in polygon, How two shapes relate, Bounding box, antimeridian-aware, Polygon centroid and interior point, Add vertices along geodesic edges (densify), Hull, bounding rectangle, and enclosing circle, Simplify a line or polygon (Douglas-Peucker), Simplify a line or polygon (Visvalingam), Check and repair a polygon
e6bTrue airspeed from indicated or calibrated airspeed, Equivalent airspeed to Mach, Equivalent to true airspeed, Indicated to equivalent airspeed, Indicated airspeed to Mach, Indicated to true airspeed, Mach to equivalent airspeed, Calibrated airspeed from true airspeed, Mach, or EAS, True to equivalent airspeed, Total and static air temperature, Cabin altitude from pressure differential, Cold temperature altitude correction, Density altitude, Flight level and altitude, ISA temperature and deviation, Pressure altitude, Height per hectopascal and per inch of mercury, QNH, QFE, and QNE, True altitude, Climb gradient and vertical speed, Climb to cruise: time, fuel, and distance, Climb requirement check, Equal time point and point of no return, Glide range with wind, Tire hydroplaning speed, Pivotal altitude, Specific range, Top of descent, Turn performance and load factor, Visual descent point, Winds aloft between levels, Rank runways for the wind, Wind triangle: course and groundspeed from a heading, Wind triangle: find the wind, True course to compass heading, Wind triangle: heading and groundspeed, Off-course correction (1-in-60), Runway wind components, Wind triangle: airspeed and heading for a groundspeed, Wind components (u and v)
atmosphereCabin altitude from pressure differential, Cold temperature altitude correction, Density altitude, Flight level and altitude, ISA temperature and deviation, Pressure altitude, Height per hectopascal and per inch of mercury, QNH, QFE, and QNE, True altitude, Cloud base and freezing level, Humidity and moist air, Standard atmosphere, The four aviation nights, Sunrise, sunset, and twilight, Sun hotspot in a camera frame, Mapping light window, Night passenger currency, Sun position (azimuth and elevation)
drone-mappingCorridor mapping lines, Export a mission (KML, GeoJSON, CSV), Facade scan, Geofence around an area, Orbit around a point of interest, Flight path statistics, Mission sorties and battery swaps, Survey grid (lawnmower pattern), Height for a target GSD, ASPRS accuracy (Edition 2), ASPRS checkpoint requirements, Sensor crop factor, Image footprint on the ground, GCP and checkpoint plan, Ground sampling distance (GSD), Image count and survey size, Flight line spacing for a side overlap, Slowest shutter speed for sharp mapping photos, Motion blur and slowest shutter, Oblique GSD and footprint, Height from stereo parallax, Photo scale and flying height, Relief displacement and object height, Overlap over high terrain, Overlap, trigger interval, and line spacing, Photo spacing for a front overlap, Camera trigger interval
drone-opsRadio link budget, EASA open subcategory, Drone impact kinetic energy, Part 107 maximum altitude, Part 107 groundspeed check, Visual line of sight over a mission, Wind limit at flying height, Battery energy (mAh to Wh), Battery C-rate for a power draw, Calibrate hover power from a test flight, Rotor disk area and disk loading, Drone flight time, Multirotor hover power, Maximum payload for a flight time, What a payload costs in flight time, Drone range, Return-to-home energy budget, Dataset size estimate, Lidar mission planning, Thermal pixel footprint, Visual line of sight distance
survey-cogoAngular closure of a loop traverse, Area by coordinates (acreage), Azimuth and bearing converter, Bearing-bearing intersection, Bowditch traverse adjustment, Survey bearing and azimuth converter, Coordinates from a bearing and distance, Intersection (bearings and distances), Inverse between two coordinates, Perpendicular foot and station, Point from station and offset, Station and offset from a line, Traverse closure and adjustment, Horizontal circular curve, Curve stationing (PC and PT), Degree of curve converter, Vertical curve length for sight distance, Unequal-tangent vertical curve, Vertical curve, Vertical curve high or low point, Average end area volume, Side slope and grade (H:V), Rise, run, and slope length, Slope stake (catch point), Antenna height from a slant measurement, GPS satellite visibility and DOP, Site localization (calibration), OPUS session planning, RTK and PPK precision budget, ALTA/NSPS relative positional precision, Deed plot, closure, and area, Legacy land units, Combined scale factor (grid and ground), Curvature and refraction correction, Elevation factor, Grid distance to ground distance, Ground distance to grid distance, Level run reduction and closure, Slope distance to horizontal and vertical
indexingOne place in every index, at a matched cell size, Geohashes covering an area, Geohash decoder, Geohash encoder, Geohash neighbors, Plus Code decoder, Plus Code encoder, Shorten a Plus Code, S2 cell area, S2 cell details, S2 cells covering a region, S2 cell hierarchy, S2 cell for a point, S2 edge neighbours, S2 token and cell id, S2 cell vertices, Map tile bounds, Map tiles covering a box, Map tile parent and children, Map tile for a point (XYZ, TMS, quadkey), Map ground resolution and scale, Map tile to quadkey and back, XYZ and TMS tile numbering
h3H3 base cell, H3 cell area, H3 cell boundary, H3 cell inspector, H3 cell to latitude and longitude, H3 local IJ for a cell (cellToLocalIj), H3 cell set outline (cellsToMultiPolygon), H3 center child, H3 child position, H3 children cells, H3 compact, H3 directed edges, H3 edge length, H3 edges and vertexes, H3 grid disk (k-ring), H3 grid distance, H3 grid path and distance, H3 grid ring, H3 resolution class check, Is this H3 cell a pentagon?, H3 cell for a point, H3 cell at local IJ (localIjToCell), H3 parent cell, H3 polygon fill (polygonToCells), H3 cell resolution, H3 resolution chooser, H3 uncompact, Validate an H3 index, H3 vertexes

Offline

The magnetic models (WMM2025 and IGRF-14), the EGM96 geoid, the leap-second table, and the time zone rules are built into the modules, so every tool works with no connection.