Claude Code

Audience: Developers with a Claude Pro / Max / Team subscription and Python installed.

Claude Code connects directly to the aggeodata MCP server, reads the skills automatically from the .agents/skills/ folder, and executes all code locally in your terminal.

Prerequisites

Requirement	How to get it
Claude Pro / Max / Team plan	claude.ai/upgrade
Claude Code CLI	npm install -g @anthropic/claude-code
Python 3.10+	python.org
aggeodata + ag-cube-cm packages	See Step 2 below

Step 1 — Open a terminal in the skills directory

cd path/to/skills

This folder contains .mcp.json. Claude Code reads it automatically on startup.

Step 2 — Install packages

aggeodata powers the climate / soil download + datacube workflows. ag-cube-cm adds the spatial crop-modeler (DSSAT) layer and is required only if you plan to run yield simulations — install both up front so every skill works out of the box.

pip install "aggeodata[download,mcp] @ git+https://github.com/anaguilarar/aggeodata.git" s3fs zarr
pip install "ag-cube-cm[models] @ git+https://github.com/anaguilarar/ag-cube-cm.git"

One-time setup. Run again only after package updates.

Step 3 — Launch Claude Code

claude

At startup you should see ✓ aggeodata MCP server connected. If not, run /mcp inside Claude Code — it should list aggeodata. Verify .mcp.json exists in the current directory.

Troubleshooting

Symptom	Fix
aggeodata not listed in /mcp	Launch claude from the project root
ModuleNotFoundError: aggeodata or ag_cube_cm	Re-run the pip install in Step 2
Download fails with 422 error	Update aggeodata to the latest version