Mapsmith MCP Server - install, status & alternatives [2026]

01 · Install Mapsmith

Claude Code

claude mcp add mapsmith-ai-mapsmith -- uvx mapsmith

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "mapsmith-ai-mapsmith": {
      "command": "uvx",
      "args": [
        "mapsmith"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions · container (OCI image) - can be sandboxed away from your filesystem

repo age created 2026-08-18 - young repo, little track record yet

license AGPL-3.0 - declared in the repository

pypi package mapsmith - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.mapsmith-ai is GitHub-verified and matches the repo owner

03 · What Mapsmith can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can validate then run a plan step by step, with per-step provenance and a plan-level manifest, read the manifest of any MapSmith output: one operation, its inputs and their digests, and what was checked, and run any catalog operation by name, including those with no tool of their own.

Capability map

Tools grouped from the project's README - what Mapsmith lets an agent do.

read & search

3 tools - e.g. CRS, schema/bands, extent, nodata and statistics of any vector or raster dataset; Return the manifest of any MapSmith output: one operation, its inputs and their digests, and what was checked; Catalog…

describe_dataset · get_provenance · list_operations

run & execute

3 tools - e.g. Spatial SQL (DuckDB dialect) over GeoParquet and GDAL formats; Validate then run a plan step by step, with per-step provenance and a plan-level manifest; Run any catalog operation by name, including those…

run_sql · execute_plan · run_operation

Buffer

1 tool - e.g. Metric buffer with automatic UTM estimation for geographic CRS

buffer_layer

Clip

1 tool - e.g. Clip a layer with a mask layer

clip_layer

Overlay

1 tool - e.g. Set-theoretic overlay (intersection/union/difference/…); dropped lower-dimension pieces are declared in the manifest

overlay_layers

Dissolve

1 tool - e.g. Merge features per key; the aggregation is recorded in the manifest and the group count verified

dissolve_layer

Nearest

1 tool - e.g. Nearest neighbour with the distance in meters, UTM-measured on geographic CRS (decision recorded)

nearest_join

Explode

1 tool - e.g. Multi-part to single-part, with the part count verified in closed form

explode_layer

Latest releases

v0.7.1 · 2026-09-26

Two fixes from the pre-release audit of 0.7.0, both present in earlier releases, · and the Argleton run scored against trap 024's corrected truth, which arrived · after the 0.7.0 tag: that release's PyPI page still…

v0.7.0 · 2026-09-26

This release changes answers earlier releases gave, and that comes first. · From 0.4.0 to 0.6.1 every position MapSmith read from a point-registered raster · (AREA_OR_POINT=Point - the USGS elevation products and the…

v0.6.1 · 2026-09-25

A small release on the day of 0.6.0. It moves no manifest key and changes no · answer that 0.6.0 got right: it stops a refusal 0.6.0 introduced from firing on · a layer written in 0..360 longitudes, gives two refusals…

04 · Who maintains Mapsmith

mapsmith is maintained by mapsmith-ai. It's the only MCP server we track from this author; the repo dates to Aug 2026.

05 · Facts

repository: github.com/mapsmith-ai/mapsmith
website: https://github.com/mapsmith-ai/MapSmith
category: database - ranked #68 of 174 actively-maintained database servers as of 2026-09-30.
release cadence: 10+ releases in the last 90 days (latest 2026-09-26)
registry: io.github.mapsmith-ai/mapsmith (active, first published 2026-08-20 · 10 versions)
packages: pypi:mapsmith · oci:ghcr.io/mapsmith-ai/mapsmith:0.7.1

06 · Mapsmith FAQ

Is Mapsmith still maintained?

Yes - as of 2026-09-30, its last commit was 2026-09-29 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

What can Mapsmith do?

With this server connected, an agent can validate then run a plan step by step, with per-step provenance and a plan-level manifest, read the manifest of any MapSmith output: one operation, its inputs and their digests, and what was checked, and run any catalog operation by name, including those with no tool of their own.

How do I install Mapsmith?

Run `uvx mapsmith`. You can also paste the ready-made client config above.

Does Mapsmith run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Mapsmith

Alternatives to Mapsmith

Maintained database servers if Mapsmith isn't the fit.

Pairs well with

Servers that cover what Mapsmith doesn't - only shown when the pairing reason fits the companion.

More database MCP servers · Oracle · Mq Bridge App · NeKo Biological Network Builder · Server Spreadsheet · Sql Augur

More Python MCP servers · Tinysearch · MaBoSS Boolean Network Simulator · PhysiCell Configuration Builder · see all