Skip to main content
Glama

Microfarm MCP

Boden-Intelligenz für angehende Kleinstbauern – ein kostenloser Open-Source-MCP-Server, der sich in Claude, Cursor oder jede MCP-fähige KI einbinden lässt, um die zwei Fragen zu beantworten, die bei einem Stück Land zählen:

  1. Ist dieses Grundstück tatsächlich gut zum Anbau von Lebensmitteln?

  2. Darf ich dort legal ein Haus bauen?

…und findet echtes Land zum Verkauf, um es überhaupt erst zu bewerten.

Ein Werkzeug für Verwalter, nicht für Spekulanten.

License: MIT Python 3.10+ CI tests


Warum es das gibt

Jeder sollte Land besitzen – denn das ist es, was dich reich machen wird. Nicht Geld, nicht schöne Autos – sondern Land, das du bebauen, bewirtschaften und bereichern kannst; Land, das für dich und deine Familie, deine Nachbarn und deine Gemeinschaft sorgt; Land, das Tiere ernährt und Leben erhält.

– der Grund, warum dieses Projekt existiert

Das meiste, was der Immobilienmarkt mit Land macht, ist Spekulation. Dieses Werkzeug ist für die Menschen, die ein Stück Boden wollen, um es zu besitzen, darauf zu leben und es zu pflegen – Wasser, Mutterboden, eine nutzbare Saison und die ehrliche Antwort darauf, ob sie dort tatsächlich bauen dürfen. Es rät nicht: Jedes Signal stammt aus einer benannten öffentlichen Quelle, und alles, was es nicht wissen kann, wird gekennzeichnet, nie erfunden.

Funktioniert in den USA, Frankreich und Zypern – und bewertet Land überall dort, wo Open-Meteo + OSM Daten haben. Was genau verfügbar ist, unterscheidet sich je nach Land, hier also das ehrliche Bild:

Related MCP server: Plantos MCP Server

Länderabdeckung

Land

Land bewerten (assess_land)

Land zum Verkauf finden (find_land)

Hochwasser-/Wohngebäude-Check

USA

✅ vollständig Klima + Wasser + Ackerland + Landtyp

✅ farms.com + Craigslist (live)

✅ FEMA-Überschwemmungszone

Zypern

✅ vollständig

✅ index.cy (live; griechische/englische Titel)

⚠️ keine Hochwasserdaten – kennzeichnet „mit Planungsbehörde bestätigen"

Frankreich

✅ vollständig

🔜 browser-gesperrt (leboncoin.fr, offer.com.cy) – noch nicht gescraped

⚠️ keine Hochwasserdaten – kennzeichnet „mit Mairie/DDT bestätigen"

Überall sonst (überall, wo Open-Meteo + OSM Daten haben)

✅ Klima, Wasser, Ackerland, Landtyp, Zugang

❌ keine Listungsquelle angebunden

⚠️ keine Hochwasserdaten

Bewertungs-Legende: ✅ = funktioniert jetzt · ⚠️ = funktioniert, mit ehrlichem „lokal bestätigen"-Hinweis · 🔜 = registriert, benötigt aber einen Browser (siehe land_sources.browser_only)

Was global vs. länderspezifisch ist:

  • Global (funktioniert fast überall): Klima (Niederschlag, Vegetationsperiode, Winterhärte), Gewässer, Ackerland, Landtyp, Straßen/Zugang – das ist es, was assess_land bewertet, und es nutzt Open-Meteo + OpenStreetMap, beide weltweit.

  • Länderspezifisch: find_land-Listings stammen von länderspezifischen Websites; Überschwemmungszonen kommen von FEMA, das nur in den USA verfügbar ist – der Hochwasser-Check für Wohngebäude gilt also wirklich nur für die USA, und anderswo sagt das Tool ehrlich „bestätigen Sie mit Ihrer örtlichen Planungsbehörde", statt zu raten.

Werkzeuge

Werkzeug

Was es tut

assess_land

Bewertet ein Grundstück auf Mikrofarm-Tauglichkeit und Wohnbebaubarkeit – Niederschlag, Vegetationsperiode, Wasserzugang, Ackerland-Kontext, Landtyp, Baumbestand, Nachbarn/Privatsphäre, Boden (Fruchtbarkeit, pH-Wert, Textur → Grundwasserneubildung), Zugang, Überschwemmungszone. Liefert ein evidenzbasiertes vielversprechend / erfordert_Prüfung / wahrscheinlich_ungeeignet-Urteil.

