Skip to main content
The Bhumi MCP server lets you query 13,700+ local farms directly from an AI assistant using natural language. Ask about farm locations, product availability, pricing, hours, and more — and the AI will call the right tools and surface structured answers from Bhumi’s data.

​
What is the Bhumi MCP server?

The Bhumi MCP server exposes Bhumi’s farm data as Model Context Protocol tools and resources. When you connect it to an AI client (Claude Desktop, Cursor, etc.), the AI can:
  • Search for farms by location, product, or certification
  • Look up farm details, hours, and product listings
  • Discover what food is available near any address
  • Compare prices across multiple farms
  • Analyze what makes a farm unique in its area
You write a natural language prompt. The AI resolves it to one or more MCP tool calls. You get structured, real-time answers from Bhumi’s database.

​
Hosted — no local setup

The Bhumi MCP server is hosted at mcp.bhumifarms.co. You do not need to install anything locally, clone a repo, or manage database credentials. Point your AI client at the endpoint, add your API key, and you are ready to go.

​
Endpoints

EndpointTransportUse
https://mcp.bhumifarms.co/mcpStreamableHTTP (POST)Recommended for all modern MCP clients
https://mcp.bhumifarms.co/sseSSE (GET)Fallback for older MCP clients
https://mcp.bhumifarms.co/healthHTTP (GET)Health check — returns server status and version
Use the StreamableHTTP endpoint (/mcp) unless your MCP client documentation specifically instructs you to use SSE.

​
Authentication

Every request must include a Bhumi API key in the X-API-Key header. You configure this once in your AI client — the client sends it automatically on every tool call. 
X-API-Key: bh_live_your_api_key_here
Get your key from the Bhumi Developer Console. No credit card is required for the free tier. Rate limit headers are returned with every response: 
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 97
Limits reset daily at midnight UTC.

​
Tier limits

Free tier

100 requests/day. Access to 4 read-only tools. No credit card required.

Paid tier

10,000+ requests/day. All 13 public tools. Usage-based billing. Priority support.
The free tier gives access to search_farms, get_farm, list_products, and get_stats. Upgrade to access all tools including find_food, compare_product_prices, nearby_categories, and more.

​
Quick setup

1

Get your API key

Sign up at console.bhumifarms.co to receive a bh_live_... API key. The free tier requires no credit card.
2

Configure your AI client

Add the Bhumi server to your client’s MCP configuration. The exact file location depends on your client.
// ~/.config/claude/claude_desktop_config.json (macOS)
// %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "bhumi": {
      "url": "https://mcp.bhumifarms.co/mcp",
      "headers": {
        "X-API-Key": "bh_live_your_api_key_here"
      }
    }
  }
}
3

Restart and verify

Restart your AI client and try one of these prompts to confirm the connection is working:
  • “How many farms does Bhumi have?”
  • “Find farms near Portland, Oregon that sell raw milk”
  • “What products are available in Wyoming?”

​
What’s next

Tools reference

Full parameter reference and examples for all 13 MCP tools.

MCP resources

Read-only data resources AI assistants can access contextually.