RuralCheck MCP server
RuralCheck MCP server lets an AI agent analyse rural land in Europe, fetch reports, and organise saved plots/folders through an account.
Find places from names, postcodes, coordinates, plus codes, or map links, with bounding boxes and served status.
Check whether a coordinate is covered and how finely its ground is measured.
List all checks, what they cover, runtime, and free-plan availability.
Analyse a plot: run chosen checks or every plan check, returning figures, caveats, and attribution; long-running reports return an id; new reports are limited to one a minute.
Fetch delayed reports and view a full public sample report.
Upload estate-agent listings (Professional plan) for full reports/share links, then track and list uploads.
Manage kept plots: list, get, save complete-plan reports, rename/replace notes, file into folders, move to Trash, and restore.
Manage folders: list, create, rename, and delete them without deleting their plots.
Account access via OAuth or API key; free plan runs free checks, paid plans run all checks.
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., "@RuralCheck MCP server check flood risk, road noise, and January sun for a plot near Bergerac"
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.
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 |
| 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. |
| Whether a point can be analysed, and how finely its ground is measured. |
| Every check, with what it covers, how long it takes and whether the free plan runs it. |
| Runs the checks you name for one point and returns the results. |
| Fetches a report that took longer than one tool call waits. |
| A real full report for 4 ha of land in the Dordogne valley, to see what each check returns. |
| Professional plan. Sends an agent's listings: each becomes a saved plot with a full report and a share link, run one after another. |
| An upload's progress: each listing's status, its share link, or why it was not run. |
| The account's uploads and how far each has got. |
| The plots the account keeps, with the key figure of each check. Or the Trash. |
| One kept plot with its report, as it was when it was kept. |
| Keeps a finished report under Analyse land. Only a report that ran every check of its plan. |
| Renames a kept plot or replaces its note. |
| Puts a kept plot in a folder, or takes it out of one. |
| Moves a kept plot to the Trash. It can be restored for 30 days. |
| Takes a plot out of the Trash. |
| The account's folders. |
| Makes or renames a 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-mcpClaude 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 |
| none | Your key, for stdio. Required. |
|
| Where the API is. |
|
| How long one tool call waits for a report before handing back an id. |
|
| Where the hosted server is reached, for its OAuth metadata. |
| 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 pytesttests/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 toolsanalyse_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 coverageARead-onlyIdempotentInspect
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 folderADestructiveIdempotentInspect
Delete a folder. Its plots stay in My plots, in no folder.
Inputs: folder_id (required).
delete_plotMove to TrashADestructiveIdempotentInspect
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 plotAIdempotentInspect
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 placeARead-onlyIdempotentInspect
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 progressARead-onlyIdempotentInspect
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 plotARead-onlyIdempotentInspect
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 reportARead-onlyIdempotentInspect
Fetch a report analyse_plot started, by its id. Waits if it is still running.
Inputs: report_id (required).
list_checksList checksARead-onlyIdempotentInspect
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 foldersBRead-onlyIdempotentInspect
The account's folders, each with how many plots are in it.
Inputs: no named parameters.
list_listing_uploadsList uploadsBRead-onlyIdempotentInspect
The account's listing uploads, newest first, with how far each has got.
Inputs: no named parameters.
list_plotsList plotsARead-onlyIdempotentInspect
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 folderCIdempotentInspect
Rename a folder.
Inputs: name (required), folder_id (required).
restore_plotRestore a plotAIdempotentInspect
Take a plot out of the Trash, back into its folder if that still exists.
Inputs: plot_id (required).
sample_reportSample reportARead-onlyIdempotentInspect
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 plotAIdempotentInspect
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 plotADestructiveIdempotentInspect
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
Scored across 20 tools
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.
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.
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.
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
Related MCP Connectors
UK area & property intelligence for AI agents: reports, EPC, comparables, with source provenance.
French land and real estate intelligence from public data: corporate owners (SIREN, group, BODACC), PLU zoning rules quoted page by page (OCR for scanned regulations), buildable capacity in 3D, DVF sales and price ranges, developer and operating appraisals, risks, transit isochrones, vacant plots, pre-emption and lapsed permits. 71 tools, every figure sourced; nothing is guessed. Free account, no credit card.
- Casafari MCPDeprecatedcom.casafari
Property data intelligence, built for AI agents: Europe's most complete property index.
Flood, wildfire, soils, terrain, power grid, utilities and parcels for any US location, sourced.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to perform due diligence on Irish properties by querying public datasets for planning applications, sold prices, flood risk, radon risk, and zoning.149 npm9MIT
- AlicenseAqualityFmaintenanceEnables 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.51MIT
- AlicenseBqualityBmaintenanceAutonomous AI Agent compliance engine for EU Deforestation Regulation (EU 2023/1115). Verifies farm plot GIS polygons, Sentinel-2 satellite deforestation past 2020, VIES VAT, and generates official TRACES-NT DDS XML.41MIT
- AlicenseAqualityCmaintenanceOfficial 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.9315 npm2MIT