find_land

Findet echtes Land zum Verkauf aus kostenlosen Quellen mit Preis, Größe, Fotos, Beschreibung, Standort – und einem country/state-Filter.

zone

Erklärt einen Planungszonen-Code und ob ein Wohngebäude auf Ackerland erlaubt ist – für Frankreich (A/U/AU/N + STECAL/Erweiterungsregeln, Bedingungen für „logement de fonction"), Zypern (Γη3/ΚΑ6/H2) und die USA (landwirtschaftliche Bezirke).

land_sources

Listet die kostenlosen öffentlichen Datenquellen + Lizenzen auf (Transparenz & Quellenangabe).

about_microfarm

Verständliche Erklärung, worauf man bei Land achten sollte.

Alles ist evidenzbasiert: Jedes Signal nennt seine Quelle, und fehlende Daten werden als fehlend gemeldet – nie als „gut" behandelt.

Schnellstart

git clone https://github.com/omardaaboul/microfarm-mcp.git
cd microfarm-mcp
python3 -m venv .venv
.venv/bin/pip install -e ".[test]"
.venv/bin/microfarm-mcp            # start the server (stdio)

Verbinden mit Claude / Cursor / OpenCode / Gemini / jedem MCP-Client

Microfarm ist ein Standard-MCP-Server, sodass jedes Tool, das MCP unterstützt, es nutzen kann. Die genaue Einrichtung hängt vom Client ab:

Claude Desktop – claude_desktop_config.json:

{
  "mcpServers": {
    "microfarm-mcp": {
      "command": "python3",
      "args": ["-m", "microfarm.server"],
      "env": { "PYTHONPATH": "/absolute/path/to/microfarm-mcp" }
    }
  }
}

Claude Code – claude mcp add:

claude mcp add microfarm-mcp -- python3 -m microfarm.server

Cursor – .cursor/mcp.json:

{
  "mcpServers": {
    "microfarm-mcp": {
      "command": "python3",
      "args": ["-m", "microfarm.server"],
      "env": { "PYTHONPATH": "/absolute/path/to/microfarm-mcp" }
    }
  }
}

OpenCode – opencode.json (Repository) oder ~/.config/opencode/config.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "microfarm-mcp": {
      "type": "local",
      "command": ["python3", "-m", "microfarm.server"],
      "cwd": "/absolute/path/to/microfarm-mcp",
      "enabled": true,
      "timeout": 10000
    }
  }
}

Gemini CLI – ~/.gemini/settings.json:

{
  "mcpServers": {
    "microfarm-mcp": {
      "command": ["python3", "-m", "microfarm.server"],
      "env": { "PYTHONPATH": "/absolute/path/to/microfarm-mcp" }
    }
  }
}

VS Code (integrierter Copilot MCP / Erweiterung) – .vscode/mcp.json:

{
  "servers": {
    "microfarm-mcp": {
      "type": "stdio",
      "command": "python3",
      "args": ["-m", "microfarm.server"],
      "env": { "PYTHONPATH": "/absolute/path/to/microfarm-mcp" }
    }
  }
}

Eine Anmerkung zu ChatGPT. ChatGPT unterstützt MCP nur als Remote-HTTPS-Server, und diese Funktion ist derzeit auf Business/Enterprise-Tarife beschränkt. Ein lokaler stdio-Server (das, was dieses Repository standardmäßig ausführt) kann nicht direkt in ChatGPT eingebunden werden. Um es in ChatGPT zu nutzen, müsstest du den Server remote hosten und ChatGPT seine HTTPS-URL geben – ein echter Schritt, kein Konfigurations-Tweak. Für die lokale Nutzung sind Claude, Cursor, OpenCode oder Gemini CLI die einfachen Wege.

Dann frag einfach deinen Assistenten:

„Ist dieses Grundstück in der Dordogne gut für einen kleinen Bauernhof, und kann ich dort ein Haus bauen?"

„Finde mir Land unter 150.000 € im Bezirk Paphos und sag mir, welches einen Besuch wert aussieht."

Wie die Ergebnisse aussehen

