RefConvMCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| REFCONV_OUTPUT_DIR | No | Where Street View images are saved. run.sh defaults to ./streetview_images. | ./streetview_images |
| GOOGLE_MAPS_API_KEY | Yes | Google 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
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
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.
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.
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.
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.