Skip to main content
Glama
chuk-mcp-her

chuk-mcp-her

Official
by IBM

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.

Python 3.11+ License

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_map and her_crossref_map return structured MapContent for rendering in chuk-mcp-ui-compatible clients

  • All 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_aim parameter)

  • 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 separation

  • her_crossref_map -- runs the same analysis as her_cross_reference then 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

her_status

Discovery

Server health and source availability

Active

her_list_sources

Discovery

List registered data sources with capabilities

Active

her_capabilities

Discovery

Full server capability listing for LLM planning

Active

her_search_monuments

NHLE

Search scheduled monuments by location or name

Active

her_get_monument

NHLE

Get full details for a specific monument

Active

her_search_listed_buildings

NHLE

Search listed buildings with grade filter

Active

her_search_designations

NHLE

Search across all designation types

Active

her_count_features

NHLE

Fast count of features in an area

Active

her_search_aerial

Aerial

Search aerial investigation mapping data

Active

her_count_aerial

Aerial

Count aerial mapping features in an area

Active

her_get_aerial_feature

Aerial

Get full details of an aerial mapping feature

Active

her_search_conservation_areas

Conservation

Search conservation areas by name, LPA, or location

Active

her_count_conservation_areas

Conservation

Count conservation areas in an area

Active

her_get_conservation_area

Conservation

Get full details of a conservation area

Active

her_search_heritage_at_risk

At Risk

Search heritage at risk register entries

Active

her_count_heritage_at_risk

At Risk

Count heritage at risk entries in an area

Active

her_get_heritage_at_risk

At Risk

Get full details of a heritage at risk entry

Active

her_search_heritage_gateway

Gateway

Search local HER data via Heritage Gateway

Active

her_search_scotland

Scotland

Search Scottish NRHE records (320K+ sites)

Active

her_get_scotland_record

Scotland

Get full details of a Scottish NRHE record

Active

her_search_scotland_designations

Scotland

Search Scottish designated heritage assets

Active

her_cross_reference

Cross-Ref

Cross-reference candidates against known assets

Active

her_enrich_gateway

Cross-Ref

Resolve Gateway record coordinates for cross-referencing

Active

her_nearby

Cross-Ref

Find NHLE heritage assets near a point (England only)

Active

her_export_geojson

Export

Export results as GeoJSON FeatureCollection

Active

her_export_for_lidar

Export

Export known sites for LiDAR cross-referencing

Active

her_map

Map

Multi-source heritage map with colour-coded layers

Active

her_crossref_map

Map

Colour-coded cross-reference map (match/near/novel/known)

Active

Data Sources

Source

Name

Organisation

Coverage

API Type

Status

nhle

National Heritage List for England

Historic England

England

ArcGIS Feature Service

Active

aim

Aerial Investigation and Mapping

Historic England

England

ArcGIS Feature Service

Active

conservation_area

Conservation Areas

Historic England / LPAs

England

ArcGIS Feature Service

Active

heritage_at_risk

Heritage at Risk Register

Historic England

England

ArcGIS Feature Service

Active

heritage_gateway

Heritage Gateway (Local HERs)

Historic England / Local HERs

England

Web scraper

Active

scotland

Historic Environment Scotland

Historic Environment Scotland

Scotland

ArcGIS Map Service

Active

NHLE Designation Types

Type

Description

listed_building

Listed buildings (Grades I, II*, II)

scheduled_monument

Scheduled monuments

park_and_garden

Registered parks and gardens

battlefield

Registered battlefields

protected_wreck

Protected wreck sites

world_heritage_site

World Heritage Sites

Installation

uvx chuk-mcp-her
# 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 --dev

Using pip (Traditional)

pip install chuk-mcp-her

Optional: 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-her

STDIO 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 her

Example 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 assets

Script

Network

Tools Demonstrated

capabilities_demo.py

No

her_capabilities, her_list_sources, her_status

quick_start.py

Yes

her_status, her_count_features, her_search_monuments, her_get_monument, her_nearby

nhle_search_demo.py

Yes

her_search_monuments, her_get_monument, her_search_listed_buildings, her_search_designations, her_count_features

aerial_search_demo.py

Yes

her_search_aerial, her_count_aerial, her_get_aerial_feature

conservation_area_demo.py

Yes

her_search_conservation_areas, her_count_conservation_areas, her_get_conservation_area

heritage_at_risk_demo.py

Yes

her_search_heritage_at_risk, her_count_heritage_at_risk, her_get_heritage_at_risk

nearby_demo.py

Yes

her_nearby

export_demo.py

Yes

her_export_geojson, her_export_for_lidar

gateway_search_demo.py

Yes

her_search_heritage_gateway

cross_reference_demo.py

Yes

her_cross_reference (with include_aim)

enrichment_pipeline_demo.py

Yes

her_enrich_gateway, her_search_heritage_gateway, her_cross_reference, her_count_features

blackwater_estuary_scenario.py

Yes

Multi-source scenario using NHLE, AIM, Conservation Areas, Heritage at Risk

scotland_search_demo.py

Yes

her_search_scotland, her_get_scotland_record

scotland_designations_demo.py

Yes

her_search_scotland_designations, her_search_scotland

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 responses

  • Source 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 MapContent structured views via chuk_view_schemas.chuk_mcp.map_tool decorator

  • Dual Output: Most tools support output_mode="text" for human-readable responses; map tools return structured MapContent

  • Error Messages: All error strings from ErrorMessages constants -- 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 -v

Code 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 build

Configuration

Environment Variables

Variable

Default

Description

MCP_STDIO

-

Set to any value to force stdio mode

HER_CACHE_DIR

~/.cache/chuk-mcp-her

Filesystem cache directory

HER_NHLE_CACHE_TTL

86400

NHLE cache TTL in seconds (24 hours)

HER_AIM_CACHE_TTL

604800

AIM cache TTL in seconds (7 days)

HER_HG_CACHE_TTL

3600

Heritage Gateway cache TTL in seconds (1 hour)

HER_RATE_LIMIT

5.0

Max requests per second to ArcGIS

HER_TIMEOUT

30.0

HTTP request timeout in seconds

License

Apache License 2.0 -- See LICENSE for details.

References

Available Tools

28 tools
her_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_mapA
Read-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_mapA
Read-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

    A4.1/5.0

    Scored across 28 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      2
      MIT
    • A
      license
      B
      quality
      F
      maintenance
      MCP server for querying archaeological site information from the EGIPCI service of the Generalitat de Catalunya, enabling AI editors to access Catalan archaeological data.
      1
      13 npm
      MIT