Skip to content
MCP server

MCP Server

Local MCP server for reading and updating cattle and sheep records in a Ranch.Bot account

Runs locallyStatus and history
Pricing
Free trial
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.2.0
Listing updated
2 days ago

About MCP Server

MCP Server is an MCP server for agriculture. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@ranchbot/mcp-server"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@ranchbot/mcp-server"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Free trial

Ranch.Bot account required: Solo US$190/year, Team US$490/year; 30-day trial, card required

Prices change. Check ranch.bot before you buy.

MCP Server 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 to MCP Server

  1. Crop-protection catalogue lookup: products, active ingredients and national approvals

    Not checked yet
    • 4 tools
    • Remote
    • Free
    • Health and science