Skip to content
appsgit

GeoLens

GeoLens is an MCP server that adds developer tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Read-only access to a self-hosted GeoLens spatial catalog: datasets, features, maps, sandboxed SQL. It has 301 GitHub stars, is released under the Apache-2.0 license and runs locally with uvx geolens-mcp.

github.com/geolens-io/geolens (opens in a new tab)

Data as of from the GitHub API and the official MCP registry; description from the project's repository. Report an error

Install GeoLens

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.json
{
  "mcpServers": {
    "geolens": {
      "command": "uvx",
      "args": [
        "geolens-mcp"
      ],
      "env": {
        "GEOLENS_INSTANCE": "your-value",
        "GEOLENS_API_KEY": "your-value",
        "GEOLENS_TOKEN": "your-value"
      }
    }
  }
}

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

Claude Code

claude mcp add --env GEOLENS_INSTANCE=your-value --env GEOLENS_API_KEY=your-value --env GEOLENS_TOKEN=your-value --transport stdio geolens -- uvx geolens-mcp

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "geolens": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "geolens-mcp"
      ],
      "env": {
        "GEOLENS_INSTANCE": "your-value",
        "GEOLENS_API_KEY": "your-value",
        "GEOLENS_TOKEN": "your-value"
      }
    }
  }
}

Project file; use ~/.cursor/mcp.json to enable it in every project.

VS Code

.vscode/mcp.json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "geolens_api_key",
      "description": "GEOLENS_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "geolens_token",
      "description": "GEOLENS_TOKEN",
      "password": true
    }
  ],
  "servers": {
    "geolens": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "geolens-mcp"
      ],
      "env": {
        "GEOLENS_INSTANCE": "your-value",
        "GEOLENS_API_KEY": "${input:geolens_api_key}",
        "GEOLENS_TOKEN": "${input:geolens_token}"
      }
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

NameRequiredDescription
GEOLENS_INSTANCEYesBase URL of the GeoLens instance, e.g. https://geolens.example.com (the /api suffix is appended automatically).
GEOLENS_API_KEYsecretNoAPI key, sent as X-Api-Key. Omit for public-only access.
GEOLENS_TOKENsecretNoJWT bearer token, used only when GEOLENSAPIKEY is unset.

Tools (5)

Parsed from the Tools section of the README; check the repository for the current list.

  • search_datasets

    getdatasetschema, getfeatures: find datasets, read their columns and page through features.

  • list_maps

    getmap: saved maps and their layers.

  • list_stories

    getstory: published stories and their chapters. Drafts are never read.

  • aggregate

    exact counts, statistics, histograms, group-bys and row pages over one dataset.

  • query

    one sandboxed SELECT. Use aggregate for counts and summaries.

About GeoLens

Point a coding agent (Claude Code, Cursor, Codex, …) at a GeoLens instance so it can discover datasets, inspect schemas, read features and maps, and run read-only SQL from inside a dev session. With a mapauthor API key it can also create private maps and add, style and frame their layers. It has no ingest, delete, sharing or admin tools, and every call is scoped to the caller's access.

  • cloud-optimized-geotiff
  • data-catalog
  • fastapi
  • geojson
  • geospatial
  • gis
  • maplibre
  • ogc-api
  • pgvector
  • postgis

FAQ

GeoLens FAQ

Still curious? Email info@appsgit.com.

How do I install the GeoLens MCP server?

Add the command uvx geolens-mcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is GeoLens free?

The server is open source under the Apache-2.0 license, so running it is free. It needs credentials (GEOLENS_API_KEY and GEOLENS_TOKEN) for the service it connects to, which may require a paid account.

Is GeoLens actively maintained?

The most recent commit was on Nov 16, 2026. The latest release is v1.31.0, published Nov 10, 2026. appsgit only lists MCP servers with a commit in the last six months.