{"_id":"@ansvar/uk-farm-planning-mcp","_rev":"2-c2f511c1fe5e21a0413d4ad312abc313","name":"@ansvar/uk-farm-planning-mcp","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@ansvar/uk-farm-planning-mcp","version":"0.1.0","keywords":["mcp","farm-planning","rotation","tax","tenancy","diversification","farming"],"author":{"name":"Ansvar Systems","email":"info@ansvar.eu"},"license":"Apache-2.0","_id":"@ansvar/uk-farm-planning-mcp@0.1.0","maintainers":[{"name":"ansvar","email":"jeffrey.von.rotz@ansvar.eu"}],"homepage":"https://ansvar.eu/open-agriculture","bugs":{"url":"https://github.com/Ansvar-Systems/uk-farm-planning-mcp/issues"},"bin":{"uk-farm-planning-mcp":"dist/server.js"},"dist":{"shasum":"7717217ace9330a0e0c0cf22f97e9934d3b35a41","tarball":"https://registry.npmjs.org/@ansvar/uk-farm-planning-mcp/-/uk-farm-planning-mcp-0.1.0.tgz","fileCount":120,"integrity":"sha512-FCJRgTnqFaVqpK/zJ1qv4Fxbg49PJ9tCl75g7S2MQ57pYDrxD3kjQkik0sHljF5jvcJM4YNvl28qIuSZSjo0Nw==","signatures":[{"sig":"MEUCIQD2Gw65e8qZNyJ0Gv+4qf3fcTZUL+R3TUKc7Ud1wxhr3wIgBw015PKgFlGX/YF9tyh4X97gk34Oh1hc99aRRIOmfo4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":422979},"main":"dist/server.js","type":"module","types":"./dist/server.d.ts","engines":{"node":">=20"},"gitHead":"1690b21c7f59fe12ba9bd45cce89ec0b50fb4b56","scripts":{"dev":"tsx watch src/server.ts","lint":"eslint src/ tests/","test":"vitest run","build":"tsc","start":"node dist/server.js","ingest":"tsx scripts/ingest.ts","build:db":"tsx scripts/build-db.ts","typecheck":"tsc --noEmit","start:http":"node dist/http-server.js","test:watch":"vitest","ingest:fetch":"tsx scripts/ingest.ts --fetch-only","coverage:update":"tsx scripts/update-coverage.ts","freshness:check":"tsx scripts/check-freshness.ts"},"_npmUser":{"name":"ansvar","email":"jeffrey.von.rotz@ansvar.eu"},"repository":{"url":"git+https://github.com/Ansvar-Systems/uk-farm-planning-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"UK farm planning via MCP — crop rotation, gross margins, tax rules, APR, tenancy law, diversification","directories":{},"_nodeVersion":"20.20.2","dependencies":{"zod":"^3.23.0","better-sqlite3":"^11.0.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","eslint":"^9.0.0","vitest":"^2.0.0","typescript":"^5.5.0","@types/node":"^20.0.0","@types/better-sqlite3":"^7.6.0","@typescript-eslint/parser":"^8.0.0","@typescript-eslint/eslint-plugin":"^8.0.0"},"_npmOperationalInternal":{"tmp":"tmp/uk-farm-planning-mcp_0.1.0_1775242357404_0.07639612408867746","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Ansvar MCP servers are now distributed as source from github.com/Ansvar-Systems/uk-farm-planning-mcp under Apache 2.0. Self-hosting instructions: see the repo README. Hosted gateway: ansvar.eu"}},"time":{"created":"2026-04-03T18:52:37.322Z","modified":"2026-05-02T05:49:33.027Z","0.1.0":"2026-04-03T18:52:37.580Z"},"bugs":{"url":"https://github.com/Ansvar-Systems/uk-farm-planning-mcp/issues"},"author":{"name":"Ansvar Systems","email":"info@ansvar.eu"},"license":"Apache-2.0","homepage":"https://ansvar.eu/open-agriculture","keywords":["mcp","farm-planning","rotation","tax","tenancy","diversification","farming"],"repository":{"url":"git+https://github.com/Ansvar-Systems/uk-farm-planning-mcp.git","type":"git"},"description":"UK farm planning via MCP — crop rotation, gross margins, tax rules, APR, tenancy law, diversification","maintainers":[{"name":"ansvar","email":"jeffrey.von.rotz@ansvar.eu"}],"readme":"# UK Farm Planning MCP\n\n[![CI](https://github.com/Ansvar-Systems/uk-farm-planning-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Ansvar-Systems/uk-farm-planning-mcp/actions/workflows/ci.yml)\n[![GHCR](https://github.com/Ansvar-Systems/uk-farm-planning-mcp/actions/workflows/ghcr-build.yml/badge.svg)](https://github.com/Ansvar-Systems/uk-farm-planning-mcp/actions/workflows/ghcr-build.yml)\n[![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n\nUK farm business planning data via the [Model Context Protocol](https://modelcontextprotocol.io). 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.\n\nPart of [Ansvar Open Agriculture](https://ansvar.eu/open-agriculture).\n\n## Why This Exists\n\nUK 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.\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"uk-farm-planning\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ansvar/uk-farm-planning-mcp\"]\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add uk-farm-planning npx @ansvar/uk-farm-planning-mcp\n```\n\n### Streamable HTTP (remote)\n\n```\nhttps://mcp.ansvar.eu/uk-farm-planning/mcp\n```\n\n### Docker (self-hosted)\n\n```bash\ndocker run -p 3000:3000 ghcr.io/ansvar-systems/uk-farm-planning-mcp:latest\n```\n\n### npm (stdio)\n\n```bash\nnpx @ansvar/uk-farm-planning-mcp\n```\n\n## Example Queries\n\nAsk your AI assistant:\n\n- \"What should I grow after oilseed rape?\"\n- \"What's the gross margin for winter wheat this year?\"\n- \"Explain the APR rules for a farmhouse\"\n- \"Compare AHA 1986 succession rights vs ATA 1995\"\n- \"Can I convert my barn to dwellings under permitted development?\"\n- \"What are the Making Tax Digital deadlines for farmers?\"\n- \"Is my dairy enterprise profitable at benchmark costs?\"\n\n## Stats\n\n| Metric | Value |\n|--------|-------|\n| Tools | 11 (3 meta + 8 domain) |\n| Jurisdiction | GB |\n| Data sources | AHDB Farmbench, HMRC, AHA 1986, ATA 1995, GPDO 2015 |\n| License (data) | Open Government Licence v3 / Crown Copyright |\n| License (code) | Apache-2.0 |\n| Transport | stdio + Streamable HTTP |\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `about` | Server metadata and links |\n| `list_sources` | Data sources with freshness info |\n| `check_data_freshness` | Staleness status and refresh command |\n| `search_farm_planning` | FTS5 search across all farm planning data |\n| `get_rotation_guidance` | Crop rotation suitability, disease breaks, blackgrass risk |\n| `get_gross_margins` | Enterprise gross margins with quartile benchmarks |\n| `get_tax_rules` | Agricultural tax rules (MTD, averaging, allowances, VAT) |\n| `get_apr_guidance` | Agricultural Property Relief for IHT (100%/50%, occupation tests) |\n| `get_tenancy_rules` | AHA 1986 vs ATA 1995 tenancy rules |\n| `get_diversification_guidance` | Permitted development (Class Q/R/S), planning requirements |\n| `calculate_break_even` | Break-even analysis using gross margin benchmarks |\n\nSee [TOOLS.md](TOOLS.md) for full parameter documentation.\n\n## Security Scanning\n\nThis repository runs 6 security checks on every push:\n\n- **CodeQL** -- static analysis for JavaScript/TypeScript\n- **Gitleaks** -- secret detection across full history\n- **Dependency review** -- via Dependabot\n- **Container scanning** -- via GHCR build pipeline\n\nSee [SECURITY.md](SECURITY.md) for reporting policy.\n\n## Disclaimer\n\nThis 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](DISCLAIMER.md).\n\n## Contributing\n\nIssues and pull requests welcome. For security vulnerabilities, email security@ansvar.eu (do not open a public issue).\n\n## License\n\nApache-2.0. Data sourced under Open Government Licence v3 and Crown Copyright.\n","readmeFilename":"README.md"}