assess_land("Polemi, Paphos, Cyprus")
→ promising | 75
  [positive] adequate_precipitation: ~426 mm/yr
  [positive] long_season:            ~363 growing days/yr
  [positive] water_access:           5 water feature(s) nearby
  [positive] farmland:               27 farm land tag(s) nearby
  [caution]  land_type:              built-up
  [caution]  tree_cover:             little/no mapped tree cover
  [caution]  privacy:                23 structures nearby
  [positive] soil_fertility:         ~42 g/kg organic carbon
  [caution]  soil_ph:                pH ~7.8
  [caution]  well_recharge:          ~33% clay / ~23% sand
  [positive] access:                 158 road segment(s) nearby

zone("A", "France")   → explains agricultural zone + when a dwelling is allowed
zone("Γη3", "Cyprus") → agricultural zone, min ~4,000m² for one rural dwelling

Datenquellen & Quellenangabe

Dies sind die kostenlosen, schlüssellosen öffentlichen Quellen hinter jeder Antwort. Wenn du dieses Projekt oder seine Daten in deiner eigenen Arbeit verwendest, nenne bitte die folgenden Quellen – mehrere erfordern eine Quellenangabe laut Lizenz.

Quelle

Was sie liefert

Lizenz / Quellenangabe

Open-Meteo Geocoding

Ortsname → Breitengrad/Längengrad, Höhe

CC BY 4.0

Open-Meteo Historical Climate

Niederschlag, Temperatur, Wachstumstage

CC BY 4.0

Open-Meteo Elevation

Geländehöhe

CC BY 4.0

ISRIC SoilGrids

Oberboden: organischer Kohlenstoff, pH-Wert, Ton/Sand/Schluff-Textur, KAK

CC BY 4.0

OpenStreetMap über Overpass API

Gewässer, Gebäude, Straßen, Ackerland, Bäume

ODbL

FEMA National Flood Hazard Layer

Überschwemmungszone an einem Punkt (nur USA)

US-Bundesbehörde, Public Domain (Daten), ArcGIS-Dienst von FEMA

farms.com

US-Farm-/Land-Listings (find_land)

Seiteninhalte gehören ihnen; wir verlinken auf Listings

Craigslist

US-Land-Listings von Eigentümern (find_land)

Seiteninhalte gehören ihnen; wir verlinken auf Listings

index.cy

Zypriotische Grundstücks-/Land-Listings (find_land)

Seiteninhalte gehören ihnen; wir verlinken auf Listings

Open-Meteo bündelt nationale Wetterdienste; seine API ist unter CC BY 4.0 lizenziert, und wir nutzen sie dankbar. OpenStreetMap-Daten sind © OpenStreetMap-Mitwirkende unter der Open Database License. Listing-Inhalte gehören den jeweiligen Marktplätzen – wir zeigen sie an und verlinken auf ihre Seiten, hosten ihre Bilder aber nie neu.

Landtyp, Zone & die Frage „Kann ich hier ein Wohngebäude bauen?"

  • Landtyp (Ackerland / Weideland / Wald / Buschland / bebaut / am Wasser) und Baumbestand werden aus OpenStreetMap erkannt und in jeder Bewertung gemeldet.

  • Offizielle Zonierung – was du auf dem Land legal bauen oder tun darfst – ist nicht aus kostenlosen nationalen Daten verfügbar. Sie wird von örtlichen Planungsbehörden (US-County, zypriotische Planungsbehörde, französische Mairie/DDT) festgelegt und in Grundbuchurkunden / Katastern / PLU-Dokumenten festgehalten, die nicht frei maschinenlesbar sind. Das zone-Werkzeug erklärt die Codes (Frankreich A/U/N, Zypern Γη/ΚΑ, US- landwirtschaftliche Bezirke) und ihre üblichen Bauregeln – einschließlich der spezifischen Bedingungen für ein Farm-Wohngebäude / logement de fonction – und sagt dir genau, was du mit der örtlichen Behörde bestätigen musst. Es ist ein Leitfaden, nie ein Ersatz für die offizielle Aufzeichnung.

