Python SDK
Typed attrs models + an httpx sync/async client. pip install geolens.
Client SDKs
GeoLens ships typed client SDKs so you can talk to the API in your own language without hand-rolling HTTP calls. Both are Apache-2.0 licensed and auto-generated from the OpenAPI contract, so every operation maps directly to an endpoint in the API reference.
TypeScript SDK
Native fetch + typed request/response interfaces. Node 18+, ESM.
npm install @geolens/sdk.
MCP Server
Read-only Model Context Protocol tools for coding agents. uvx geolens-mcp.
CLI vs SDK vs MCP vs raw API
Section titled “CLI vs SDK vs MCP vs raw API”Four ways to reach a GeoLens instance. Pick the one that fits the job:
| Use | Reach for | Why |
|---|---|---|
| Get data in from a terminal or CI pipeline | CLI | Publish files, scan directories, and apply declarative geolens.yaml manifests with one command. |
| Integrate the API into an app or script | SDK (Python / TypeScript) | Typed models and auth helpers; no manual request building. |
| Let an AI coding agent read the catalog | MCP server | Read-only Model Context Protocol tools for Claude Code, Cursor, and Codex — dataset search, schema, features, and maps from inside a dev session. |
| Any language, or full control over the wire | Raw API | Every endpoint, parameter, and response schema, generated from the OpenAPI snapshot. |