PlaceRoot

Ground AI agents in open map data.

PlaceRoot is an MCP server that answers spatial questions from Overture Maps — no API key, no signup, no vendor platform.

  • Answers, not data dumps. Every tool returns compact, ranked results sized for an agent's context window — never a raw GeoJSON dump.
  • Rich, fresh place data. Operating status, confidence scores, and brands, sourced from Overture's open dataset (contributed by Meta, Uber, TomTom, and others).
  • Zero setup. Reads Overture's public data directly — nothing to install beyond the server itself, no key, no database.

Quick start

Add to Claude Desktop / Claude Code:

{
  "mcpServers": {
    "placeroot": {
      "command": "uvx",
      "args": ["placeroot"]
    }
  }
}

Or run it directly:

uvx placeroot             # stdio MCP server
uvx placeroot --http      # HTTP endpoint at http://127.0.0.1:8321/mcp

What it can do

Tool Answers
find_places Named places near a point, nearest first, with category, confidence, and operating status
summarize_area What's in an area: total places and top categories
place_details One place in full: addresses, contacts, brand, sources, confidence
admin_lookup The admin hierarchy containing a point: neighborhood up to country
compare_areas 2–5 areas side by side: category mix, density, and what differs most
within_distance Is the nearest matching place within N meters of a point?
geocode Free-text place name → ranked candidates with coordinates and admin context
resolve_place Free-text place reference → stable ids an agent can hold onto across turns
reverse_geocode Point → nearest address plus its containing admin areas
summarize_buildings Building stock in an area: count, footprint area, height and use mix
buildings_at Nearest building footprints to a point
isochrone The area reachable within N minutes on foot, bike, or car
render_map Any result → a self-contained interactive HTML map
simplify_geometry Any geometry → simplified to fit a token budget

More on the way.

Why

Agents are bad at maps. Existing map tools either require vendor API keys or return payloads far too large for a context window. PlaceRoot's rule: every answer fits in a couple of thousand tokens, and anything bigger comes back as a summary.

A few things that set it apart:

  • Stable place ids. Every place carries its Overture GERS id, so an agent can hold onto a place across turns and look it up again later instead of re-searching.
  • Built-in geocoding. Place-name lookup works out of the box — no third-party geocoding service involved.
  • Fast repeat queries. Frequently used data is cached locally, so repeat questions answer in milliseconds and keep working offline.
  • Self-hostable end to end. Run it locally, serve it over HTTP, or point it at your own copy of the data — no dependency on anyone else's service.

Development

uv sync           # install dev dependencies
uv run pytest     # offline test suite
uv run ruff check .

Docs

License

MIT

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for chuofringer from gravatar.com chuofringer

Credits

Author: Vibe Mapper

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Tags

ai-agents duckdb geospatial mcp openstreetmap overture-maps

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

placeroot-0.3.2.tar.gz (651.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

placeroot-0.3.2-py3-none-any.whl (96.8 kB view details)

Uploaded Python 3

File details

Details for the file placeroot-0.3.2.tar.gz.

File metadata

  • Download URL: placeroot-0.3.2.tar.gz
  • Upload date:
  • Size: 651.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for placeroot-0.3.2.tar.gz
Algorithm Hash digest
SHA256 ad2a451cb137a77257e88809e0444e2f22e317bbedea1b01d72eb16711b3ce2a
MD5 3d4636443a5a6a943d9ca3b50b3a994c
BLAKE2b-256 d397bb5373a740aafcd33e23dd927dba2ffd0c1263a650e86c4a19770f0464df

See more details on using hashes here.

Provenance

The following attestation bundles were made for placeroot-0.3.2.tar.gz:

Publisher: release.yml on chuofringer/placeroot

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file placeroot-0.3.2-py3-none-any.whl.

File metadata

  • Download URL: placeroot-0.3.2-py3-none-any.whl
  • Upload date:
  • Size: 96.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for placeroot-0.3.2-py3-none-any.whl
Algorithm Hash digest
SHA256 fbde1c624d348c1c6916fc00acc78638532de83c2e7c1bfd3a59812d22c9fac1
MD5 cd367a2c1384f619d64337e312d8e0c5
BLAKE2b-256 11730353ac6700b9a38b965f6151647f22e6e3e860c320b55940da2351770648

See more details on using hashes here.

Provenance

The following attestation bundles were made for placeroot-0.3.2-py3-none-any.whl:

Publisher: release.yml on chuofringer/placeroot

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page