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.

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.

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.

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.

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.