Skip to main content
Glama

Microfarm MCP

예비 소규모 농부를 위한 토지 생존 가능성 인텔리전스 — Claude, Cursor 또는 MCP를 지원하는 모든 AI에 연결하여 특정 토지에 대해 중요한 두 가지 질문에 답하는 무료 오픈소스 MCP 서버:

  1. 이 땅이 실제로 식량 재배에 적합한가?

  2. 이곳에 주택을 합법적으로 지을 수 있는가?

…그리고 그 점수를 매기기 위해 판매 중인 실제 토지를 찾아냅니다.

투기꾼이 아닌 관리자를 위한 도구.

License: MIT Python 3.10+ CI tests


왜 존재하는가

모든 사람이 땅을 소유해야 한다 — 그것이 당신을 부자로 만들기 때문이다. 돈도, 좋은 차도 아닌 — 경작하고, 키우고, 풍요롭게 할 수 있는 땅; 당신과 가족, 이웃, 공동체를 위한 땅; 동물을 먹이고 생명을 유지하는 땅.

— 이 프로젝트가 존재하는 이유

부동산 시장이 토지로 하는 일의 대부분은 투기입니다. 이 도구는 소유하고, 살고, 돌보기 위한 땅을 원하는 사람들을 위한 것입니다 — 물, 표토, 작업 가능한 계절, 그리고 실제로 그 위에 지을 수 있는지에 대한 정직한 답변. 추측하지 않습니다: 모든 신호는 명명된 공개 소스에서 나오며, 알 수 없는 것은 절대 발명하지 않고 표시합니다.

미국, 프랑스, 키프로스에서 작동 — 그리고 Open-Meteo + OSM에 데이터가 있는 모든 곳에서 토지를 점수화합니다. 국가별로 정확히 제공되는 것이 다르므로, 정직한 그림은 다음과 같습니다:

Related MCP server: Plantos MCP Server

국가별 지원 범위

국가

토지 점수화 (assess_land)

판매용 토지 찾기 (find_land)

홍수 / 주거 확인

미국

✅ 전체 기후 + 물 + 농지 + 토지 유형

✅ farms.com + Craigslist (실시간)

✅ FEMA 홍수 구역

키프로스

✅ 전체

✅ index.cy (실시간; 그리스어/영어 제목)

⚠️ 홍수 데이터 없음 — "계획 당국에 확인" 표시

프랑스

✅ 전체

🔜 브라우저 잠금 (leboncoin.fr, offer.com.cy) — 아직 스크래핑 안 됨

⚠️ 홍수 데이터 없음 — "mairie/DDT에 확인" 표시

그 외 모든 곳 (Open-Meteo + OSM에 데이터가 있는 곳)

✅ 기후, 물, 농지, 토지 유형, 접근성

❌ 연결된 목록 소스 없음

⚠️ 홍수 데이터 없음

판정 범례: ✅ = 지금 작동 · ⚠️ = 작동하지만, 정직한 "현지 확인" 메모 포함 · 🔜 = 등록되었지만 브라우저 필요 (참조 land_sources.browser_only)

전 세계 vs 국가별 특화:

  • 전역 (거의 모든 곳에서 작동): 기후 (강수량, 재배 기간, 내한성), 수자원, 농지, 토지 유형, 도로/접근성 — 이것이 assess_land가 점수를 매기는 것이며, 전 세계적으로 사용되는 Open-Meteo + OpenStreetMap을 사용합니다.

  • 국가별: find_land 목록은 국가별 사이트에서 제공됩니다; 홍수 구역은 FEMA에서 제공되며, 미국 전용 — 따라서 주택-홍수 확인은 실제로 미국에만 적용되며, 다른 곳에서는 추측하지 않고 "현지 계획 당국에 확인하세요"라고 정직하게 말합니다.

도구

도구

기능

assess_land

소규모 농장 생존 가능성 및 주택 가능성을 위한 토지 점수 — 강수량, 성장 기간, 물 접근성, 농지 맥락, 토지 유형, 수목 피복, 이웃/프라이버시, 토양 (비옥도, pH, 질감 → 지하수 재충전), 접근성, 홍수 구역. 증거 기반의 유망 / 추가 확인 필요 / 불일치 가능성 판정을 반환합니다.

find_land

무료 소스에서 가격, 크기, 사진, 설명, 위치와 함께 판매 중인 실제 토지를 찾습니다 — country/state 필터 포함.

zone

계획 구역 코드와 농지에 주택이 허용되는지 여부를 설명 — 프랑스 (A/U/AU/N + STECAL/확장 규칙, "logement de fonction" 조건), 키프로스 (Γη3/ΚΑ6/H2), 미국 (농업 지구).

land_sources

사용된 무료 공개 데이터 소스 + 라이선스 목록 (투명성 및 출처 표시).

about_microfarm

토지에서 무엇을 찾아야 하는지에 대한 평이한 언어 설명.

모든 것은 증거 기반: 각 신호는 출처를 명시하며, 누락된 데이터는 누락으로 보고됩니다 — "좋음"으로 취급하지 않습니다.

빠른 시작

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)

Claude / Cursor / OpenCode / Gemini / 모든 MCP 클라이언트에 연결

Microfarm은 표준 MCP 서버이므로 MCP를 지원하는 모든 도구가 사용할 수 있습니다. 정확한 설정은 클라이언트에 따라 다릅니다:

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 (저장소) 또는 ~/.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 (내장 Copilot MCP / 확장) — .vscode/mcp.json:

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