Ehrliche Grenzen

  • Bau- und Wohnungsrecht ist lokal geregelt. Dieses Tool ist eine erste Einschätzung anhand öffentlicher Daten (Hochwasser- und Agrarlandkontext); es ersetzt nicht die offizielle Verordnung. Prüfen Sie immer persönlich vor Ort und mit den örtlichen Behörden.

  • Hochwasserdaten gibt es nur für die USA (FEMA). Außerhalb der USA wird ehrlicherweise als nicht verfügbar angegeben – niemals fälschlich „keine Gefahr“.

  • Einige Anzeigenportale sind nur im Browser zugänglich (landbanksearch, govdeals, farmflip, Bazaraki, land.cy, offer.com.cy, leboncoin.fr). Sie sind registriert, aber noch nicht ausgelesen; land_sources zeigt die Grenze zwischen dem, was automatisiert erreichbar ist, und dem, was nur im Browser verfügbar ist.

  • Geo-Regionsnamen wie „Limousin“ (2016 aufgelöst) lassen sich möglicherweise nicht geokodieren – verwenden Sie eine aktuelle Stadt oder einen aktuellen Bezirk.

  • Griechische Anzeigentitel erhalten eine einfache wörtliche Übersetzung; unklare Ortsnamen können auf Griechisch bleiben.

Entwicklung

.venv/bin/ruff check microfarm tests   # lint
.venv/bin/ruff format --check microfarm tests
.venv/bin/mypy microfarm               # type-check
.venv/bin/pytest tests/ -q             # 43 tests (mocked providers, deterministic)

CI führt Linting, Formatierung, Typprüfung, Tests und einen Paket-Build unter Python 3.10 / 3.11 / 3.12 durch.

Projektstruktur

microfarm-mcp/
├── microfarm/
│   ├── server.py       ← FastMCP server (5 tools)
│   ├── engine.py       ← orchestration + cache + find_land
│   ├── providers.py    ← free data providers (Open-Meteo, SoilGrids, OSM, FEMA)
│   ├── listings.py     ← land-listing collectors (farms.com, Craigslist, index.cy)
│   ├── scorer.py       ← evidence-backed viability + dwelling scoring
│   ├── zones.py        ← planning-zone explainer (France, Cyprus, US)
│   └── models.py       ← typed pydantic models
├── tests/              ← 43 tests
├── configs/            ← ready-to-use MCP client configs (Claude, Cursor,
│                         OpenCode, Gemini CLI, VS Code, generic)
├── .github/workflows/ci.yml
└── pyproject.toml

Lizenz & Haftungsausschluss

MIT-lizenziert – Sie dürfen es frei verwenden, verändern und teilen.

Dies ist keine Finanz-, Rechts- oder Immobilienberatung. Prüfen Sie eine Immobilie immer persönlich und bei der örtlichen Planungsbehörde, bevor Sie sich darauf verlassen. Die Daten stammen aus den oben genannten freien öffentlichen Quellen und können unvollständig or unvollkommen sein.

Available Tools

5 tools
about_microfarmA

Plain-language explanation of what a micro-farm is and what to look for in land.

NameRequiredDescriptionDefault
textYes

TDQS

A3.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description must carry the full burden of behavioral disclosure. It accurately conveys that this is a read-only, non-destructive information tool with no stated side effects. The description honestly represents the tool's output as an explanation. However, it could be more explicit that this likely returns static textual content and doesn't query external data.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single, well-structured sentence that front-loads the core purpose ('plain-language explanation') and immediately specifies the two topical areas. No wasted words; every element contributes to the definition. It is concise without being under-specified.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the simple informational nature of the tool, the description is nearly complete for an agent to understand its purpose and content. While it could benefit from mentioning the expected format of the response (e.g., 'returns a paragraph'), the description covers the essential 'what' and 'why' sufficiently. The main gap is the undocumented parameter, which is already penalized in the parameter semantics dimension.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema defines a single required 'text' parameter with zero description coverage. The tool description provides absolutely no guidance on what this parameter means, what format it should be in, or how it should be populated. For a required parameter, this is a critical gap that forces the agent to guess.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states this tool provides a 'plain-language explanation' of micro-farms and what to look for in land. This distinguishes it from the action-oriented sibling tools (find_land, assess_land) by being informational rather than transactional, though it doesn't explicitly name the siblings.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies this tool is for learning foundational context before using other tools, but it never explicitly states when to choose this over alternatives like 'zone' or 'land_sources'. It lacks a clear when-to-use and when-not-to-use directive, leaving the agent to infer the intended use case from the phrase 'plain-language explanation'.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

assess_landA

Assess a US parcel for small-scale (micro) farming viability AND whether a dwelling is likely feasible there.

Provide a place name/address like 'Petaluma, California' or 'Lamoille County, VT', OR explicit lat/lon. Uses free public data (Open-Meteo climate + geocoding + elevation, OpenStreetMap land/water/roads/farmland, FEMA flood zones) to score precipitation, growing season, water access, farmland context, access, and dwelling feasibility. Every signal lists its source; missing data is flagged.

