Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
REFCONV_OUTPUT_DIRNoWhere Street View images are saved. run.sh defaults to ./streetview_images../streetview_images
GOOGLE_MAPS_API_KEYYesGoogle API key with the Street View Static API enabled. Required for the Street View tools.

Instructions

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

Converts Ordnance Survey (British National Grid) grid references such as 'SU 123 456' to WGS84 lat/long, and fetches Google Street View images for a grid reference. A 6-figure reference is a 100 m square; Street View snaps to the nearest panorama within the search radius. Image requests are billed by Google, so request only the views needed.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
gridref_to_latlonA

Convert an OS grid reference to WGS84 latitude/longitude.

Args: grid_ref: e.g. "SU 123 456", "NN166712", "TQ3080" or numeric "412300,145600". centre: return the centre of the referenced square (True) or its SW corner (False).

latlon_to_gridrefA

Convert WGS84 latitude/longitude to an OS grid reference.

Args: lat: latitude in decimal degrees. lon: longitude in decimal degrees. digits: total figures in the reference (2-10, even). 6 = 100 m precision.

streetview_coverageA

Check whether Google Street View has a panorama near a grid reference.

Uses the free metadata endpoint, so it costs nothing. Returns the panorama location, capture date, and distance/bearing to the grid reference point.

Args: grid_ref: OS grid reference, e.g. "SU 123 456". radius_m: how far from the point to search for a panorama (metres).

streetview_from_gridrefA

Fetch Google Street View image(s) for an OS grid reference.

Finds the nearest outdoor panorama within radius_m of the centre of the grid square, then returns the image(s). By default one image is taken looking from the panorama towards the grid reference point.

Args: grid_ref: OS grid reference, e.g. "SU 123 456" or "NN166712". views: number of images spread evenly around 360 deg (1-8). 4 gives N/E/S/W-style coverage. heading: compass heading of the first view in degrees. Default: towards the point (or 0 if the panorama is on top of it). pitch: up/down camera angle, -90 to 90. fov: horizontal field of view in degrees, 10-120. radius_m: search radius for the nearest panorama in metres. size: image size "WxH", max 640x640. save: also save JPEGs to REFCONV_OUTPUT_DIR and return their paths.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.9/5.0

Scored across 4 tools

Disambiguation4/5

The conversion pair (gridref_to_latlon vs latlon_to_gridref) is unambiguous, distinguished by direction and argument names. The two Street View tools are mostly distinct (free metadata probe vs image retrieval), but streetview_coverage overlaps with the panorama-lookup step already embedded in streetview_from_gridref, so an agent may wonder which to call first.

Naming Consistency4/5

All names use snake_case and the two conversion tools follow a clean symmetric 'a_to_b' pattern, with streetview_ prefix grouping the imagery tools. Minor deviation: 'coverage' is a noun while the others are action/prepositional phrases, but the set is still easily readable.

Tool Count4/5

Four tools is tight and appropriate for a narrow conversion-plus-imagery utility, with each tool mapping to a distinct step. It is slightly on the lean side, and streetview_coverage is partially redundant with the lookup inside streetview_from_gridref.

Completeness4/5

Both conversion directions plus a coverage check and image retrieval cover the core workflow end to end. Gaps are minor: no batch conversion, no alternative datums/other national grids, and no reverse lookup of a panorama back to coordinates.

Maintenance

ActivityMaintained
ResponsivenessOutdated data