@cropgraph/mcp

@cropgraph/mcp

Model Context Protocol server for garden planning. Eighteen tools backed by the curated CropGraph datasets (5,006 crops across 14 categories, 1,004 companion relationships, 12 rotation families, 102 succession planting chains, 506 pest/disease associations, 200 beneficial insects with composite pest intelligence, 120 growing degree day models, USDA hardiness zones, climate types). Runs over stdio. No API key, no network.

Install / run

npx @cropgraph/mcp

The server reads MCP JSON-RPC over stdio and exits on EOF.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Restart Claude Desktop. The eighteen tools will appear in the connector list.

Cursor

Add to ~/.cursor/mcp.json:

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

Tools

Tool	What it does
get_hardiness_zone	USDA hardiness zone + frost dates from lat/lng or ZIP.
get_planting_plan	What to plant in a date window for a given zone (climate-aware).
get_crop_details	Full crop calendar entry by slug, common name, or scientific name.
search_plants	Search the 5,006-crop calendar with optional zone/category filters across 14 categories.
get_crops_for_zone	All crops whose zone range includes the supplied USDA zone.
get_companions	Companion and antagonist plants for a crop with mechanisms, evidence strength, citations.
check_companion_pair	Look up a single beneficial/antagonist relationship between two crops.
plan_bed_compatibility	Evaluate 2-20 crops together: pairwise relationships + hub-antagonist warnings.
get_rotation_advice	Rotation family + year-gap rule for a crop, with recommended follow-with and never-follow crops.
check_rotation_sequence	Validate a multi-year sequence: flags rotation-gap violations and never-follow warnings.
get_succession_chain	Succession planting chain for a crop: phases with sow method, cadence, and frost-relative window.
get_succession_plan	Same chain resolved to concrete ISO dates for a zone (climate-aware, with per-phase sowing date lists).
get_crop_pests	Pests and diseases for a crop, sorted by severity, with diagnostic symptoms, organic management, prevention, regions, and citations.
get_pest_detail	Full record for one pest or disease across every crop it touches.
get_pest_intelligence	Composite "now what?" report after a pest is identified: severity verdict, immediate action, companion deterrents, beneficial predators with wait-before-spraying guidance, friend-or-foe lookalikes, crop-specific symptoms when plant is supplied.
get_beneficial_insect	Full detail for one beneficial insect or microbial control: identification, garden role, habitat needs, attractor plants, crops protected via prey relationships.
list_beneficials	Browse the 200-entry beneficial insects catalog or filter by category (predator, parasitoid, pollinator, decomposer, microbial-control).
get_verdict	Friend-or-foe classifier for any insect slug. Returns friend, foe, nuisance, cosmetic, or neutral.

All tools are read-only and offline. Schemas describe each input field in detail so an LLM can call them without external docs.

Data sources

See @cropgraph/core for the underlying datasets and citations.

License

MIT.