Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

io.github.FoodXDevelopment/foodblock-mcp

NPM · FOODBLOCK-MCP · SCANNED SEP 21

Food data tools for any AI agent. Describe food in English, get structured data back.

Available components

0 this week 85 Trust /100
Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security98
  • No malware found by supply-chain analysis.Pass
  • No known CVEs affecting this package version or its production dependencies.Pass
  • No install/post-install scripts declared.Pass
  • 31 of 97 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency45
Schema Quality & AI Usability80
  • AI-judged instruction clarity (excellent).Pass
  • Tool/resource definitions use about 1486 tokens (~87/item across 17 items; 17 tools + 0 resources), lean.Pass
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
  • No destabilizing schema changes in the last 30 days.Pass
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • We read all 17 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
  • An AI judge read all 17 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Install

How do I install the io.github.FoodXDevelopment/foodblock-mcp server?

io.github.FoodXDevelopment/foodblock-mcp runs locally as an npm package, launched with npx -y foodblock-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

npm · foodblock-mcp

# add to Claude Code
claude mcp add foodxdevelopment-foodblock-mcp -- npx -y foodblock-mcp
// .cursor/mcp.json
{
  "mcpServers": {
    "foodxdevelopment-foodblock-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "foodblock-mcp"
      ]
    }
  }
}
// .vscode/mcp.json
{
  "servers": {
    "foodxdevelopment-foodblock-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "foodblock-mcp"
      ]
    }
  }
}
# add to Codex CLI
codex mcp add foodxdevelopment-foodblock-mcp -- npx -y foodblock-mcp
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "foodxdevelopment-foodblock-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "foodblock-mcp"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add foodxdevelopment-foodblock-mcp --command npx --arg -y --arg foodblock-mcp
# ~/.hermes/config.yaml
mcp_servers:
  foodxdevelopment-foodblock-mcp:
    command: "npx"
    args: ["-y", "foodblock-mcp"]
