Skip to main content
Glama
Unselfisheologism

io.github.Unselfisheologism/supercarto

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
HERE_API_KEYNoHERE API key; enables the get_traffic tool.
TOMTOM_API_KEYNoTomTom API key; enables the get_traffic tool.
SUPERCARTO_GTFSNoPath to a GTFS feed (directory or .zip); enables the get_transit and get_transit_route tools.
OVERPASS_ENDPOINTNoYour own Overpass instance endpoint.
SUPERCARTO_GTFS_RTNoGTFS-Realtime TripUpdates URL; adds live delay lines to get_transit.
SUPERCARTO_PMTILESNoPMTiles archive URL; primary data source when set (production use).
TERRARIUM_ENDPOINTNoElevation tile template endpoint.
SUPERCARTO_NO_TERRAINNoDisable elevation/terrain.
SUPERCARTO_NO_WEATHERNoDisable weather.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_mapletA

Fetch real map data around a coordinate and return a token-budgeted topological graph: named places joined by walkable edges with distances in metres and compass directions. Use this to answer 'what is near X' and 'how do I get from A to B'. Omissions are reported, so treat a missing feature as not-shown rather than absent.

localizeA

Move within a map session you already hold. Pass the session SCR (from get_maplet with returnScr, or from the last localize) and your new position; the answer is only the delta: + places that entered view, - places that left it, ~ places that moved or updated. Store the updated SCR from the second content block and discard the old one.

routeB

Feasibility between two coordinates: straight-line distance, the compass direction to head, and nothing that pretends to be turn-by-turn navigation. Turn-by-turn comes only from a routing engine the operator has verified; the default answer ends in "verify the approach on arrival", which is the honest limit of what it computes.

search_placesA

Find named places (cafes, stations, shops) near a coordinate. Cheaper than get_maplet when only names are needed.

expand_featureA

Fetch the exact geometry of features by id, as WKT. Use only when shape matters, such as checking whether a route clears a building.

get_terrainB

Sample ground elevation around a coordinate, in metres. Returns the range plus high and low points, which is what an agent needs for grade reasoning.

get_weatherA

Current weather conditions and a short forecast at a coordinate. Use this before telling someone to walk, cycle, or drive, or to pick between an indoor and outdoor option. Reports what is actually falling (rain, snow, sleet) rather than only a temperature.

get_daylightA

Sun position, sunrise, sunset, and twilight state for a coordinate. Twilight is reported as day, civil, nautical, or night rather than a boolean, because "needs a torch" and "cannot see" are different states.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.7/5.0

Scored across 8 tools

Disambiguation4/5

Most tools have clearly distinct purposes, but route and get_maplet both mention answering 'how do I get from A to B', which could cause misselection. search_places also overlaps with get_maplet's near-coordinate lookup, though the descriptions clarify cost and output shape.

Naming Consistency4/5

Most names follow a verb_noun pattern (get_maplet, search_places, expand_feature, get_terrain, get_weather, get_daylight), while route and localize are bare verbs. The convention is still readable and mostly predictable.

Tool Count5/5

Eight tools is well-scoped for a geo/spatial reasoning server. Each tool covers a distinct capability area: routing, map graph retrieval, session localization, place search, geometry expansion, terrain, weather, and daylight.

Completeness4/5

The surface covers map data, place search, geometry, terrain, weather, daylight, and session-based movement, which is strong lifecycle coverage for agent navigation. Minor gaps remain: no address/place-name geocoding to coordinates and routing is explicitly limited to feasibility rather than turn-by-turn.

Maintenance

ActivityMaintained
ResponsivenessResponsive