Foodblock MCP server

FoodBlock

An MIT-licensed, content-addressed protocol for the food economy.

FoodBlock is the data primitive: type, state, refs plus six base types (actor, place, substance, transform, transfer, observe). It powers FoodX, an autonomous food network that people, robots, and machines use to know, act, exchange, and own.

One axiom. Three fields. Six base types. Every food industry operation.

{
  "type": "substance.product",
  "state": { "name": "Sourdough", "price": 4.50, "allergens": { "gluten": true } },
  "refs": { "seller": "a1b2c3...", "inputs": ["flour_hash", "water_hash", "yeast_hash"] }
}

id = SHA-256(canonical(type + state + refs))

Why

The food industry spans 14 sectors – farming, processing, distribution, retail, hospitality, regulation, sustainability, and more. Every sector models food data differently. There is no shared primitive.

FoodBlock is that primitive. One data structure that can represent a farm harvest, a restaurant menu item, a food safety certification, a cold chain reading, a grocery order, or a consumer review. Same three fields. Same hashing. Same protocol.

For AI Agents

FoodBlock is designed for human–machine collaboration. Full protocol documentation and AI integration resources:

• Protocol overview: https://foodx.network/protocol
• LLM quick reference: https://foodx.network/llms.txt
• Complete documentation: https://foodx.network/llms-full.txt
• Whitepaper (text): https://foodx.network/foodblock.md
• Technical spec (text): https://foodx.network/foodblock-technical-spec.md
• MCP server: mcp/ – 17 tools for Claude, Cursor, Windsurf, Gemini CLI, and any MCP-compatible agent
• OpenAI integration: openai/tools.json + openai/openapi.yaml – function calling and ChatGPT Custom GPTs
• Gemini integration: gemini/tools.json – function declarations for Gemini API, AI Studio, Vertex AI
• API base: https://api.foodx.world
• About FoodX: https://foodx.network

The Primitive

Every FoodBlock has exactly three fields:

Identity is derived from content: SHA-256(canonical(type + state + refs)). Same content always produces the same hash, regardless of where or when the block is created.

Six Base Types

Entities — things that exist:

• actor — farmer, restaurant, retailer, regulator, consumer, device
• place — farm, factory, store, warehouse, kitchen, vehicle
• substance — ingredient, product, meal, surplus, commodity

Actions — things that happen:

• transform — cooking, milling, harvesting, fermenting, composting
• transfer — sale, shipment, donation, booking, subscription
• observe — review, certification, inspection, post, sensor reading

Subtypes via dot notation: actor.producer, substance.product, observe.review, transfer.order.

Install

npm install foodblock

Quick Start — fb()

The fastest way to use FoodBlock. Describe food in plain English, get structured blocks back.

const { fb } = require('foodblock')

fb("Sourdough bread, $4.50, organic, contains gluten")
// => { type: 'substance.product', state: { name: 'Sourdough bread', price: { value: 4.5, unit: 'USD' }, organic: true, allergens: { gluten: true } }, blocks: [...] }

fb("Amazing pizza at Luigi's, 5 stars")
// => { type: 'observe.review', state: { name: "Luigi's", rating: 5, text: "..." }, blocks: [...] }

fb("Green Acres Farm, 200 acres, organic wheat in Oregon")
// => { type: 'actor.producer', state: { name: 'Green Acres Farm', acreage: 200, crop: 'organic wheat', region: 'Oregon' }, blocks: [...] }

Shortened. The full README is on GitHub.