Skip to main content
Glama
RuralCheck MCP server

RuralCheck MCP server

RuralCheck MCP server

This server lets an AI agent analyse a plot of rural land in Europe with RuralCheck. Ask Claude, ChatGPT or any other MCP client whether a field floods, how loud the road is, how many hours of sun the house gets in January, or which land-register plot it is. The agent calls RuralCheck and gets back computed figures with their sources.

What it can answer

A report is a set of checks. You ask only for the ones you need, and each comes back with its figure, its caveats and where it came from.

Group

Checks

View

how far the view runs, and what is in view

Local area

nearest village and town, people nearby, shops and services, bodies of water, emergency services, drive times, local economy, visitors, sales nearby, town websites, hunting

Annoyances

road and rail noise, aircraft, nuisances, bites and stings, wild animals, burglary

Plot

land register, paths on the plot, municipality, planning zone, rules here, tax when you buy, yearly property tax, terrain, protected areas

Weather and climate

weather, sun, wind, snow, night sky, air quality, climate in 2050

Risks

flooding, coastal flooding, wildfire, landslides, avalanches, earthquake, termites and dry rot

Infrastructure

solar panels, groundwater, water restrictions, internet

Vegetation

trees, pollen, what grows here

Access

public transport, access road

list_checks returns the current list with what each check covers, how long it takes and whether the free plan runs it.

Every number is derived from official data. A report is not a land survey, a valuation or legal advice. It covers the parts of Europe where the ground is measured finely enough, and check_coverage says whether a point is one of them.

Related MCP server: microfarm-mcp

Tools

Every tool needs a RuralCheck account. The free plan runs the free checks, with the same limits as on the map, and a paid plan runs every check. An account can start one new report a minute through analyse_plot. Fetching one with get_report does not count. More than one a minute is a Custom solution.

Nothing here deletes a plot for good. A deleted plot goes to the Trash on the account, and is removed 30 days later or when the reader empties the Trash on the website.

Tool

What it does

find_place

A village, town, region, country or postcode to coordinates. An area comes with its extent and whether reports are made there. Street addresses are found in Norway, Belgium and Denmark, and elsewhere reduced to their town.

check_coverage

Whether a point can be analysed, and how finely its ground is measured.

list_checks

Every check, with what it covers, how long it takes and whether the free plan runs it.

analyse_plot

Runs the checks you name for one point and returns the results.

get_report

Fetches a report that took longer than one tool call waits.

sample_report

A real full report for 4 ha of land in the Dordogne valley, to see what each check returns.

upload_listings

Professional plan. Sends an agent's listings: each becomes a saved plot with a full report and a share link, run one after another.

get_listing_upload

An upload's progress: each listing's status, its share link, or why it was not run.

list_listing_uploads

The account's uploads and how far each has got.

list_plots

The plots the account keeps, with the key figure of each check. Or the Trash.

get_plot

One kept plot with its report, as it was when it was kept.

save_plot

Keeps a finished report under Analyse land. Only a report that ran every check of its plan.

update_plot

Renames a kept plot or replaces its note.

file_plot

Puts a kept plot in a folder, or takes it out of one.

delete_plot

Moves a kept plot to the Trash. It can be restored for 30 days.

restore_plot

Takes a plot out of the Trash.

list_folders

The account's folders.

create_folder, rename_folder

Makes or renames a folder.

delete_folder

Deletes a folder. Its plots stay, in no folder.

Answers are JSON, returned as text: the figures, their caveats, and the attribution for the data behind them. Map outlines and pictures are left out.

Use it

Hosted

The server is at https://ruralcheck.eu/mcp. It signs you in with OAuth, so Claude and ChatGPT need nothing but the address:

  • Claude: Customize, Connectors, +, Add custom connector, enter the address, then Connect and allow it on the RuralCheck page.

  • ChatGPT: turn on Developer mode under Settings, Security and login. Then open Plugins, select +, enter the address, and allow it on the RuralCheck page.

Clients that take a header can use an API key from your account page instead. In Claude Code:

claude mcp add --transport http ruralcheck https://ruralcheck.eu/mcp \
  --header "Authorization: Bearer $RURALCHECK_API_KEY"

On your own machine

Python 3.10 or newer. With uv:

uvx --from git+https://github.com/cmosig/ruralcheck-mcp ruralcheck-mcp

Claude Desktop, Cursor and most other clients take a block like this:

{
  "mcpServers": {
    "ruralcheck": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/cmosig/ruralcheck-mcp", "ruralcheck-mcp"],
      "env": { "RURALCHECK_API_KEY": "rc_..." }
    }
  }
}

ruralcheck-mcp --http --port 8765 serves streamable HTTP instead of stdio, with the OAuth sign-in in front of it. A request without a token gets a 401 that points at /.well-known/oauth-protected-resource/mcp, which names ruralcheck.eu as the authorization server. The token a client comes back with is an ordinary API key. The server keeps none: it checks each token with the API and passes it on.

Variable

Default

Meaning

RURALCHECK_API_KEY

none

Your key, for stdio. Required.

RURALCHECK_BASE_URL

https://ruralcheck.eu

Where the API is.

RURALCHECK_WAIT_S

45

How long one tool call waits for a report before handing back an id.

RURALCHECK_PUBLIC_URL

https://ruralcheck.eu

Where the hosted server is reached, for its OAuth metadata.

RURALCHECK_AUTH_URL

the public URL

The OAuth authorization server.

Attribution

The data behind each answer is published under licences that require credit. Every report carries an attribution list. Show it to whoever reads the results.

Develop

python -m venv .venv && .venv/bin/pip install -e . pytest
.venv/bin/python -m pytest

tests/test_server.py runs against a fake API and needs no network. tests/test_live.py drives every tool against a real instance and is skipped unless RURALCHECK_LIVE_URL and RURALCHECK_API_KEY are set. Run it whenever the API changes.

The contract lives under /api/v1/ on ruralcheck.eu: checks, coverage, search, sample, reports with a long-polling ?wait= and ?drawing=false, and plots and folders for the plots the website lists under Analyse land.

Licence

The code in this repository is MIT licensed. The reports it fetches are covered by the RuralCheck terms and by the licences listed in each report's attribution.

Available Tools

20 tools
analyse_plotAnalyse a plotAInspect

Analyse a plot of rural land in Europe and return the result of each check.

Checks a chosen one depends on run too and are returned with it. Most answers take a few seconds. If one runs longer than this call waits, the answer carries an id to pass to get_report.

An account can start one new report a minute, so name every check needed in one call. Fetching a report with get_report does not count.

Show the attribution lines to whoever reads the results: the data licences require it.

Inputs: lat (required), lon (required), checks.

check_coverageCheck coverageA
Read-onlyIdempotent
Inspect

Whether RuralCheck can analyse this point, and how finely the ground is measured.

served: false means analyse_plot will refuse the point, and the answer says why.

Inputs: lat (required), lon (required).

create_folderNew folderAInspect

Make a folder for kept plots. Each name can be used once, whatever the case.

Inputs: name (required).

delete_folderDelete folderA
DestructiveIdempotent
Inspect

Delete a folder. Its plots stay in My plots, in no folder.

Inputs: folder_id (required).

delete_plotMove to TrashA
DestructiveIdempotent
Inspect

Move a kept plot to the Trash.

It can be restored with restore_plot until its deleted_after date, 30 days on, and is then removed for good. Nothing through this server deletes a plot at once.

Inputs: plot_id (required).

file_plotFile a plotA
Idempotent
Inspect

Put a kept plot in a folder, or take it out of the one it is in.

Inputs: plot_id (required), folder_id.

find_placeFind a placeA
Read-onlyIdempotent
Inspect

Turn a village, town, region, country or postcode in Europe into coordinates.

Also reads plus codes and map links. A region, country or postcode comes back with bbox (west, south, east, north) and served (yes, part or no: whether reports are made there). Street addresses are found in Norway, Belgium and Denmark. Elsewhere an address is reduced to the settlement it names and marked approximate. When nothing is found, message says what to add.

Inputs: query (required).

get_listing_uploadUpload progressA
Read-onlyIdempotent
Inspect

An upload's progress: for each listing its status, its share link once its report is done, or the reason it was not run. status is "done" when nothing is left to run.

Inputs: upload_id (required).

get_plotGet a plotA
Read-onlyIdempotent
Inspect

One kept plot with its report, as it was when it was kept.

report.current is false when the checks have changed since. Running analyse_plot again and keeping the result brings it up to date.

Inputs: plot_id (required).

get_reportGet a reportA
Read-onlyIdempotent
Inspect

Fetch a report analyse_plot started, by its id. Waits if it is still running.

Inputs: report_id (required).

list_checksList checksA
Read-onlyIdempotent
Inspect