NameRequiredDescriptionDefault
latNo
lonNo
placeNo

Output Schema

NameRequiredDescription
dataNo
scoreNo
stateYes
signalsNo
summaryYes
next_actionNo
missing_dataNo
dwelling_feasibilityNo

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full disclosure burden. It enumerates the data sources (Open-Meteo, OpenStreetMap, FEMA), lists the scored dimensions (precipitation, growing season, water access, etc.), and explicitly notes that sources are listed and missing data is flagged. This goes beyond a simple summary and gives an agent reliable expectations about behavior and limitations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is moderately long but each sentence earns its place: purpose, input format, data sources and scoring criteria, and data transparency. It is well front-loaded with the core purpose and avoids redundancy or off-topic filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the existence of an output schema, the description does not need to describe the return structure. It covers all essential operational aspects: how to specify the target location, what data sources are used, what criteria are scored, and how missing data is handled. No critical gaps remain for an agent to invoke the tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema provides no descriptions for lat, lon, or place (0% coverage), so the description must compensate. It clarifies that either place or lat/lon can be used, gives concrete examples ('Petaluma, California' or 'Lamoille County, VT'), and implies that lat/lon are alternatives to place. This adds genuine meaning beyond the raw schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb 'Assess' and a resource 'US parcel', then explicitly names the two evaluation outcomes: micro-farming viability and dwelling feasibility. This makes it unmistakable how it differs from sibling tools like 'find_land' (searching for parcels) and 'zone' (zoning rules), which the description naturally distinguishes by focusing on assessment rather than discovery or zoning.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It explains how to supply input (place name/address or lat/lon) with examples, which is useful, but does not state when to prefer this tool over siblings or when not to use it. The intended use case (assess a specific parcel) is implied rather than explicitly contrasted with alternatives, so guidance is partial.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

find_landA

Find real land for sale from free, accessible online sources (farms.com, Craigslist, and index.cy for Cyprus), optionally filtered by country/state/price/acreage. Each listing includes price, land size, location, and photo URLs where available.

Examples: find_land(country="CY") → Cyprus plots from index.cy (Greek & English listings, titles translated). find_land(state="OH") → US farms. Free, no key. Browser-only sources are listed in browser_only_sources.

NameRequiredDescriptionDefault
limitNo
stateNo
countyNo
countryNo
max_acresNo
min_acresNo
max_price_usdNo

TDQS

A3.5/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It does note that sources are 'free, accessible online' and 'browser-only', and that titles are translated for Cyprus, which is useful. However, it does not disclose potential delays, rate limits, or that results may be incomplete or inconsistent across sources. The mention of 'browser-only sources' hints at limitations but could be more explicit about the need for browser automation or potential unreliability.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is relatively concise, with a clear first sentence and a paragraph of examples. It front-loads the core purpose and then gives illustrative cases. However, the line 'Browser-only sources are listed in browser_only_sources' is a bit cryptic and could be clearer. Overall, it is structured well, but there is some repetition of the source list that could be trimmed.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the lack of annotations and output schema, the description does a decent job of covering the basics: what it does, sources, filters, and output fields. However, it leaves out important context like the nature of the 'browser-only_sources' (is it a parameter? a tool?), and it does not mention potential errors, rate limits, or how to handle results. For a tool with 7 parameters, this is incomplete but not severely so.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 7 parameters with 0% description coverage, so the description must compensate. It does not describe each parameter individually, but the examples illustrate how to use 'country' and 'state', and the description mentions filters for price and acreage. Since all parameters are optional and have defaults, this is adequate, but a bit more per-parameter detail would be helpful, especially for 'county' which is not mentioned.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's function: finding land for sale from specific online sources, with optional filters. It also gives examples and mentions the output fields (price, size, location, photos), which helps the agent understand the tool's purpose. It doesn't explicitly contrast with siblings like land_sources, but the verb 'find' and the detail about filtering distinguish it somewhat.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides usage examples (e.g., find_land(country='CY')) and states the sources, but it does not explicitly say when to use this tool versus alternatives like land_sources or assess_land. The guidance is implied through the examples, but there is no clear 'when not to use' or alternative routing. Given the sibling names, an agent might not know whether to use find_land or land_sources without further context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

