Back to Directory/Developer Tools

io.github.Cropgraph/cropgraph

CropGraph MCP. Crops, companions, pests, rotation, soil, GDD, pest intelligence.

Developer ToolsTypeScriptv3.2.0

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

PackageWhat
@cropgraph/coreCrop 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/mcpModel Context Protocol server (stdio). Eighteen garden-planning tools for AI agents.
cropgraphCommand-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

AssetCountNotes
Crop calendar5,006 entries14 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 relationships1,004510 beneficial, 95 antagonist, 12 mechanism categories
Growing degree days120 modelsCultivar-specific GDD ranges, base temperatures, NOAA Climate Normals harvest prediction
Rotation families12Nightshades, brassicas, cucurbits, alliums, legumes, umbellifers, grasses, amaranthaceae, composites, mints, malvaceae, miscellaneous. Every calendar slug mapped.
Succession chains33Greens, roots, legumes, brassicas, cucurbits, herbs, flowers, cover crops. Frost-anchored phases with per-climate notes.
Pest/disease associations506Crop-to-pest edges with diagnostic symptoms, organic management, prevention, and regions. OMRI-listed management only.
Beneficial insects200 entriesPredators (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 zones40,283 ZIPsPRISM 2023 + waldoj/frostline centroids, offline lookup
Climate classifier6 typesMaritime, 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.

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y @cropgraph/mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-cropgraph-cropgraph": {
      "command": "npx",
      "args": [
        "-y",
        "@cropgraph/mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

@cropgraph/mcpnpm

Compatible MCP Clients

io.github.Cropgraph/cropgraph works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More