supercarto

LLM-native spatial middleware. It compiles geospatial data into token-budgeted topological graphs that an AI agent can reason over directly.

Install

npm install supercarto
pip install supercarto

Claude Desktop user? Every release ships a one-click .mcpb bundle — 384 KB, zero npm dependencies, optional weather and transit configuration at install time. How the format works.

Or try it hosted — no install. The endpoint compiles real maplets over HTTP, and says plainly what it cannot serve: supercarto-compile.jeffrinjames99.workers.dev. Transit needs a local feed, traffic needs a licence, and the maplet falls back to a hosted planet extract because the shared Overpass instances refuse this deployment's datacenter egress.

Give it coordinates

Real OpenStreetMap data, fetched live, compiled into a graph an agent can navigate. No API key, no tile archive, any point on earth.

import { SuperCarto } from 'supercarto';

const carto = new SuperCarto();

const result = await carto.maplet({
  lat: 35.6833,
  lon: 139.7620,
  radiusM: 400,
  budget: 1500,
});

console.log(result.yaml);

The result is plain YAML: nodes, edges with distances in metres and compass directions, a record of what was left out, and the tools the agent can call next.

map:
  center: "35.6833, 139.762"
  radius: 400m
nodes:
  n186: {type: transit, name: 新橋駅(3), tags: [subway_entrance]}
edges:
  n1->n2: {dist: 120m, dir: east, path: road}
omitted:
  - {layer: feature, count: 1754}
tools:
  - expand_node(id)
  - route(from,to,mode)

Measured, not claimed

Same questions, same models, same places. The only variable is what sits in the context window: a compiled supercarto graph, raw GeoJSON, or no map at all. Scripts, scoring, and raw answer archives are public and re-derivable — no model calls needed to verify the score.

ContextScoreNote
supercarto graph38/47Token-budgeted topological YAML
Raw GeoJSON15/4425x more tokens, worse answers
No map0/47The model invents places

What it does

Data sources

SourceUse
OverpassDefault map data, for development
PMTiles / ProtomapsProduction map data
OSRMWalk, bike and drive routing
Open-MeteoWeather, no key
TomTom / HERELive traffic, key required
Terrarium tilesElevation and slope, no key
GTFS feedStops, lines and schedules; SUPERCARTO_GTFS or ?feed=
GTFS-RealtimeLive delay predictions; SUPERCARTO_GTFS_RT, no key