mcp-server · ranchbot — Claude Code MCP server: features and setup
Connect Claude Code to Ranch.Bot farm records to look up livestock data and make permitted changes. You’ll need a Ranch.Bot account and Node.js 22 or later.
claude mcp add mcp-server -- npx -y @ranchbot/mcp-serverWhat mcp-server does
The server runs locally over stdio and uses your Ranch.Bot account. It works with one farm at a time, letting an agent list farms and animals or retrieve records. Include the relevant farm_id in calls scoped to a farm.
Some operations change farm data. Those writes go straight through the server, without the app’s confirmation screen or Change History. Before a change, the agent should show the farm, resolved targets, exact values and consequences, then get your explicit approval. Permissions depend on both your farm role and granted scopes. Sign in with ranchbot-mcp login; an API key isn’t needed.
What it helps with
- read the animal list for a selected farm
- find an animal by name or identifier
- retrieve records for an animal or group
- make an authorized change after reviewing its values
Example prompts for the agent
- Connect to my farm: call
list_my_farms, then use the selectedfarm_idwithlist_animals. - Find the animal with this identifier and show its records.
- Before changing a record, show the farm, matching targets, exact values and consequences, then ask for my approval.
How to install mcp-server
Platform CLI
claude mcp add mcp-server -- npx -y @ranchbot/mcp-serverPlatform CLI
codex mcp add ranchbot-mcp-server -- npx -y @ranchbot/mcp-serverConfig file
{
"mcpServers": {
"ranchbot-mcp-server": {
"command": "npx",
"args": [
"-y",
"@ranchbot/mcp-server"
]
}
}
}Config file
{
"servers": {
"ranchbot-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ranchbot/mcp-server"
]
}
}
}Platform CLI
gemini mcp add ranchbot-mcp-server npx -y @ranchbot/mcp-serverStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-server
How do I install mcp-server in Claude Code?
Run claude mcp add mcp-server -- npx -y @ranchbot/mcp-server, followed by claude mcp add ranchbot-mcp-server -- npx -y @ranchbot/mcp-server.
What does mcp-server do?
It connects a local MCP client to Ranch.Bot farm data so an agent can read animal and farm records. Certain changes are available when the account’s role and access scopes permit them.
What do I need to sign in to mcp-server?
You need Node.js 22 or later, a Ranch.Bot account and access to a farm. Run ranchbot-mcp login to authorize; no API key is required.
Similar MCP servers
All MCP servers for Agent setup: memory, context, orchestration →mcp-server by other authors comes first.