// ~/.netclaw/config/netclaw.json
{
  "McpServers": {
    "foodxdevelopment-foodblock-mcp": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "foodblock-mcp"
      ]
    }
  }
}
# add to Vellum
assistant mcp add foodxdevelopment-foodblock-mcp -t stdio -c npx -a -y foodblock-mcp
// mcp.json
{
  "mcpServers": {
    "foodxdevelopment-foodblock-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "foodblock-mcp"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 21 Sept 26 +1
    • Stability: 0.97 → pass security
  • 19 Sept 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 90 to 93. That category is still filling its 30-day observation window: 27 days of observed history at the previous scan, 28 at this one. The score rises as the window fills, whether or not the server changes.

  • 17 Sept 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 83 to 87. That category is still filling its 30-day observation window: 25 days of observed history at the previous scan, 26 at this one. The score rises as the window fills, whether or not the server changes.

  • 15 Sept 26 −3
    • Stability: pass → 0.80 functional
  • 14 Sept 26 +1
    • Stability: 0.97 → pass security
  • 12 Sept 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 90 to 93. That category is still filling its 30-day observation window: 27 days of observed history at the previous scan, 28 at this one. The score rises as the window fills, whether or not the server changes.

  • 10 Sept 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 83 to 87. That category is still filling its 30-day observation window: 25 days of observed history at the previous scan, 26 at this one. The score rises as the window fills, whether or not the server changes.

  • 9 Sept 26 −3
    • Stability: pass → 0.83 functional
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 21 Sept 2026 · Analysed npm/foodblock-mcp@0.5.1

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result No attestation
Ecosystem npm

Background: How many MCP packages publish verified provenance →

Dependencies 97 packages
Packages resolved 97
Stale 31
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 17 exposed · ~1,486 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
foodblock_agent_draft ~94

Create a draft FoodBlock on behalf of an agent. Draft blocks have state.draft=true. The human operator can approve or reject with foodblock_approve_draft.

NameTypeReqDescription
agent_hashstringyesHash of the agent creating this draft
refsobjectBlock refs
stateobjectBlock state
typestringyesBlock type, e.g. 'transfer.order'

No output schema declared.

No examples provided.

foodblock_approve_draft ~45

Approve a draft block created by an agent. Creates a confirmed version with draft removed.

NameTypeReqDescription
draft_hashstringyesHash of the draft block to approve

No output schema declared.

No examples provided.

foodblock_batch ~69

Create multiple FoodBlocks in a single request. Blocks are sorted in dependency order automatically. Useful for syncing offline-created blocks or bulk imports. Returns counts of inserted, skipped (duplicates), and failed blocks.

NameTypeReqDescription
blocksarrayyesArray of blocks to create, each with type, state, refs

No output schema declared.

No examples provided.

foodblock_chain ~67

Follow the update chain of a FoodBlock backwards through its versions. Shows the full version history: current → previous → original.

NameTypeReqDescription
hashstringyesThe hash of the block to trace backwards from
max_depthnumberMaximum chain depth to traverse (default 50)

No output schema declared.

No examples provided.

foodblock_create ~205

Create a new FoodBlock. A FoodBlock is the universal data primitive for the food system. It has three fields: type (what it is), state (its properties), refs (what it references). Base types: actor (person/org), place (location), substance (ingredient/product), transform (cooking/processing), transfer (sale/delivery), observe (review/certification). Use dot notation for subtypes: actor.producer, substance.product, observe.review, etc.

NameTypeReqDescription
refsobjectReferences to other blocks by hash. Example: { seller: 'abc123...' }
stateobjectThe block's properties as a JSON object. Example: { name: 'Sourdough', price: 4.50 }
typestringyesBlock type. Base types: actor, place, substance, transform, transfer, observe. Use dot notation for subtypes, e.g. actor.producer, substance.product, transfer.order

No output schema declared.

No examples provided.

foodblock_create_agent ~131

Register a new AI agent in the FoodBlock system. The agent gets its own identity, Ed25519 keypair, and can sign blocks. Every agent must have an operator — the human or business it acts for. IMPORTANT: Save the returned credentials — they cannot be recovered after server restart.

NameTypeReqDescription
capabilitiesarrayAgent capabilities
modelstringAI model, e.g. 'claude-sonnet'
namestringyesName for the agent, e.g. 'Bakery Assistant'
operator_hashstringyesHash of the actor this agent works for

No output schema declared.

No examples provided.

foodblock_fb ~119

The single natural language entry point to FoodBlock. Describe food in plain English and get structured FoodBlocks back. No need to know types, fields, or hashes. Examples: 'Sourdough bread, $4.50, organic, contains gluten', 'Amazing pizza at Luigi\'s, 5 stars', 'Green Acres Farm, 200 acres, organic wheat in Oregon', 'Walk-in cooler temperature 4 celsius', 'Ordered 50kg flour from Stone Mill'.

NameTypeReqDescription
textstringyesAny food-related natural language text

No output schema declared.

No examples provided.

foodblock_get ~39

Fetch a specific FoodBlock by its SHA-256 hash.

NameTypeReqDescription
hashstringyesThe 64-character hex hash of the block to retrieve

No output schema declared.

No examples provided.

foodblock_heads ~45

List all head blocks (latest version of each entity/item). Optionally filter by type.

NameTypeReqDescription
typestringOptional type filter (e.g. 'substance.product')

No output schema declared.

No examples provided.

foodblock_info ~38

Get an overview of the FoodBlock system: server info, block count, and protocol summary. Call this first to understand what data is available.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

foodblock_list_agents ~20

List all AI agents in the FoodBlock system.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

foodblock_load_agent ~88

Load a previously created agent using saved credentials. Required after MCP server restart to restore signing ability.

NameTypeReqDescription
agent_hashstringyesThe agent's block hash (from foodblock_create_agent)
private_keystringyesThe agent's private key hex (from foodblock_create_agent credentials)
public_keystringThe agent's public key hex (optional, for verification)

No output schema declared.

No examples provided.

foodblock_query ~129

Search for FoodBlocks by type, ref, or heads. Returns matching blocks.

NameTypeReqDescription
heads_onlybooleanIf true, only return head blocks (latest version in each chain)
limitnumberMaximum results to return (default 20)
ref_rolestringFilter by ref role name. Use with ref_value. Example: 'seller'
ref_valuestringFilter by ref value (a block hash). Use with ref_role.
typestringFilter by type (exact or prefix). Examples: 'actor', 'substance.product'

No output schema declared.

No examples provided.

foodblock_tombstone ~124

Mark a FoodBlock for content erasure (GDPR compliance). Creates an observe.tombstone block that references the target. The target block's state is replaced with {tombstoned: true}. The hash, type, and refs are preserved for chain integrity.

NameTypeReqDescription
reasonstringReason for erasure (e.g. 'gdpr_erasure', 'user_request')
requested_bystringyesHash of the actor requesting erasure
target_hashstringyesHash of the block to tombstone (64-character hex string)

No output schema declared.

No examples provided.

foodblock_tree ~72

Build the full provenance tree for a FoodBlock by following ALL refs recursively. Shows the complete story: bread ← baking ← flour ← wheat ← farm.

NameTypeReqDescription
hashstringyesThe hash of the block to build the provenance tree from
max_depthnumberMaximum tree depth (default 10)

No output schema declared.

No examples provided.

foodblock_update ~121

Create a new version of an existing FoodBlock. FoodBlocks are append-only — this creates a new block that references the previous one via refs.updates. Note: state is a FULL REPLACEMENT, not a merge.

NameTypeReqDescription
previous_hashstringyesThe hash of the block to update (64-character hex string)
refsobjectAdditional refs (updates ref is added automatically)
stateobjectThe new state (full replacement, not a merge)
typestringyesThe block type (must match the original)

No output schema declared.

No examples provided.

foodblock_validate ~80

Validate a FoodBlock against its declared schema or a provided schema. Returns an array of error messages (empty means valid). Checks required fields, types, expected refs, and instance_id requirements.

NameTypeReqDescription
refsobjectBlock refs to validate
stateobjectBlock state to validate
typestringyesBlock type to validate

No output schema declared.

No examples provided.

Common questions

What is the io.github.FoodXDevelopment/foodblock-mcp server?

io.github.FoodXDevelopment/foodblock-mcp is listed in the public MCP registry as io.github.FoodXDevelopment/foodblock-mcp. Food data tools for any AI agent. Describe food in English, get structured data back. This page covers its npm package (foodblock-mcp).

Is the io.github.FoodXDevelopment/foodblock-mcp server safe to use?

io.github.FoodXDevelopment/foodblock-mcp scores 85 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 September 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the io.github.FoodXDevelopment/foodblock-mcp server expose?

io.github.FoodXDevelopment/foodblock-mcp exposes 17 tools: foodblock_create, foodblock_update, foodblock_get, foodblock_query, foodblock_chain, and 12 more. Their descriptions and schemas cost roughly 1,486 tokens of context every time the server is loaded.

Is the io.github.FoodXDevelopment/foodblock-mcp server still maintained?

io.github.FoodXDevelopment/foodblock-mcp is still listed as active in the MCP registry. We last reached this channel on 21 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the io.github.FoodXDevelopment/foodblock-mcp server under?

io.github.FoodXDevelopment/foodblock-mcp declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.