io.github.Cropgraph/cropgraph
CropGraph MCP. Crops, companions, pests, rotation, soil, GDD, pest intelligence.
Open source Open in the app JSON README (API)
About
CropGraph MCP. Crops, companions, pests, rotation, soil, GDD, pest intelligence.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- cropgraph
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 3.2.0
- Last push
- 2026-08-06T21:59:43Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 03:01:48
- Updated
- 2026-08-29 03:01:48
- Origin id
io.github.Cropgraph/cropgraph
README
# CropGraph
Commercial agricultural intelligence. Curated data, MCP server, and CLI for
crop calendars, companion planting, crop rotation, succession planting, pest
and disease management, USDA hardiness zones, and climate classification.
- **Website:** https://cropgraph.com
- **API:** https://api.cropgraph.com (see [cropgraph-api](https://github.com/Cropgraph/cropgraph-api))
## Packages
| Package | What |
|---------|------|
| [`@cropgraph/core`](./packages/core) | Crop calendar (5,006 entries across 14 categories), 1,004 companion relationships, rotation families, succession chains, pest/disease associations, 200 beneficial insects across 5 categories with composite pest intelligence, 120 growing degree day models, USDA zones, climate types. Pure TypeScript, offline. |
| [`@cropgraph/mcp`](./packages/mcp) | Model Context Protocol server (stdio). Eighteen garden-planning tools for AI agents. |
| [`cropgraph`](./packages/cli) | Command-line interface. Subcommands for zones, planting, crop lookup, companions, rotation, succession, pests, pest-detail, pest-intel, beneficials. |
## Quick start
### MCP server (Claude Desktop, Cursor, etc.)
```sh
npx @cropgraph/mcp
```
See [`packages/mcp/README.md`](./packages/mcp/README.md) for client config.
### CLI
```sh
npx cropgraph zone --lat 48.118 --lng -123.43
npx cropgraph companions tomato
npx cropgraph planting --zone 8b --climate maritime
npx cropgraph succession lettuce --zone 8b --climate maritime
npx cropgraph pests tomato
npx cropgraph pest-intel tomato-hornworm --plant tomato
npx cropgraph beneficial seven-spotted-ladybug
```
### Library
```sh
npm install @cropgraph/core
```
```ts
import {
getHardinessZone,
getCompanions,
getPlantingPlan,
getSuccessionPlan,
} from "@cropgraph/core";
getHardinessZone(48.118, -123.43); // "8b"
getCompanions("tomato"); // 18 entries
getPlantingPlan({ zone: "8b", climateType: "maritime" });
getSuccessionPlan({ slug: "lettuce-leaf", zone, climateType: "maritime" });
```
## Data
| Asset | Count | Notes |
|-------|-------|-------|
| Crop calendar | 5,006 entries | 14 categories (vegetable, herb, fruit, flower, cover-crop, root, legume, grain, mushroom, native, medicinal, fiber, forage, sprout). Frost-anchored windows; 120 entries carry climate modifiers across 6 climate types |
| Companion relationships | 1,004 | 510 beneficial, 95 antagonist, 12 mechanism categories |
| Growing degree days | 120 models | Cultivar-specific GDD ranges, base temperatures, NOAA Climate Normals harvest prediction |
| Rotation families | 12 | Nightshades, brassicas, cucurbits, alliums, legumes, umbellifers, grasses, amaranthaceae, composites, mints, malvaceae, miscellaneous. Every calendar slug mapped. |
| Succession chains | 33 | Greens, roots, legumes, brassicas, cucurbits, herbs, flowers, cover crops. Frost-anchored phases with per-climate notes. |
| Pest/disease associations | 506 | Crop-to-pest edges with diagnostic symptoms, organic management, prevention, and regions. OMRI-listed management only. |
| Beneficial insects | 200 entries | Predators (62), parasitoids (40), pollinators (50), decomposers (29), microbial controls (22). Prey and attractant cross-references; composite "now what?" intelligence layer with hand-authored notes for the top 40 pest slugs. |
| USDA hardiness zones | 40,283 ZIPs | PRISM 2023 + waldoj/frostline centroids, offline lookup |
| Climate classifier | 6 types | Maritime, mediterranean, continental, humid subtropical, arid, semi-arid |
Sources cited per-entry in the JSON fixtures under
[`packages/core/src/data`](./packages/core/src/data).
## License
MIT. Copyright (c) 2026 Andrew Christison.