cropgraph

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)

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.