# MCP Server

> MCP Server is an MCP server for agriculture. Local MCP server for reading and updating cattle and sheep records in a Ranch.Bot account. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://ranch.bot
- **Repository:** https://github.com/ranchbot/mcp-server
- **MCP Registry name:** bot.ranch/mcp-server
- **Categories:** agriculture
- **Listing updated:** 2026-11-15

## About

Ranch.Bot is a livestock record service where producers text a note, review the drafted record in a web app and save it. This server runs on the producer's own computer over stdio and lets an assistant work with those saved records, one farm at a time. Hosted connections are not public yet, ChatGPT access is a private pilot and the Claude connector is in review.

Sign-in uses a terminal command and browser approval, with no API key. Reads include listing farms and animals, finding animals by name or identifier with exact or partial matching, and listing records by animal, group and date range, with paging that the README says an assistant must follow instead of treating a first page as complete. Editors and Owners can create and update, and deletion needs Owner access. Ordinary writes save directly, without the app's confirmation screen, so the README tells the assistant to state the exact change and get approval first.

It needs Node.js 22 or newer and a Ranch.Bot account with farm access. The service sells yearly plans for one operator or a team, with a 30-day trial.

## Features

- **Farm-scoped access:** Works with one farm at a time and takes a farm ID on scoped calls.
- **Animal lookup:** Finds animals by name or identifier with exact or partial matching.
- **Record history:** Lists records by animal, group and date range with paging.
- **Role-based writes:** Editors and Owners can write; deletion needs Owner access.
- **Browser approval login:** Signs in through a terminal command and explicit browser approval.
- **EID lookup:** Readers can look up an animal by electronic ID.

## Good for

- Summarise the current inventory of a sheep or cattle farm
- Find when a group last moved or was treated
- Add a movement or health record after the producer approves it
- Check which farms an account can reach

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-server -- npx -y @ranchbot/mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@ranchbot/mcp-server"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@ranchbot/mcp-server"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ranchbot/mcp-server"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@ranchbot/mcp-server"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@ranchbot/mcp-server"
      ]
    }
  }
}
```

## Tools

- `list_my_farms`: Lists the farms the account can access.
- `list_animals`: Lists animals, searchable by name or identifier.
- `set_default_farm`: Optionally sets a default farm for scoped calls.
- `list_records`: Lists records by animal, group and date bounds.
- `lookup_animal_by_eid`: Looks up an animal by electronic ID.

## FAQ

### What do I need to run it?

Node.js 22 or newer, a Ranch.Bot account and access to a farm.

### How do I sign in?

Run ranchbot-mcp login, open the printed URL and approve the code; no API key is used.

### Does it work in ChatGPT or Claude directly?

Not publicly yet; ChatGPT is a private pilot and the Claude connector is in review.

### What does Ranch.Bot cost?

Solo is 190 US dollars a year and Team 490 dollars a year, with a 30-day trial that needs a card.

### Which animals are covered?

Cattle and sheep records in this server.

### Is MCP Server free?

MCP Server is a paid product with a free trial.

### How do I add MCP Server to Claude Code?

Run this command in your terminal: claude mcp add mcp-server -- npx -y @ranchbot/mcp-server

## Alternatives

- [Life Scientific product catalogue](https://ai-powered.com/mcp/life-scientific-product-catalogue): Life Scientific product catalogue is a free MCP server for health and science.

---
Source: https://ai-powered.com/mcp/mcp-server-11
