Skip to content

Cropgraph/cropgraph

Repository files navigation

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.

Packages

Package What
@cropgraph/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 Model Context Protocol server (stdio). Eighteen garden-planning tools for AI agents.
cropgraph 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.)

npx @cropgraph/mcp

See packages/mcp/README.md for client config.

CLI

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

npm install @cropgraph/core
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.

License

MIT. Copyright (c) 2026 Andrew Christison.

About

Agricultural intelligence: 1000-crop planting calendar, companion graph, climate-aware scheduling. Core library, MCP server, CLI.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors