UK Farm Planning MCP

UK farm business planning data via the Model Context Protocol. Crop rotation guidance, gross margins, agricultural tax rules, APR for inheritance tax, tenancy law (AHA 1986 vs ATA 1995), diversification permitted development, and break-even calculations -- all from your AI assistant.

Part of Ansvar Open Agriculture.

Why This Exists

UK farm businesses need quick access to rotation planning data, gross margin benchmarks, tax rules (Making Tax Digital, farmers averaging, APR), tenancy law comparisons, and diversification planning rules. This information is spread across AHDB publications, HMRC manuals, and legislation. This MCP server makes it all searchable from any AI assistant.

Quick Start

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "uk-farm-planning": {
      "command": "npx",
      "args": ["-y", "@ansvar/uk-farm-planning-mcp"]
    }
  }
}

Claude Code

claude mcp add uk-farm-planning npx @ansvar/uk-farm-planning-mcp

Streamable HTTP (remote)

https://mcp.ansvar.eu/uk-farm-planning/mcp

Docker (self-hosted)

docker run -p 3000:3000 ghcr.io/ansvar-systems/uk-farm-planning-mcp:latest

npm (stdio)

npx @ansvar/uk-farm-planning-mcp

Example Queries

Ask your AI assistant:

• "What should I grow after oilseed rape?"
• "What's the gross margin for winter wheat this year?"
• "Explain the APR rules for a farmhouse"
• "Compare AHA 1986 succession rights vs ATA 1995"
• "Can I convert my barn to dwellings under permitted development?"
• "What are the Making Tax Digital deadlines for farmers?"
• "Is my dairy enterprise profitable at benchmark costs?"

Stats

| Metric | Value | |--------|-------| | Tools | 11 (3 meta + 8 domain) | | Jurisdiction | GB | | Data sources | AHDB Farmbench, HMRC, AHA 1986, ATA 1995, GPDO 2015 | | License (data) | Open Government Licence v3 / Crown Copyright | | License (code) | Apache-2.0 | | Transport | stdio + Streamable HTTP |

Tools

| Tool | Description | |------|-------------| | about | Server metadata and links | | list_sources | Data sources with freshness info | | check_data_freshness | Staleness status and refresh command | | search_farm_planning | FTS5 search across all farm planning data | | get_rotation_guidance | Crop rotation suitability, disease breaks, blackgrass risk | | get_gross_margins | Enterprise gross margins with quartile benchmarks | | get_tax_rules | Agricultural tax rules (MTD, averaging, allowances, VAT) | | get_apr_guidance | Agricultural Property Relief for IHT (100%/50%, occupation tests) | | get_tenancy_rules | AHA 1986 vs ATA 1995 tenancy rules | | get_diversification_guidance | Permitted development (Class Q/R/S), planning requirements | | calculate_break_even | Break-even analysis using gross margin benchmarks |

See TOOLS.md for full parameter documentation.

Security Scanning

This repository runs 6 security checks on every push:

• CodeQL -- static analysis for JavaScript/TypeScript
• Gitleaks -- secret detection across full history
• Dependency review -- via Dependabot
• Container scanning -- via GHCR build pipeline

See SECURITY.md for reporting policy.

Disclaimer

This tool provides reference data for informational purposes only. It is not professional agricultural, tax, or legal advice. Tax rules change frequently -- always verify with HMRC or a qualified agricultural accountant. Tenancy disputes should involve a specialist agricultural solicitor. See DISCLAIMER.md.

Contributing

Issues and pull requests welcome. For security vulnerabilities, email [email protected] (do not open a public issue).

License

Apache-2.0. Data sourced under Open Government Licence v3 and Crown Copyright.