GeoLens
Read-only access to a self-hosted GeoLens spatial catalog: datasets, features, maps, sandboxed SQL.
Connector by geolens-io · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/geolens-io-geolens
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: maps-location, database-access
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.
- Tools
- 5 read · 0 write · 0 delete · 1 not yet classified
- Secrets
- 2 (API keys, tokens or passwords)
- Install scripts
- None found
- Runs as
- Python package
Tools by what they do 6
Read from the source code; the running server may list different tools.
Read 5 · Look things up without changing anything.
get_dataset_schemaget_featuresget_maplist_mapssearch_datasets
Not yet classified 1 · We could not tell from the name and description.
query
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
GEOLENS_API_KEYGEOLENS_TOKEN
Other settings (environment variables or headers).
GEOLENS_INSTANCE
Tools (6)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
get_dataset_schemaGet a dataset's schema and source trust metadata. Returns columns (name/type/role), geometry type, CRS/SRID, feature count, spatial extent, and the safe `source_origin`. `source_health` is healthy, missing, inaccessible, or unknown: inaccessible means GeoLens could not determine whether the source still exists, while unknown means it was never probed or cannot be probed. `source_health_detail` is a fixed GeoLens reason code, not provider text. `last_checked_at` records the latest probe attempt; `last_refreshed_at` records only the latest successful committed refresh. `source_freshness` is adv…
get_featuresGet GeoJSON features for a dataset (bounded). Returns an OGC-API FeatureCollection. Raster datasets have no features and will error. Results are capped by `limit`; page with `offset`. Only the arguments listed below are supported; anything else is rejected. Args: dataset_id: Dataset id. limit: Max features (1-200, default 10). offset: Feature offset for paging. bbox: Optional bounding box filter "minx,miny,maxx,maxy" (WGS84).
get_mapGet one saved map's full metadata, including its layers, view state, basemap, and terrain configuration. Args: map_id: Map id (e.g. from list_maps).
list_mapsList saved maps (read-only metadata: id, name, visibility, layer count). Args: search: Optional text filter on map name/description. limit: Max results (1-200, default 50). offset: Result offset for paging.
queryRun one read-only SQL SELECT against accessible datasets. Executes through the server's hardened SQL sandbox: a single SELECT over `data.*` tables, an allowlisted function set (aggregates, math, string, date, JSON, common PostGIS like ST_Area/ST_DWithin/ST_Intersects), and a strict server-side budget (a few seconds of runtime, a repetition cap on self-joins, and `row_limit` rows). Returns `{columns, rows, row_count, truncated}` with rows as lists in column order. Requires credentials with AI-chat permission — anonymous configurations cannot use this tool. Workflow: `search_datasets` to find …
search_datasetsSearch the GeoLens catalog for datasets by free text. Matches title, description, and keywords (semantic ranking is used automatically when the instance has it enabled). Returns a GeoJSON FeatureCollection where each feature is a dataset record; use the feature `id` as the dataset_id for the other tools. Each feature's properties include `source_origin` (upload, postgis, service, stac, created, or null) and `source_freshness` (fresh, due, overdue, or unknown). Freshness is advisory: `due` means one declared update interval has elapsed, while `overdue` means two have elapsed; neither proves th…
Compare and alternatives
Featured in
Signals
- Stars
- 281
- Forks
- 41
- Open issues
- 43
- Contributors
- 9
- Weekly downloads
- 554
- Last commit (this folder)
- Oct 24, 2026 (4 days ago)
- Last release
- Oct 18, 2026 (10 days ago)
- Last package publish
- Oct 18, 2026 (10 days ago)
From GitHub (fetched Oct 24, 2026) and the package registry.
Details
- Registry name
io.github.geolens-io/geolens- Version
- 1.26.0
- Auth
- API key
- Packages
- pypi geolens-mcp
- License
- Apache-2.0
- Repository
- github.com/geolens-io/geolens
- Website
- docs.getgeolens.com/
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
Cite this page
GeoLens MCP server. Agent Mart. https://agentmart.dev/connectors/geolens-io-geolens (last updated 2026-10-24)