Every check a report can run: its name, what it answers, roughly how long it takes, and whether the free plan runs it (free). Pass names from here to analyse_plot.

Inputs: no named parameters.

list_foldersList foldersB
Read-onlyIdempotent
Inspect

The account's folders, each with how many plots are in it.

Inputs: no named parameters.

list_listing_uploadsList uploadsB
Read-onlyIdempotent
Inspect

The account's listing uploads, newest first, with how far each has got.

Inputs: no named parameters.

list_plotsList plotsA
Read-onlyIdempotent
Inspect

The plots this account keeps, newest first, with the key figure of each check, and the account's folders.

Plots in the Trash are left out unless in_trash is true. Each one there has a deleted_after date. It can be restored until then.

Inputs: in_trash, folder_id.

rename_folderRename folderC
Idempotent
Inspect

Rename a folder.

Inputs: name (required), folder_id (required).

restore_plotRestore a plotA
Idempotent
Inspect

Take a plot out of the Trash, back into its folder if that still exists.

Inputs: plot_id (required).

sample_reportSample reportA
Read-onlyIdempotent
Inspect

The public sample: a real full report for 4 ha of land at Trémolat in the Dordogne valley, France.

Use it to see what each check returns before asking for a report of your own.

Inputs: checks.

save_plotSave a plotA
Idempotent
Inspect

Keep a finished report in My plots.

Only a report that ran every check of the account's plan can be kept, so call analyse_plot without naming checks first. Keeping the same point again replaces its report, keeps its name and note, and takes it out of the Trash if it was there.

Inputs: report_id (required), name, folder_id.

update_plotEdit a plotA
DestructiveIdempotent
Inspect

Rename a kept plot or replace its note. A plot in the Trash must be restored first.

Inputs: plot_id (required), name, note.

upload_listingsUpload listingsAInspect

Send an estate agent's listings to RuralCheck. Professional plan.

Each listing becomes a saved plot with a full report and a share link the agent can put in the listing. Reports run one after another on the server, about half a minute each, and wait for anyone using the site, so this returns at once with the upload's id. Follow it with get_listing_upload. Up to 100 listings run from one upload. A listing that is not run comes back with the reason, for example no position, outside the area covered, or past the limit. A listing already saved with a current report is not run again. One upload runs at a time on an account.

Inputs: listings (required), name.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 20 tools

    Disambiguation4/5

    Most tools target distinct resources or lifecycle stages: plot management, folder management, uploads, checks/reports, and geography. The main potential overlap is find_place versus check_coverage, since find_place also returns `served`, but check_coverage is clearly framed as the analysis eligibility check. get_report, get_plot, and get_listing_upload are also separable by their resource names.

    Naming Consistency4/5

    The set is predominantly consistent snake_case with a verb_noun pattern across CRUD and lifecycle tools: list_plots, get_plot, save_plot, update_plot, delete_plot, create_folder, etc. Minor deviations like sample_report and the plural-heavy list_listing_uploads are readable and do not undermine the overall convention.

    Tool Count3/5

    At 20 tools, the surface is at the heavy end of the recommended range, partly because plot CRUD and folder CRUD are expanded into many individual operations. Each tool has a coherent role, but the count is borderline for the server's scope and could tempt consolidation.

    Completeness4/5

    Core workflows are well covered: place lookup, coverage checking, report analysis, report fetching, sample reports, upload progress, plot lifecycle including trash/restore, and folder CRUD. Minor gaps exist, such as no explicit upload cancellation or per-listing retry operation, but they are unlikely to block typical agent workflows.

    Maintenance

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to perform due diligence on Irish properties by querying public datasets for planning applications, sold prices, flood risk, radon risk, and zoning.
      1
      49 npm
      9
      MIT
    • A
      license
      A
      quality
      F
      maintenance
      Enables AI assistants to assess any parcel for micro-farm viability (climate, water, farmland context, access, flood risk) and dwelling feasibility, and to find real land for sale from free, keyless public data sources.
      5
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Official cadastral parcels from 29 European countries for AI agents: by reference in 27 and by coordinates in all 29, plus address search, outlines, neighbours, SIGPAC enclosures, terrain, ground motion, solar and agricultural potential and investment scores. Remote server at https://mcp.parcelgps.com/mcp (nothing to install) or npm catastro-gps-mcp. Free key: 250 calls/month.
      9
      315 npm
      2
      MIT