land_sourcesA

List the free, keyless public data sources this server uses (transparency).

NameRequiredDescriptionDefault

No parameters

TDQS

A4.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden and does well by consistently describing the tool as read-only ('List') and disclosing the nature of the data (free, keyless, public). This implies no authentication or side effects, though it doesn't explicitly state the response format or that no state changes occur, which is a minor gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single sentence that front-loads the action, specifies the resource with qualifying attributes, and states the purpose. Every word earns its place with zero redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a parameterless, output-schema-less informational tool, the description is complete. It tells the agent exactly what information is provided (list of sources), their properties (free, keyless, public), and the rationale (transparency), leaving no obvious gap for correct invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parameters, so the schema trivially covers 100% and the baseline is 4. The description adds no parameter-specific information, but none is needed—there is nothing to explain.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action (List), the resource (free, keyless public data sources), and the purpose (transparency). This distinguishes it from siblings like assess_land and find_land, which are operational land tools, making the tool's role obvious.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Although it doesn't explicitly contrast with sibling tools, the description makes it clear this is for transparency about data sources, which is distinct from the land-focused actions. The 'transparency' purpose implies usage when a user inquires about data provenance, making the intended context clear without ambiguity.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

zoneA

Explain a planning-zone code and what it means for building a dwelling on farmland, for Cyprus (e.g. 'Γη3', 'ΚΑ6', 'H2'), France ('A', 'U', 'AU', 'N'), or the US ('A' agricultural district). Includes the specific conditions for a 'farm dwelling' / logement de fonction.

Planning law is local: exact density, min size and build conditions come from the Local Plan / zoning ordinance and title deed. This is a guide that tells you the general logic and exactly what to confirm — never a substitute for the official source.

NameRequiredDescriptionDefault
codeYes
countryNoFrance

TDQS

A3.7/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden. It clearly sets expectations: this is a general guide, not an official source, and it tells the user exactly what to confirm. This is strong transparency about limitations and output nature.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded with the core purpose and uses a second paragraph for an important caveat. It is compact and every sentence adds value, though slightly longer than strictly necessary.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple explainer tool with no output schema and no annotations, the description covers scope, examples, limitations, and what to confirm. It is complete enough for an agent to invoke it correctly and set user expectations.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 0%, so the description must compensate. It explains the 'code' parameter via examples and implies the 'country' parameter by listing jurisdictions. However, it does not explicitly define parameter names or the default country, leaving some burden on the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states a specific verb ('Explain') and resource ('planning-zone code') with concrete examples for multiple countries. It does not explicitly name sibling tools, but its scope is distinct enough that an agent can tell it apart from land search/assessment tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies when to use the tool: when someone needs to understand a zoning code or farm-dwelling conditions. It does not explicitly mention alternatives or when not to use it, though the caveat about not substituting official sources gives some context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

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

  1. 5 tool updatesv0.3.0
    • First observedabout_microfarm
    • First observedassess_land
    • First observedfind_land
    • First observedland_sources
    • First observedzone

TDQS

A3.9/5.0

Scored across 5 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: assessing viability, finding listings, explaining zoning codes, listing data sources, and providing background education. There is no practical overlap that would confuse an agent.

Naming Consistency3/5

The naming is readable and uniform in style with underscores, but it mixes conventions: assess_land and find_land follow verb_noun, while zone, land_sources, and about_microfarm are noun or prepositional style. The inconsistency is noticeable but not chaotic.

Tool Count5/5

Five tools is a well-scoped set for a specialized micro-farm research server. Each tool addresses a distinct part of the domain without redundancy or bloat.

Completeness5/5

The tool set covers the full user journey: learning about micro-farming, seeing available land, assessing a specific parcel, and understanding zoning implications. It also includes transparency about data sources, leaving no obvious dead ends.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    C
    maintenance
    Instant U.S. property intelligence for AI agents. Zoning, Buildability™ Score, ADU eligibility, flood risk, and more from 20+ government sources. Pay-as-you-go: $5 per analysis (prepaid credits). Free Score available at buildability.us. Get a key at buildability.us/api.
    5
    1
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to access free, open agronomic data for field briefings, spray windows, water balance, pest pressure, and more, using only public data sources without API keys.
    1
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Provides free property and parcel intelligence using official US government data APIs, county assessor records, and live listings, with tools for hazard risk checks, affordability calculations, and parcel ranking.
    -