Skip to main content
The Bhumi MCP server gives AI assistants direct access to the Local Food Graph. Run it locally to enable natural language queries about farms, products, and market data.

​
Prerequisites

​
Installation

git clone https://github.com/AdarshDayalan/bhumi.git
cd bhumi/mcp
npm install
npm run build

​
Configuration

Create a .env file in the mcp/ directory: 
SUPABASE_URL=https://rsodgwbcdpihkvilhvgh.supabase.co
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key

​
Claude Desktop setup

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json): 
{
  "mcpServers": {
    "bhumi": {
      "command": "node",
      "args": ["/path/to/bhumi/mcp/dist/index.js"],
      "env": {
        "SUPABASE_URL": "https://rsodgwbcdpihkvilhvgh.supabase.co",
        "SUPABASE_SERVICE_ROLE_KEY": "your_key"
      }
    }
  }
}

​
Claude Code setup

claude mcp add bhumi node /path/to/bhumi/mcp/dist/index.js

​
Available tools

The MCP server exposes 14 tools across three categories:

​
Discovery (free tier)

  • search_farms — Search by location, products, certifications
  • find_food — Product-first search
  • get_farm — Full farm profile
  • get_farm_products — Product listings for a farm
  • get_farm_hours — Operating hours with open/closed status
  • check_availability — Stock check
  • list_products — Product catalog with farm counts
  • get_stats — Platform statistics
  • nearby_categories — Area overview

​
Market intelligence (paid tier)

  • compare_product_prices — Price comparison across farms
  • find_farm_differentiators — What makes a farm unique
  • get_nearby_competitors — Competitor analysis
  • get_area_delivery — Delivery landscape
  • get_market_landscape — Full area market data

​
Management (authenticated)

  • get_my_orders — Farmer’s order list
  • update_order_status — Update order status
  • update_product — Update product details

​
Example conversation

User: "Find me raw milk near Portland, OR"

Claude: I found 8 farms with raw milk within 25 miles of Portland:

1. Headwater Hills (McMinnville, 12.4mi) — raw goat milk
2. Prairieland Creamery (Sherwood, 18.2mi) — raw cow milk, cream
...