chuk-mcp-her
OfficialIntegration with ArcGIS REST APIs to query Historic Environment Records, including listed buildings, scheduled monuments, conservation areas, heritage at risk, and Scottish heritage data.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@chuk-mcp-her search for listed buildings near Manchester"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
chuk-mcp-her
Historic Environment Records MCP Server -- A Model Context Protocol (MCP) server for querying Historic Environment Records across England and Scotland. Searches listed buildings, scheduled monuments, registered parks, battlefields, protected wrecks, and World Heritage Sites via live ArcGIS REST APIs from Historic England and Historic Environment Scotland.
This is a demonstration project provided as-is for learning and testing purposes.
Features
This MCP server provides structured access to Historic Environment Records through 28 tools across 10 categories, querying 6 data sources via live ArcGIS REST APIs and Heritage Gateway web scraping.
Key capabilities:
Source registry pattern -- pluggable adapters for NHLE, AIM, Conservation Areas, Heritage at Risk, Heritage Gateway, and Scotland (HES) with unified query interface
England + Scotland coverage -- English heritage via Historic England, Scottish heritage via Historic Environment Scotland (320,000+ NRHE records + designated assets)
Spatial-first queries -- bounding box, point+radius, and area searches via ArcGIS Feature/Map Services
BNG/WGS84 coordinate support -- automatic conversion between British National Grid (EPSG:27700) and WGS84 (EPSG:4326)
Interactive map views --
her_mapandher_crossref_mapreturn structuredMapContentfor rendering in chuk-mcp-ui-compatible clientsAll tools return fully-typed Pydantic v2 models for type safety, validation, and excellent IDE support
Most tools support
output_mode="text"for human-readable output alongside the default JSON
1. Server Discovery (her_status, her_list_sources, her_capabilities)
Check server health, list registered data sources, and get full capabilities:
Source availability and status
Supported query types per source
LLM guidance for query planning
2. NHLE Queries (her_search_monuments, her_get_monument, her_search_listed_buildings, her_search_designations, her_count_features)
Search the National Heritage List for England:
Scheduled monuments by location, name, or description
Listed buildings with grade filtering (I, II*, II)
Generic designation search across all 6 designation types
Fast feature counts without fetching full records
Pagination with offset-based paging
3. Aerial Mapping (her_search_aerial, her_count_aerial, her_get_aerial_feature)
Search aerial investigation mapping data:
Archaeological features from aerial photographs and LiDAR
Cropmarks, earthworks, and features not in the NHLE
Monument type and period filtering
Fast feature counts without fetching full records
Full details for individual aerial mapping features
4. Conservation Areas (her_search_conservation_areas, her_count_conservation_areas, her_get_conservation_area)
Search Historic England's 8,000+ conservation areas:
Search by name, Local Planning Authority, or location
Bounding box and point+radius spatial queries
Fast counts without fetching full records
Full details including designation date and area
5. Heritage at Risk (her_search_heritage_at_risk, her_count_heritage_at_risk, her_get_heritage_at_risk)
Search the Heritage at Risk Register:
Annual register of heritage assets at risk of loss
Filter by heritage category (Listed Building, Scheduled Monument, etc.)
Spatial search by bounding box or point+radius
Risk methodology details for each entry
6. Heritage Gateway (her_search_heritage_gateway)
Search local Historic Environment Records via Heritage Gateway:
Best-effort access to 60+ local HERs via web scraping
Undesignated sites, findspots, and HER monument entries
Returns empty results gracefully when Gateway unavailable
7. Scotland (her_search_scotland, her_get_scotland_record, her_search_scotland_designations)
Search Historic Environment Scotland records:
320,000+ National Record of the Historic Environment (NRHE) records via Canmore Points
Designated assets: listed buildings, scheduled monuments, gardens and designed landscapes, battlefields, world heritage sites, conservation areas, historic marine protected areas
Site type, broad class, and council area filtering
Full details for individual records by Canmore ID
8. Cross-Referencing (her_cross_reference, her_enrich_gateway, her_nearby)
Spatial matching, enrichment, and proximity search:
Cross-reference candidate locations against known heritage assets
Classify candidates as match, near, or novel
Grid-based spatial indexing for efficient batch processing (O(n+m) amortised)
Optional AIM aerial feature integration (
include_aimparameter)Designation type filtering (single type or comma-separated)
Enriched match output with 11 fields per asset (source, grade, monument_type, period, form, evidence)
Enrich Gateway records with resolved BNG coordinates for cross-referencing
Find nearby heritage assets with distance and bearing
Accepts both WGS84 and BNG coordinates
9. Export (her_export_geojson, her_export_for_lidar)
Export and format results:
GeoJSON FeatureCollection for QGIS, Leaflet, or other GIS tools
LiDAR cross-reference format with enriched metadata per source:
NHLE sites with grade
AIM aerial features with monument_type, period, form, evidence
Gateway sites with monument_type and period
Optional AIM integration (
include_aim) and Gateway sites (gateway_sites) for LiDAR export
10. Map Visualisation (her_map, her_crossref_map)
Interactive heritage maps rendered as structured MapContent for chuk-mcp-ui clients:
her_map-- queries up to five sources in parallel (NHLE, AIM, Conservation Areas, Heritage at Risk, Scotland) and renders each as a distinctly colour-coded layer; NHLE results are split by designation type for visual separationher_crossref_map-- runs the same analysis asher_cross_referencethen renders four colour-coded layers: green (match), amber (near), red (novel/potential new discovery), grey (known assets)Marker clustering, popup templates, and layer toggle controls
Accepts WGS84 bbox or lat/lon/radius_m; BNG candidates for crossref map
Related MCP server: Edinburgh Festivals MCP Server
Tool Reference
All tools accept an optional output_mode parameter ("json" default, or "text" for human-readable output).
Tool | Category | Description | Status |
| Discovery | Server health and source availability | Active |
| Discovery | List registered data sources with capabilities | Active |
| Discovery | Full server capability listing for LLM planning | Active |
| NHLE | Search scheduled monuments by location or name | Active |
| NHLE | Get full details for a specific monument | Active |
| NHLE | Search listed buildings with grade filter | Active |
| NHLE | Search across all designation types | Active |
| NHLE | Fast count of features in an area | Active |
| Aerial | Search aerial investigation mapping data | Active |
| Aerial | Count aerial mapping features in an area | Active |
| Aerial | Get full details of an aerial mapping feature | Active |
| Conservation | Search conservation areas by name, LPA, or location | Active |
| Conservation | Count conservation areas in an area | Active |
| Conservation | Get full details of a conservation area | Active |
| At Risk | Search heritage at risk register entries | Active |
| At Risk | Count heritage at risk entries in an area | Active |
| At Risk | Get full details of a heritage at risk entry | Active |
| Gateway | Search local HER data via Heritage Gateway | Active |
| Scotland | Search Scottish NRHE records (320K+ sites) | Active |
| Scotland | Get full details of a Scottish NRHE record | Active |
| Scotland | Search Scottish designated heritage assets | Active |
| Cross-Ref | Cross-reference candidates against known assets | Active |
| Cross-Ref | Resolve Gateway record coordinates for cross-referencing | Active |
| Cross-Ref | Find NHLE heritage assets near a point (England only) | Active |
| Export | Export results as GeoJSON FeatureCollection | Active |
| Export | Export known sites for LiDAR cross-referencing | Active |
| Map | Multi-source heritage map with colour-coded layers | Active |
| Map | Colour-coded cross-reference map (match/near/novel/known) | Active |
Data Sources
Source | Name | Organisation | Coverage | API Type | Status |
| National Heritage List for England | Historic England | England | ArcGIS Feature Service | Active |
| Aerial Investigation and Mapping | Historic England | England | ArcGIS Feature Service | Active |
| Conservation Areas | Historic England / LPAs | England | ArcGIS Feature Service | Active |
| Heritage at Risk Register | Historic England | England | ArcGIS Feature Service | Active |
| Heritage Gateway (Local HERs) | Historic England / Local HERs | England | Web scraper | Active |
| Historic Environment Scotland | Historic Environment Scotland | Scotland | ArcGIS Map Service | Active |
NHLE Designation Types
Type | Description |
| Listed buildings (Grades I, II*, II) |
| Scheduled monuments |
| Registered parks and gardens |
| Registered battlefields |
| Protected wreck sites |
| World Heritage Sites |
Installation
Using uvx (Recommended -- No Installation Required!)
uvx chuk-mcp-herUsing uv (Recommended for Development)
# Install from PyPI
uv pip install chuk-mcp-her
# Or clone and install from source
git clone <repository-url>
cd chuk-mcp-her
uv sync --devUsing pip (Traditional)
pip install chuk-mcp-herOptional: Sub-metre Coordinate Accuracy
# Install pyproj for sub-metre BNG<->WGS84 conversion
# Without pyproj, Helmert approximation (~5m accuracy) is used
pip install chuk-mcp-her[pyproj]Usage
With Claude Desktop
Option 1: Run Locally with uvx
MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"her": {
"command": "uvx",
"args": ["chuk-mcp-her"]
}
}
}Option 2: Run Locally with pip
{
"mcpServers": {
"her": {
"command": "chuk-mcp-her"
}
}
}With Python SDK
from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client
server_params = StdioServerParameters(
command="uvx",
args=["chuk-mcp-her"],
)
async with stdio_client(server_params) as (read, write):
async with ClientSession(read, write) as session:
await session.initialize()
result = await session.call_tool(
"her_search_monuments",
{"name": "Stonehenge", "max_results": 5},
)Standalone
# STDIO mode (default, for MCP clients)
chuk-mcp-her stdio
# HTTP mode (for web access)
chuk-mcp-her http
chuk-mcp-her http --port 8010
# Auto-detect mode
chuk-mcp-herSTDIO mode is for MCP clients like Claude Desktop and mcp-cli. HTTP mode runs a web server on http://localhost:8010 for HTTP-based MCP clients.
CLI (mcp-cli)
mcp-cli chat --server herExample Usage
Once configured, you can ask questions like:
"List the available heritage data sources"
"Search for scheduled monuments near Stonehenge"
"Find Grade I listed buildings in central London"
"How many heritage assets are in this bounding box?"
"Get the full record for monument 1002345"
"What heritage assets are within 500m of the Tower of London?"
"Export all scheduled monuments in the Maldon area as GeoJSON"
"Cross-reference these LiDAR survey points against known heritage assets"
"Show all heritage assets within 2km of Stonehenge on a map"
"Map my LiDAR candidates against known scheduled monuments and show which are potential new discoveries"
"Search for protected wrecks along the English coast"
"Find registered parks and gardens near Bath"
"Search for all red hills along the north bank of the Blackwater estuary between Heybridge Basin and Tollesbury"
"Find castles in the Scottish Highlands"
"Search for brochs near Inverness"
"What scheduled monuments are in Edinburgh?"
Multi-source queries: The tool descriptions guide LLM agents to combine multiple sources automatically. A query like "find all red hills near the Blackwater" will prompt the agent to search NHLE (designated monuments), AIM (aerial mapping features), and Heritage Gateway (local HER records), then merge the results for comprehensive coverage.
Model-agnostic: The MCP server works with any LLM provider that supports function calling -- Claude, GPT, Gemini, or any other MCP-compatible client. The same tools work identically through Claude Desktop, mcp-cli, or the Python SDK.
Running the Examples
cd examples
python capabilities_demo.py # server capabilities, sources, tools
python quick_start.py # quick intro: status, count, search, nearby
python nhle_search_demo.py # scheduled monument and listed building search
python aerial_search_demo.py # aerial investigation mapping features
python conservation_area_demo.py # conservation area search
python heritage_at_risk_demo.py # heritage at risk register
python nearby_demo.py # find heritage assets near a point
python export_demo.py # GeoJSON export
python gateway_search_demo.py # Heritage Gateway local HER search
python cross_reference_demo.py # cross-reference candidates (with AIM)
python enrichment_pipeline_demo.py # Gateway enrichment + cross-reference
python blackwater_estuary_scenario.py # multi-source scenario
python scotland_search_demo.py # Scottish NRHE search (Canmore)
python scotland_designations_demo.py # Scottish designated heritage assetsScript | Network | Tools Demonstrated |
| No |
|
| Yes |
|
| Yes |
|
| Yes |
|
| Yes |
|
| Yes |
|
| Yes |
|
| Yes |
|
| Yes |
|
| Yes |
|
| Yes |
|
| Yes | Multi-source scenario using NHLE, AIM, Conservation Areas, Heritage at Risk |
| Yes |
|
| Yes |
|
Architecture
MCP Client (Claude, mcp-cli, etc.)
|
| MCP protocol (stdio / HTTP)
v
+-------------------------------+
| Tool Functions |
| discovery/ nhle/ aerial/ |
| conservation_area/ scotland/ |
| heritage_at_risk/ gateway/ |
| crossref/ export/ map/ |
+-------------------------------+
|
| validate params, format response
v
+-------------------------------+
| SourceRegistry |
| (unified query interface) |
+-------------------------------+
| | | | | |
NHLEAdapter | CA HAR | ScotlandAdapter
AIMAdapter | Adapter Adapter| (2 clients)
| GatewayAdapter
v v v v v
+------------------+ +------------------+ +------------------+
| ArcGIS Client | | Gateway Client | | ArcGIS Client |
| (HE FeatureSvr) | | (httpx, bs4) | | (HES MapServer) |
+------------------+ +------------------+ +------------------+
| | |
v v v
+------------------+ +------------------+ +------------------+
| HE ArcGIS Svc | | Heritage Gateway | | inspire.hes.scot |
| NHLE,AIM,CA,HAR | | (60+ local HERs) | | Canmore, HES Des |
+------------------+ +------------------+ +------------------+Built on top of chuk-mcp-server, this server uses:
Async-First: Native async/await with httpx for all HTTP requests
Type-Safe: Pydantic v2 models with
extra="forbid"for all responsesSource Registry Pattern: Pluggable adapters registered at startup, queried through unified interface
BNG/WGS84 Conversion: Helmert transformation with optional pyproj for sub-metre accuracy
Filesystem Cache: TTL-based per-source caching to reduce API load
Rate Limiting: Per-client rate limiting with exponential backoff on 429/5xx
chuk-view-schemas: Map tools return
MapContentstructured views viachuk_view_schemas.chuk_mcp.map_tooldecoratorDual Output: Most tools support
output_mode="text"for human-readable responses; map tools return structuredMapContentError Messages: All error strings from
ErrorMessagesconstants -- no hardcoded strings
See ARCHITECTURE.md for design principles and data flow diagrams. See SPEC.md for the full tool specification with parameter tables. See ROADMAP.md for the development roadmap and planned features.
Development
Setup
# Clone the repository
git clone <repository-url>
cd chuk-mcp-her
# Install with uv (recommended)
uv sync --dev
# Or with pip
pip install -e ".[dev]"Running Tests
# Run tests
pytest tests/
# Run tests with coverage
pytest tests/ --cov=src/chuk_mcp_her --cov-report=term-missing
# Run a specific test file
pytest tests/test_coordinates.py -vCode Quality
# Lint and format with ruff
ruff check src/ tests/
ruff format src/ tests/
# Type checking
mypy src/
# Security scan
bandit -r src/ -x tests/Building
# Build package
python -m build
# Or with uv
uv buildConfiguration
Environment Variables
Variable | Default | Description |
| - | Set to any value to force stdio mode |
|
| Filesystem cache directory |
|
| NHLE cache TTL in seconds (24 hours) |
|
| AIM cache TTL in seconds (7 days) |
|
| Heritage Gateway cache TTL in seconds (1 hour) |
|
| Max requests per second to ArcGIS |
|
| HTTP request timeout in seconds |
License
Apache License 2.0 -- See LICENSE for details.
References
Historic England -- National Heritage List for England
NHLE ArcGIS Feature Service -- Live data endpoint
ArcGIS REST API -- Query specification
Historic Environment Scotland -- National Record of the Historic Environment
HES ArcGIS MapServer -- Scottish heritage data endpoints
Heritage Gateway -- Federated HER search
Model Context Protocol -- MCP specification
Anthropic -- Claude and MCP support
British National Grid -- EPSG:27700 coordinate reference system
Available Tools
28 toolsher_capabilitiesA
List full server capabilities: sources, tools, and supported queries.
Provides complete information about the server including all available tools, registered sources, supported spatial references, and guidance for LLM query planning.
Args: output_mode: Response format — "json" (default) or "text"
Returns: Complete capability listing with LLM guidance
Tips for LLMs: Call this once at the start of a session to understand what tools are available and how to use them effectively.
Inputs: output_mode.
her_count_aerialA
Count aerial mapping features in an area (fast, no geometry returned).
Returns a quick count of AIM features matching spatial and attribute filters. Use before her_search_aerial to gauge result size.
Args: bbox: Bounding box as "xmin,ymin,xmax,ymax" in BNG (EPSG:27700) monument_type: Monument type keyword (e.g. "ENCLOSURE", "MOUND") period: Period filter (e.g. "IRON AGE", "ROMAN") output_mode: Response format — "json" (default) or "text"
Returns: Feature count
Tips for LLMs: Call this before her_search_aerial to check how many features match before fetching full records.
Inputs: bbox, period, output_mode, monument_type.
her_count_conservation_areasA
Count conservation areas in an area (fast, no geometry returned).
Returns a quick count of conservation areas matching filters. Use before her_search_conservation_areas to gauge result size.
Args: bbox: Bounding box as "xmin,ymin,xmax,ymax" in BNG (EPSG:27700) query: Name filter (e.g. "Maldon") lpa: Local Planning Authority filter output_mode: Response format — "json" (default) or "text"
Returns: Conservation area count
Tips for LLMs: Call this before her_search_conservation_areas to check how many areas match before fetching full records.
Inputs: lpa, bbox, query, output_mode.
her_count_featuresA
Fast count of heritage features in an area.
Returns counts by designation type without fetching full records. Use this before her_search_designations to estimate result sizes.
Args: designation_type: Filter by type (None = count all types) bbox: Bounding box as "xmin,ymin,xmax,ymax" in BNG output_mode: Response format — "json" (default) or "text"
Returns: Feature counts by designation type
Tips for LLMs: - Much faster than a full search when you just need totals - Use this to decide whether to narrow your search area - Counts are broken down by designation type
Inputs: bbox, output_mode, designation_type.
her_count_heritage_at_riskA
Count heritage at risk entries in an area (fast, no geometry returned).
Returns a quick count of at-risk heritage assets matching filters. Use before her_search_heritage_at_risk to gauge result size.
Args: bbox: Bounding box as "xmin,ymin,xmax,ymax" in BNG (EPSG:27700) heritage_category: Filter by category (e.g. "Listed Building") output_mode: Response format — "json" (default) or "text"
Returns: Heritage at risk count
Tips for LLMs: Call this before her_search_heritage_at_risk to check how many entries match before fetching full records.
Inputs: bbox, output_mode, heritage_category.
her_cross_referenceA
Cross-reference candidate locations against known heritage assets.
Takes a list of candidate locations (e.g. from LiDAR survey) and classifies each as match, near, or novel based on proximity to known NHLE records, AIM aerial mapping features, and optionally Heritage Gateway records.
Args: candidates: JSON array of {"easting": x, "northing": y} dicts match_radius_m: Distance threshold for "match" (default 50m) near_radius_m: Distance threshold for "near" (default 200m) designation_types: Comma-separated NHLE designation types to match against (e.g. "scheduled_monument,listed_building") include_aim: Include AIM aerial mapping features in known assets (adds monument_type, period, form from aerial archaeology) gateway_sites: JSON array of Gateway records with easting/northing (output of her_enrich_gateway) to merge into known sites output_mode: Response format — "json" (default) or "text"
Returns: Classification of each candidate as match, near, or novel
Tips for LLMs: - Input candidates as BNG easting/northing coordinates - "match" means the candidate is within match_radius_m of a known asset - "near" means within near_radius_m but not a match - "novel" means no known asset within near_radius_m - Set include_aim=true for LiDAR workflows to include aerial features - Use her_enrich_gateway first to resolve Gateway record coordinates, then pass the output as gateway_sites for richer cross-referencing - Use her_export_for_lidar to get known sites in the same area
Inputs: candidates, include_aim, output_mode, gateway_sites, +3 more.
her_crossref_mapARead-only
Visualise cross-reference results as a colour-coded map: green (match), amber (near), red (novel), grey (known assets). Runs the same analysis as her_cross_reference.
Inputs: basemap, candidates, include_aim, near_radius_m, +2 more.
her_enrich_gatewayA
Fetch Heritage Gateway records with resolved coordinates.
Searches the Heritage Gateway for local HER records and resolves their BNG coordinates by parsing grid references and/or fetching detail pages. Returns only records with valid easting/northing, suitable for cross-referencing with her_cross_reference.
Args: what: Monument type or keyword (e.g. "red hill", "saltern") where: Place name (e.g. "Blackwater", "Essex") when: Period (e.g. "Roman", "Iron Age") max_results: Maximum records to return (default 100) fetch_details: Fetch detail pages for coordinates (default true) output_mode: Response format — "json" (default) or "text"
Returns: Gateway records with resolved BNG easting/northing coordinates
Tips for LLMs: - This tool is SLOW (may take 1-2 minutes for 100 records) - Use it before her_cross_reference to enrich the known-sites pool - Pass the output records as gateway_sites to her_cross_reference - Set fetch_details=false for faster results (grid refs only) - Results include only records with successfully resolved coordinates - While waiting for this, also run her_search_monuments and/or her_search_aerial in the same area for comprehensive coverage — Gateway records are local HER data not in NHLE or AIM
Inputs: what, when, where, max_results, +2 more.
her_export_for_lidarA
Export heritage assets for LiDAR cross-referencing.
Produces a list of known monument centroids with metadata in the format expected by chuk-mcp-lidar spatial matching.
Args: bbox: Bounding box as "xmin,ymin,xmax,ymax" in BNG (required) include_aim: Include aerial mapping features (when available) include_nhle: Include NHLE designations (default true) gateway_sites: JSON array of Gateway records with easting/northing (output of her_enrich_gateway) to include as known sites output_mode: Response format — "json" (default) or "text"
Returns: Known sites in LiDAR cross-reference format
Tips for LLMs: - bbox is required for LiDAR export - Output includes easting/northing in BNG for spatial matching - Each site has id, source, name, type, monument_type, period - Use her_enrich_gateway first, then pass output as gateway_sites
Inputs: bbox, include_aim, output_mode, include_nhle, +1 more.
her_export_geojsonA
Export heritage assets as GeoJSON FeatureCollection.
Exports query results in GeoJSON format suitable for use in QGIS, Leaflet, or other GIS tools.
Args: bbox: Bounding box as "xmin,ymin,xmax,ymax" in BNG designation_type: Filter by designation type name: Name filter (partial match) max_results: Maximum features to export (default 500, max 2000) output_mode: Response format — "json" (default) or "text"
Returns: GeoJSON FeatureCollection with matching heritage assets
Tips for LLMs: - Use bbox to limit the export area - Output is a standard GeoJSON FeatureCollection - Coordinates are in WGS84 (EPSG:4326)
Inputs: bbox, name, max_results, output_mode, +1 more.
her_get_aerial_featureA
Get full details of a specific aerial mapping feature.
Retrieves a single AIM feature by its HE_UID. Accepts either "aim:HE_UID" or just the HE_UID.
Args: record_id: AIM feature ID (e.g. "aim:12345" or "12345") output_mode: Response format — "json" (default) or "text"
Returns: Full feature details including monument type, period, evidence, location
Tips for LLMs: Use record_id from her_search_aerial results.
Inputs: record_id, output_mode.
her_get_conservation_areaA
Get full details of a specific conservation area.
Retrieves a single conservation area by its UID. Accepts either "ca:UID" or just the UID number.
Args: record_id: Conservation area ID (e.g. "ca:1234" or "1234") output_mode: Response format — "json" (default) or "text"
Returns: Full conservation area details including name, LPA, location
Tips for LLMs: Use record_id from her_search_conservation_areas results.
Inputs: record_id, output_mode.
her_get_heritage_at_riskA
Get full details of a specific heritage at risk entry.
Retrieves a single at-risk entry by its List Entry number. Accepts either "har:LIST_ENTRY" or just the number.
Args: record_id: Heritage at Risk ID (e.g. "har:1021506" or "1021506") output_mode: Response format — "json" (default) or "text"
Returns: Full heritage at risk details including category, risk methodology
Tips for LLMs: Use record_id from her_search_heritage_at_risk results.
Inputs: record_id, output_mode.
her_get_monumentA
Get full details for a specific scheduled monument.
Returns the complete record including name, designation, location, listing dates, and URL to the Historic England listing page.
Args: nhle_id: NHLE list entry number (e.g. "1002345") output_mode: Response format — "json" (default) or "text"
Returns: Full monument record
Tips for LLMs: - Use the nhle_id from search results - The URL links to the full Historic England listing page
Inputs: nhle_id (required), output_mode.
her_get_scotland_recordA
Get full details of a Scottish NRHE record by Canmore ID.
Retrieves a single record from the National Record of the Historic Environment. Accepts either "scotland:CANMOREID" or just the ID.
Args: record_id: Canmore ID (e.g. "scotland:12345" or "12345") output_mode: Response format — "json" (default) or "text"
Returns: Full record details including site type, form, location, grid reference
Tips for LLMs: Use record_id from her_search_scotland results.
Inputs: record_id, output_mode.
her_list_sourcesA
List all registered heritage data sources and their capabilities.
Returns metadata about each source including what query types it supports, its coverage area, and current status.
Args: output_mode: Response format — "json" (default) or "text"
Returns: List of sources with capabilities
Tips for LLMs: Use this to discover which sources are available and what each one can do before running queries.
Inputs: output_mode.
her_mapARead-only
Visualise heritage assets from multiple sources as a multi-layer interactive map. Returns a structured map view with colour-coded layers by designation type and source.
Inputs: lat, lon, bbox, basemap, +4 more.
her_nearbyA
Find NHLE heritage assets near a single point.
Searches the National Heritage List for England (NHLE) for designated heritage assets within a radius of the given point. Returns assets sorted by distance.
NOTE: This tool searches NHLE only (England). For Scottish sites use her_search_scotland with lat/lon/radius_m. For aerial features use her_search_aerial with lat/lon/radius_m.
Args: lat: WGS84 latitude (use with lon) lon: WGS84 longitude (use with lat) easting: BNG easting (use with northing, alternative to lat/lon) northing: BNG northing (use with easting) radius_m: Search radius in metres (default 500) max_results: Maximum results (default 20) output_mode: Response format — "json" (default) or "text"
Returns: Nearby NHLE heritage assets with distance and bearing
Tips for LLMs: - Use lat/lon OR easting/northing (not both) - Results are sorted by distance from the centre point - Each result includes distance_m and bearing_deg - For comprehensive nearby search, ALSO call her_search_aerial and her_search_scotland (if near/in Scotland) with the same lat/lon/radius_m parameters
Inputs: lat, lon, easting, northing, +3 more.
her_search_aerialA
Search aerial investigation mapping data for archaeological features.
Queries Historic England AIM data for features identified from aerial photographs and LiDAR. Includes cropmarks, earthworks, enclosures, ring ditches, saltern mounds, and other features not in the NHLE.
Args: monument_type: Monument type keyword (e.g. "SALTERN MOUND", "ENCLOSURE") period: Period filter (e.g. "IRON AGE", "ROMAN", "MEDIEVAL") bbox: Bounding box as "xmin,ymin,xmax,ymax" in BNG (EPSG:27700) lat: WGS84 latitude for radius search lon: WGS84 longitude for radius search radius_m: Search radius in metres (requires lat/lon) max_results: Maximum results (1-2000, default 50) offset: Pagination offset output_mode: Response format — "json" (default) or "text"
Returns: Matching aerial mapping features with monument type, period, evidence
Tips for LLMs: Use monument_type and period as uppercase keywords matching the AIM vocabulary. Key monument types: "SALTERN MOUND" or "RED HILL" for salt-production mounds, "ENCLOSURE" for prehistoric/Roman enclosures, "RING DITCH" for barrow ditches, "EARTHWORK" for general earthworks, "FIELD SYSTEM" for field boundaries. Periods: "IRON AGE", "ROMAN", "MEDIEVAL". These features are NOT in the NHLE — they complement her_search_monuments. For comprehensive area surveys, run all three sources: her_search_monuments (NHLE designated), her_search_aerial (AIM cropmarks/earthworks), and her_search_heritage_gateway (local HER undesignated sites), then merge and deduplicate the results. Use her_map to display the combined results on a map.
Inputs: lat, lon, bbox, offset, +5 more.
her_search_conservation_areasA
Search conservation areas across England.
Queries Historic England's Conservation Areas dataset for areas of special architectural or historic interest designated by Local Planning Authorities.
Args: query: Name search (e.g. "Maldon", "Bath") lpa: Local Planning Authority filter (e.g. "Maldon District") bbox: Bounding box as "xmin,ymin,xmax,ymax" in BNG (EPSG:27700) lat: WGS84 latitude for radius search lon: WGS84 longitude for radius search radius_m: Search radius in metres (requires lat/lon) max_results: Maximum results (1-2000, default 50) offset: Pagination offset output_mode: Response format — "json" (default) or "text"
Returns: Matching conservation areas with name, LPA, designation date
Tips for LLMs: Use lpa to filter by local authority. Combine with bbox or lat/lon for spatial queries. Use her_count_conservation_areas first to gauge result size.
Inputs: lat, lon, lpa, bbox, +5 more.
her_search_designationsA
Search across all designation types in the NHLE.
Generic search covering listed buildings, scheduled monuments, registered parks and gardens, battlefields, protected wrecks, and World Heritage Sites.
Args: designation_type: Filter by type — listed_building, scheduled_monument, park_and_garden, battlefield, protected_wreck, world_heritage_site name: Name search (partial match) description: Description search bbox: Bounding box as "xmin,ymin,xmax,ymax" in BNG lat: WGS84 latitude for radius search lon: WGS84 longitude for radius search radius_m: Search radius in metres max_results: Maximum results (1-2000, default 50) offset: Pagination offset output_mode: Response format — "json" (default) or "text"
Returns: Matching designations across all types
Tips for LLMs: - Leave designation_type empty to search all types - Use her_count_features first for quick totals - Results include designation_type so you can see the mix
Inputs: lat, lon, bbox, name, +6 more.
her_search_heritage_at_riskA
Search the Heritage at Risk Register for endangered heritage assets.
Queries Historic England's annual register of heritage assets at risk of loss through neglect, decay, or inappropriate development.
Args: query: Name search (e.g. "church", "castle") heritage_category: Filter by category — one of: "Scheduled Monument", "Listed Building", "Conservation Area", "Registered Park and Garden", "Registered Battlefield", "Protected Wreck Site" bbox: Bounding box as "xmin,ymin,xmax,ymax" in BNG (EPSG:27700) lat: WGS84 latitude for radius search lon: WGS84 longitude for radius search radius_m: Search radius in metres (requires lat/lon) max_results: Maximum results (1-2000, default 50) offset: Pagination offset output_mode: Response format — "json" (default) or "text"
Returns: Matching heritage at risk entries with category, risk methodology
Tips for LLMs: Use heritage_category to filter by asset type. Combine with bbox or lat/lon for spatial queries. These entries are designated assets that are at risk — they will also appear in NHLE searches.
Inputs: lat, lon, bbox, query, +5 more.
her_search_heritage_gatewayA
Search local Historic Environment Records via Heritage Gateway.
Searches across 60+ local HERs for undesignated sites not in the NHLE — red hills, findspots, fieldwork records, HER monument entries. Best-effort access via web scraping; returns empty results gracefully when the Gateway is unavailable.
Args: what: Monument type or keyword (e.g. "red hill", "saltern") where: Place name or area (e.g. "Goldhanger", "Blackwater") when: Period (e.g. "Iron Age", "Roman", "Medieval") max_results: Maximum results (default 50) output_mode: Response format — "json" (default) or "text"
Returns: Matching Heritage Gateway records from local HERs
Tips for LLMs: This is the best source for undesignated sites and local HER data. Results may be empty if the Gateway is temporarily unavailable. IMPORTANT: Gateway results cover only local HER records. For comprehensive coverage, ALSO run her_search_monuments (NHLE) and her_search_aerial (AIM) in the same area and merge the results. For spatial filtering, use her_enrich_gateway to resolve BNG coordinates, then apply a bbox to filter precisely.
Inputs: what, when, where, max_results, +1 more.
her_search_listed_buildingsA
Search listed buildings by location, name, or grade.
Queries the NHLE for listed buildings. Filter by listing grade (I, II*, II) and location.
Args: name: Building name (partial match, case-insensitive) grade: Listing grade filter: "I", "II*", or "II" bbox: Bounding box as "xmin,ymin,xmax,ymax" in BNG lat: WGS84 latitude for radius search lon: WGS84 longitude for radius search radius_m: Search radius in metres max_results: Maximum results (1-2000, default 50) offset: Pagination offset output_mode: Response format — "json" (default) or "text"
Returns: Matching listed buildings with grade and location
Tips for LLMs: - Grade I is the highest (most significant) - Grade II* is between I and II - Grade II is the most common (~92% of all listed buildings) - Use bbox or lat/lon to limit by area
Inputs: lat, lon, bbox, name, +5 more.
her_search_monumentsA
Search scheduled monuments by location, name, or description.
Queries the National Heritage List for England for scheduled monuments. Supports spatial queries (bounding box or point+radius) and text search on monument names.
Args: name: Monument name (partial match, case-insensitive) description: Full-text search on description field bbox: Bounding box as "xmin,ymin,xmax,ymax" in BNG (EPSG:27700) lat: WGS84 latitude for radius search lon: WGS84 longitude for radius search radius_m: Search radius in metres (requires lat/lon) max_results: Maximum results (1-2000, default 50) offset: Pagination offset output_mode: Response format — "json" (default) or "text"
Returns: Matching scheduled monuments with location and metadata
Tips for LLMs: - Use bbox for area searches (e.g. "586000,205000,602500,215000") - Use lat/lon + radius_m for point searches - Use name for text-based searches (e.g. "red hill") - Follow up with her_get_monument for full details - Use her_count_features first for quick totals - NHLE only contains designated assets. For undesignated sites (red hills, findspots, local HER records), ALSO search her_search_heritage_gateway and her_search_aerial in the same area to get comprehensive coverage.
Inputs: lat, lon, bbox, name, +5 more.
her_search_scotlandA
Search Scottish NRHE records (320,000+ sites from Canmore).
Queries the National Record of the Historic Environment for terrestrial archaeological sites, monuments, and buildings in Scotland. Covers 320,000+ records including castles, brochs, cairns, standing stones, churches, and industrial heritage.
Args: name: Site name keyword (partial, case-insensitive) site_type: Site type keyword (e.g. "CASTLE", "BROCH", "CAIRN") broad_class: Broad classification (e.g. "DOMESTIC", "RELIGIOUS") council: Council area (e.g. "Highland", "Edinburgh") bbox: Bounding box as "xmin,ymin,xmax,ymax" in BNG (EPSG:27700) lat: WGS84 latitude for radius search lon: WGS84 longitude for radius search radius_m: Search radius in metres (requires lat/lon) max_results: Maximum results (1-1000, default 50) output_mode: Response format — "json" (default) or "text"
Returns: Matching NRHE records with site type, classification, location
Tips for LLMs: - This covers ALL known Scottish heritage sites, not just designated ones - For designated assets only, use her_search_scotland_designations - For cross-border queries near England/Scotland border, also run her_search_monuments (NHLE) and her_search_aerial (AIM) for English sites - site_type keywords: CASTLE, BROCH, CAIRN, STONE CIRCLE, CHURCH, FORT, CRANNOG, DUN, STANDING STONE, SOUTERRAIN - MapServer max is 1,000 records per request
Inputs: lat, lon, bbox, name, +6 more.
her_search_scotland_designationsA
Search Scottish designated heritage assets.
Queries HES Designations for listed buildings, scheduled monuments, gardens and designed landscapes, battlefields, world heritage sites, conservation areas, and historic marine protected areas in Scotland.
Args: designation_type: Filter by type — one of: listed_building, scheduled_monument, garden_designed_landscape, battlefield, world_heritage_site, conservation_area, historic_marine_protected_area name: Name keyword (partial, case-insensitive) bbox: Bounding box as "xmin,ymin,xmax,ymax" in BNG (EPSG:27700) lat: WGS84 latitude for radius search lon: WGS84 longitude for radius search radius_m: Search radius in metres (requires lat/lon) max_results: Maximum results (default 50) output_mode: Response format — "json" (default) or "text"
Returns: Matching designated heritage assets with type, category, location
Tips for LLMs: - Use this for formally designated Scottish assets - For ALL known Scottish sites (not just designated), use her_search_scotland - Scottish designation types differ slightly from English NHLE types: Scotland has garden_designed_landscape and historic_marine_protected_area - For cross-border queries, also search English sources (her_search_designations for NHLE)
Inputs: lat, lon, bbox, name, +4 more.
her_statusA
Check server health and data source availability.
Returns server version, registered source statuses, and tool count.
Args: output_mode: Response format — "json" (default) or "text"
Returns: Server status including source availability
Tips for LLMs: Call this first to check which sources are available.
Inputs: output_mode.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 28 tools
Each tool has a distinct purpose targeting specific entity types (e.g., aerial features, monuments, conservation areas, heritage at risk) with clear separation between count, search, get, export, cross-reference, and mapping operations. Even overlapping functions like search vs. nearby are distinguished by documentation, minimizing confusion.
All tools use 'her_' prefix and snake_case, with most following a verb_noun pattern (e.g., 'her_search_monuments', 'her_get_aerial_feature'). A few outliers like 'her_capabilities', 'her_map', and 'her_nearby' deviate slightly, but the overall pattern is strong and predictable.
With 28 tools, the server covers a broad domain (multiple heritage datasets, search, count, get, export, cross-reference, mapping) without being bloated. Each tool has a clear role, and the count is appropriate for the comprehensive scope described.
The tool surface covers all essential operations for a read-only heritage data API: capability discovery, status checks, listing sources, searching/counting/getting details for multiple entity types, cross-referencing, exporting (GeoJSON, LiDAR), and mapping. No obvious gaps for the stated purpose.
Maintenance
Related MCP Connectors
Canonical British Columbia Property Intelligence & Risk Screening MCP Server.
Hosted MCP server for finding authoritative primary data sources and official portals.
MCP server for US nursing facility search and ownership lookup (NursingHomeDatabase).
MCP server for Arcoro and ExakTime — workforce data, jobs, cost codes and locations.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Python-based MCP server that provides access to Ordnance Survey APIs, allowing querying of geographic data through a standardized protocol with features like collection management, feature search, and spatial filtering.2MIT
- AlicenseBqualityDmaintenanceAn MCP server that provides tools for querying the Edinburgh Festivals API to retrieve information about events and venues across all Edinburgh festivals, including historical data.31MIT
- AlicenseBqualityFmaintenanceMCP server for querying archaeological site information from the EGIPCI service of the Generalitat de Catalunya, enabling AI editors to access Catalan archaeological data.113 npmMIT
- AlicenseNot gradedqualityBmaintenanceThis MCP server provides access to City of Houston GIS open geospatial data, enabling search, query, and schema retrieval of datasets like parcels and zoning through ArcGIS feature services.80 npmMIT