## Farm Mapping MCP
Thank you for agreeing to test this MCP tool. You're the first to use it outside of More than Amchines so anything could happen! The software if pretty stable but as this is a beta test the usual caveats about using it for anything important still stand and More than machines is not responsible for any loss that you might occur etc. **You're using this at your own risk.**

Farm Map is a local MCP extension for creating and editing simple farm/property maps in Claude Desktop and ChatGPT although for the beta we're focusing on Claude. It lets you draw one or more property boundaries, split them into paddocks or blocks, add gates/buildings/lines/points, calculate mapped areas, and export the map as GeoJSON or a shareable HTML map.

## Install

1. Download the `.mcpb` file that matches your computer:
   - macOS Apple Silicon: `farm-map-darwin-arm64.mcpb`
   - macOS Intel: `farm-map-darwin-amd64.mcpb`
   - Windows: `farm-map-windows-amd64.mcpb`

2. Open Claude Desktop.

3. Install the `.mcpb` extension through Claude Desktop’s extension/settings area.

4. Restart Claude Desktop.

5. Start a new chat and check that **Farm Map** appears in the available tools/connectors.

## Basic Use

You can ask Claude things like:

```text
Create a farm map for 11 Belrose Place, Empire Bay NSW.
```

```text
Open my farm map editor.
```

```text
Look up the cadastral boundary for this property and add it to the map.
```

```text
Export this map as GeoJSON.
```

```text
Calculate the paddock areas.
```

When the editor opens, use the map tools to:

- draw or import a property boundary;
- split a boundary or paddock into paddocks;
- cut out a paddock shape;
- add buildings, gates, troughs, fences, tracks, or other infrastructure;
- rename features in the **Map Features** panel;
- select a feature to view or edit its details.

## Suggested Workflow

1. **Create or open a map**
   Ask Claude to create a map for a property, location, or farm name.

2. **Add the boundary**
   Draw the property boundary manually, or ask Claude to look up a cadastral/lot boundary where supported.

3. **Split into paddocks**
   Use **Split area** for a simple straight split. Click two points on the edge of a boundary or paddock to create the split.

4. **Use Cut paddock for complex shapes**
   If the split is not a straight line, use **Cut paddock** and draw the shape to carve out.

5. **Add infrastructure**
   Use the point/line/building tools to add gates, troughs, sheds, tracks, fences, pipes, or similar features.

6. **Export or calculate**
   Ask Claude to calculate areas, export GeoJSON, or create a shareable HTML map.

## Map Features Panel

The bottom panel shows the map as a hierarchy:

- property boundary;
- paddocks or blocks inside that boundary;
- point infrastructure, such as gates, nested under the area it sits in where possible.

This helps show relationships such as:

```text
Property boundary
  Paddock 1
    Gate
  Paddock 2
```

## Data and Privacy

Farm Map stores map data locally on your computer by default.

Map tiles, satellite imagery, geocoding, and cadastral lookups may contact external services such as OpenStreetMap, Esri, NSW Spatial Services, or the configured geocoding/cadastre provider.

## Current Beta Limitations

This is beta software. Please check important boundaries and areas before relying on them.

Known limitations:

- point features such as gates can be associated with the paddock/boundary they sit inside, but lines/buildings are not yet fully containment-aware;
- split works best for simple straight edge-to-edge splits;
- complex shapes, concave areas, or awkward geometry may need **Cut paddock** instead;
- there is no undo/redo yet;
- mobile/narrow layouts are usable but not the main target;
- the editor is intended for practical farm mapping, not survey-grade legal boundary work.

## Troubleshooting

If the map editor does not appear:

1. Restart Claude Desktop.
2. Start a new chat.
3. Confirm the Farm Map extension is installed and enabled.
4. If you previously installed an older version, uninstall it first, then install the new `.mcpb`.

If the map opens but a tool fails, try reopening the editor or asking Claude:

```text
Open the active farm map again.
```

If an edit produces the wrong shape, delete the feature and redraw it. Backups are created before destructive map changes.
```