ChatGPT에 대한 참고. ChatGPT는 MCP를 원격 HTTPS 서버로만 지원하며, 이 기능은 현재 Business/Enterprise 요금제로 제한됩니다. 로컬 stdio 서버 (이 저장소가 기본으로 실행하는 것)는 ChatGPT에 직접 연결할 수 없습니다. ChatGPT에서 사용하려면 서버를 원격으로 호스팅하고 ChatGPT에 HTTPS URL을 제공해야 합니다 — 설정 변경이 아닌 실제 단계입니다. 로컬 사용에는 Claude, Cursor, OpenCode 또는 Gemini CLI가 간단한 경로입니다.

그런 다음 어시스턴트에게 물어보세요:

"도르도뉴의 이 땅이 소규모 농장에 적합한지, 그리고 그 위에 집을 지을 수 있는지 알려줘?"

"파포스 지구에서 15만 유로 미만의 토지를 찾아주고, 방문할 가치가 있는 곳을 알려줘."

결과가 어떻게 보이는지

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

데이터 소스 및 출처 표시

이들은 모든 답변 뒤에 있는 무료, 키 없는 공개 소스입니다. 이 프로젝트나 그 데이터를 자신의 작업에 사용할 때 아래 소스를 출처로 표시해 주세요 — 여러 소스는 라이선스에 따라 출처 표시가 필요합니다.

소스

제공 내용

라이선스 / 출처 표시

Open-Meteo Geocoding

지명 → 위도/경도, 고도

CC BY 4.0

Open-Meteo Historical Climate

강수량, 온도, 성장 일수

CC BY 4.0

Open-Meteo Elevation

표면 고도

CC BY 4.0

ISRIC SoilGrids

표토: 유기 탄소, pH, 점토/모래/실트 질감, CEC

CC BY 4.0

OpenStreetMap via Overpass API

수자원, 건물, 도로, 농지, 나무

ODbL

FEMA National Flood Hazard Layer

특정 지점의 홍수 구역 (미국 전용)

미국 연방, 공개 도메인 (데이터), FEMA의 ArcGIS 서비스

farms.com

미국 농장/토지 목록 (find_land)

사이트 콘텐츠는 그들의 것; 우리는 목록에 링크

Craigslist

미국 소유자 직거래 토지 목록 (find_land)

사이트 콘텐츠는 그들의 것; 우리는 목록에 링크

index.cy

키프로스 필지/토지 목록 (find_land)

사이트 콘텐츠는 그들의 것; 우리는 목록에 링크

Open-Meteo는 국가 기상 서비스를 집계합니다; API는 CC BY 4.0 라이선스이며, 우리는 감사히 사용합니다. OpenStreetMap 데이터는 Open Database License에 따라 © OpenStreetMap 기여자 소유입니다. 목록 콘텐츠는 각 마켓플레이스에 속합니다 — 우리는 그들의 페이지로 표시하고 링크하며, 그들의 이미지를 다시 호스팅하지 않습니다.

토지 유형, 구역 및 "여기에 주택을 지을 수 있나?" 질문

  • 토지 유형 (농지 / 목초지 / 숲 / 관목 / 기존 건축 / 수변) 및 나무 피복은 OpenStreetMap에서 감지되어 모든 평가에서 보고됩니다.

  • 공식 구역 — 토지에 법적으로 지을 수 있는 것 — 은 무료 국가 데이터에서 제공되지 않습니다. 지역 계획 당국 (미국 카운티, 키프로스 계획 당국, 프랑스 mairie/DDT)이 설정하며, 무료로 기계적으로 조회할 수 없는 소유권 증서 / 지적 / PLU 문서에 기록됩니다. zone 도구는 코드 (프랑스 A/U/N, 키프로스 Γη/ΚΑ, 미국 농업 지구)와 일반적인 건축 규칙 — 농가 주택 / logement de fonction의 특정 조건 포함 — 을 설명하고, 지역 당국에 확인해야 할 정확한 사항을 알려줍니다. 안내서이며, 공식 기록을 대체하지 않습니다.

정직한 한계

  • 용도지역 / 주거법은 지역별로 다릅니다. 이 도구는 공개 데이터(홍수 + 농지 맥락)를 기반으로 한 1차 스크리닝이며, 공식 조례를 대체하지 않습니다. 항상 직접 방문하여 지역 담당 공무원과 확인하세요.

  • 홍수 데이터는 미국 전용입니다 (FEMA). 미국 외 지역에서는 정직하게 "이용 불가"로 보고되며, 절대 "위험 없음"으로 잘못 표시하지 않습니다.

  • 일부 매물 사이트는 브라우저 전용입니다 (landbanksearch, govdeals, farmflip, Bazaraki, land.cy, offer.com.cy, leboncoin.fr). 등록은 되어 있지만 아직 스크래핑되지 않았으며, land_sources는 접근 가능한 범위와 브라우저 전용 범위의 경계를 보여줍니다.

  • 지역 이름 예: "Limousin"(2016년 폐지)은 지오코딩되지 않을 수 있습니다 — 현재의 도시나 구를 사용하세요.

  • 그리스 매물 제목은 기본적인 단어 수준 번역이 제공되며, 잘 알려지지 않은 지명은 그리스어로 남을 수 있습니다.

개발

.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는 Python 3.10 / 3.11 / 3.12에서 린트, 포맷, 타입 체크, 테스트, 패키지 빌드를 실행합니다.

프로젝트 구조

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

라이선스 및 면책 조항

MIT 라이선스 — 자유롭게 사용, 수정, 공유할 수 있습니다.

이것은 재정, 법률 또는 부동산 조언이 아닙니다. 의존하기 전에 항상 직접 방문하여 지역 계획 당국과 함께 부동산을 확인하세요. 데이터는 위의 무료 공개 소스에서 제공되며, 불완전하거나 미흡할 수 있습니다.

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.
    -