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:
Newer release available (0.8.0)

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.4.0.tar.gz (713.3 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.4.0-py3-none-any.whl (139.6 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for placeroot-0.4.0.tar.gz
Algorithm Hash digest
SHA256 135cab72b2f70ed1a40a95191f1ed4fa61cc5c41714d10d6d69d61005ab831c7
MD5 23499083c091bba3744d0812aba83640
BLAKE2b-256 156b32cb91ff28f93f112c9fa81443e0c5bcaf56b2f475c7bde94157bed4b34b

See more details on using hashes here.

Provenance

The following attestation bundles were made for placeroot-0.4.0.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.4.0-py3-none-any.whl.

File metadata

  • Download URL: placeroot-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 139.6 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.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 237888f206b1135acf303be9a1f0342c9a4341b60c1ea58306d78bb7eff246b3
MD5 dfcfb55c6f7b1d274b7f88d39f5a4033
BLAKE2b-256 3e7c63581dc87160412fcc45143314944dcad045f49e2e4f3135f9779d91ac36

See more details on using hashes here.

Provenance

The following attestation bundles were made for placeroot-0.4.0-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