Skip to main content
The Bhumi MCP server lets AI assistants like Claude query farm data, search by location, and browse products through natural conversation — no REST calls required from you. The server is hosted at mcp.bhumifarms.co. There is nothing to install or run locally.

​
Prerequisites

  • A Bhumi API key. See Authentication if you don’t have one yet.
  • An MCP-compatible AI client (Claude Desktop or Claude Code).

​
Configure your AI client

1

Get your API key

Sign in at console.bhumifarms.co and copy your bh_live_... key.
2

Add Bhumi to your client config

The configuration format is the same for both Claude Desktop and Claude Code. Replace bh_live_your_api_key_here with your actual key.
Open the Claude Desktop config file for your operating system:
  • macOS: ~/.config/claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Add a bhumi entry under mcpServers:
{
  "mcpServers": {
    "bhumi": {
      "url": "https://mcp.bhumifarms.co/mcp",
      "headers": {
        "X-API-Key": "bh_live_your_api_key_here"
      }
    }
  }
}
Save the file, then restart Claude Desktop for the change to take effect.
3

Verify the connection

After restarting your client, try one of these prompts to confirm the integration is working:
  • “How many farms does Bhumi have?”
  • “Find farms near Portland, Oregon that sell raw milk”
  • “What products are available in Wyoming?”
If the MCP server is connected, Claude will call the appropriate Bhumi tool and return live data.

​
Endpoints

The Bhumi MCP server exposes two transport endpoints:
EndpointTransportNotes
https://mcp.bhumifarms.co/mcpStreamableHTTPRecommended for modern MCP clients
https://mcp.bhumifarms.co/sseServer-Sent EventsFallback for older clients
Both endpoints require an X-API-Key header with your Bhumi API key.

​
Authentication

All requests to the MCP server are authenticated with your Bhumi API key passed via the X-API-Key header in the config above. Your daily rate limit and usage are tracked per key, the same as direct REST API calls.
Do not share your API key. If it is exposed, revoke it immediately from the Developer Console and create a new one.

​
Available tools

The hosted server exposes the following public read-only tools:
ToolDescription
search_farmsSearch farms by location, products, certifications, or text query
get_farmGet a detailed farm profile by ID
list_productsList all product types available on the platform, optionally filtered by state
get_statsGet live platform statistics (total farms, states covered, top products)
find_foodProduct-first search — find farms near you that carry a specific item
get_farm_productsList all products for a specific farm, with pricing and stock info
check_availabilityCheck whether a specific product is in stock at a specific farm
nearby_categoriesDiscover what food is available near a location
compare_product_pricesCompare prices for a product across farms in an area
get_area_deliveryGet delivery and pickup statistics for farms in a geographic area
find_farm_differentiatorsAnalyze what makes a farm unique compared to nearby farms
get_nearby_competitorsFind farms selling overlapping products with a given farm
get_farm_hoursGet a farm’s operating hours and current open/closed status
The server also exposes two MCP resources:
Resource URIDescription
bhumi://statsLive platform statistics
bhumi://farm/{id}Full farm profile by ID

​
Troubleshooting

Claude says it doesn’t have access to Bhumi tools Confirm that you restarted the client after editing the config file. Check that the JSON is valid (no trailing commas, correct bracket nesting). Requests fail with 401 Verify your API key is correct and active. You can check your keys in the Developer Console. Requests fail with 429 You have exceeded your daily request limit. Limits reset at midnight UTC. See Pricing for plan details.