# John Deere MCP

> John Deere MCP connects your AI agent directly to John Deere Operations Center APIs. Manage everything—from tracking specific equipment and mapping fields to reviewing yield reports and monitoring alerts—all through natural conversation. Stop jumping between apps; get full farm visibility in one chat.

## Overview
- **Category:** iot-hardware
- **Price:** Free
- **Tags:** precision-agriculture, fleet-tracking, farm-management, machine-telemetry, crop-data, field-operations

## Description

This MCP lets you manage complex farm operations without juggling multiple dashboards or digging through dense reports. You connect your AI agent once, and it gains access to all John Deere data, letting you talk about your entire operation using plain English. Instead of logging into the Operations Center app to check on equipment status or field boundaries, you ask your agent directly. It pulls together machine locations, alerts, historical yields, and even lists every farm or co-op you manage. If you're already connected to Vinkius, you can start managing this data immediately from Claude, Cursor, or any other MCP-compatible client. You get real-time updates on your fleet, deep insights into planting and harvest records, and a clear picture of what needs attention across all acres.

## Tools

### list_organizations
Retrieves a list of all associated farms, cooperatives, and organizational profiles.

### list_machines
Lists every piece of equipment in your fleet, including details like make, model, and serial number.

### get_machine_locations
Fetches the current GPS coordinates and telemetry data for specified machines.

### list_fields
Retrieves a list of all agricultural fields or plots, showing boundaries and acreage.

### get_field_operations
Gets records detailing past field work, including the product used, rate applied, yield recorded, and operator name.

### list_alerts
Shows a list of machine alerts, providing severity level, timestamp, and which machine is affected.

### list_clients
Retrieves the contact information for all associated farm clients.

## Prompt Examples

**Prompt:** 
```
Show me all machines in my main farm and their current locations.
```

**Response:** 
```
Your farm 'Sunrise Acres' (org: 384721) has 6 machines:
1. John Deere 8R 410 (SN: 1RW8410RJPD002871) — 2,340 hrs — GPS: 41.284° N, 96.012° W (Field: North Quarter)
2. S790 Combine (SN: 1H0S790SJN0770123) — 890 hrs — Parked at equipment barn
3. R4045 Sprayer (SN: 1N04045XLMD210456) — 1,120 hrs — GPS: 41.291° N, 96.008° W (Field: East 160)
Showing 3 of 6. Want me to check active alerts for any of these?
```

**Prompt:** 
```
What was the corn yield on the North Quarter field this season?
```

**Response:** 
```
Harvest operation for North Quarter (Field ID: F-4821):
• Crop: Corn (Zea mays)
• Harvest date: October 12, 2025
• Yield: 218 bu/acre (area: 156.3 acres)
• Total harvest: 34,073 bushels
• Moisture: 15.2%
• Operator: Mike Johnson
This is 8% above your 5-year average of 202 bu/acre for this field. Want me to compare with your other corn fields?
```

**Prompt:** 
```
Are there any active alerts on my fleet?
```

**Response:** 
```
3 active alerts found:
1. ⚠️ HIGH — 8R 410 Tractor: Engine oil pressure low (triggered 2h ago). Recommend stopping for inspection.
2. 🔔 MEDIUM — R4045 Sprayer: Nozzle calibration overdue (last calibrated 45 days ago)
3. ℹ️ LOW — S790 Combine: Scheduled maintenance at 900 engine hours (currently at 890 hrs)
The tractor alert is urgent. Should I pull the full machine details?
```

## Capabilities

### Get Live Equipment Status
Know exactly where every tractor or sprayer is right now using real-time GPS data.

### Review Farm Boundaries and Plots
List all managed fields, including their acreage and current crop assignment.

### Check Operational History
Pull comprehensive records of past work, like planting rates, yields, or tillage activities for any plot.

### Monitor Machine Health
Review active equipment alerts by severity and identify machines needing immediate maintenance.

### View Organizational Assets
List all farms, cooperatives, and client accounts linked to your operation profile.

## Use Cases

### Checking Fleet Readiness Before Deployment
A coordinator needs to know if the combine, sprayer, and tractor are all ready for harvest. They ask their agent, which uses `list_machines` and then checks machine alerts using `list_alerts`. The agent immediately flags that the sprayer needs a nozzle calibration update before work can start.

### Comparing Yields Across Different Seasons
An agronomist wants to know how this year's corn yield compares to the 5-year average for the East 160 field. They ask their agent, which calls `get_field_operations` and pulls the relevant historical data points automatically.

### Tracking Equipment Movement in Real Time
A farm manager needs to know if a specific tractor has moved from its usual spot. They ask their agent, which uses `get_machine_locations` to provide the precise GPS coordinates and confirms the machine's current operational field.

### Auditing Past Work for Compliance
A manager needs proof of what product was applied where. They ask their agent, which executes `get_field_operations` to pull records including the date, rate, and specific operator details.

## Benefits

- Check live equipment status without logging into the Operations Center. Use the `get_machine_locations` tool to know exactly where your entire fleet is operating right now.
- Build instant season analysis reports. The `get_field_operations` tool gives you product rates, yields, and operator data for any plot, saving manual report generation.
- Keep your assets running smoothly. By listing machine alerts with `list_alerts`, you monitor critical issues by severity across the whole fleet.
- Gain full visibility into organizational structures using `list_organizations` to see all managed farms and co-ops in one place.
- Simplify planning by viewing field boundaries and acreage through `list_fields` before a single seed is planted.

## How It Works

The bottom line is, you talk to your AI client like talking to a human assistant who already has access to every piece of farm machinery data.

1. Subscribe to this MCP and provide the required John Deere credentials (App ID, App Secret, and OAuth Access Token) from developer.deere.com.
2. Connect your preferred AI client—like Claude or Cursor—to Vinkius for access. This links your agent to the operational data streams.
3. Ask your agent a question: 'What were the yields on the North Quarter field last season?' The MCP executes the necessary calls and returns the structured answer.

## Frequently Asked Questions

**Can John Deere MCP list all my managed farms?**
Yes. You can use `list_organizations` to get a full profile and list of every farm, co-op, or organization you manage within the system.

**How do I check if my tractors are running right now using John Deere MCP?**
You ask your agent to use `get_machine_locations`. It provides real-time GPS data and telemetry, telling you exactly where each machine is operating.

**Does the John Deere MCP help me with historical yield reports?**
Absolutely. Use `get_field_operations` to pull records for any field. You'll get details on yields, total harvest bushels, and which operator was responsible.

**What kind of alerts can the John Deere MCP monitor?**
The agent monitors machine health using `list_alerts`. It tells you the alert type, severity (High/Medium/Low), timestamp, and precisely which piece of equipment is affected.

**Do I need to know specific field IDs to use John Deere MCP?**
Not necessarily. You can first run `list_fields` to see all available plots. Then you can ask your agent about a plot by name or location.