io.github.FoodXDevelopment/foodblock-mcp
NPM · FOODBLOCK-MCP · SCANNED AUG 3
Food data tools for any AI agent. Describe food in English, get structured data back.
Available components
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 →
Supply Chain Security87
- No malware found by supply-chain analysis.Pass
- Only part of the dependency tree could be resolved (96 of 100), so this covers what we could see, not the whole tree.Partial
- No install/post-install scripts declared.Pass
- Only part of the dependency tree could be resolved (96 of 100), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 166 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability77
- 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 Management27
- Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
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
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · foodblock-mcp
claude mcp add foodxdevelopment-foodblock-mcp -- npx -y foodblock-mcp
codex mcp add foodxdevelopment-foodblock-mcp -- npx -y foodblock-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"foodxdevelopment-foodblock-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"foodblock-mcp"
],
"enabled": true
}
}
} openclaw mcp add foodxdevelopment-foodblock-mcp --command npx --arg -y --arg foodblock-mcp
mcp_servers:
foodxdevelopment-foodblock-mcp:
command: "npx"
args: ["-y", "foodblock-mcp"] {
"mcpServers": {
"foodxdevelopment-foodblock-mcp": {
"command": "npx",
"args": [
"-y",
"foodblock-mcp"
]
}
}
} 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.
- 3 Aug 26 +50
- Provenance: unverified → fail ▼ security
- Known CVEs: unverified → partial ▲ security
- Install scripts: unverified → pass ▲ security
- MCP protocol: unverified → pass ▲ functional
- Stability: unverified → 0.27 ▲ functional
- Maintenance: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- License: unverified → pass ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- Licence: MIT functional
- 2 Aug 26 −16
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. security
- Tool coverage: 100 → unverified ▼ functional
- Capabilities: pass → unverified ▼ functional
- 1 Aug 26 +31
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- Tool coverage: unverified → 100 ▲ functional
- MCP protocol: unverified → pass ▲ functional
- 31 Jul 26 −57
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 30 Jul 26 −18
- Malware scan: pass → unverified ▼ security
- 27 Jul 26 +37
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 26 Jul 26 43
First indexed and scored.
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 3 Aug 2026 · Analysed npm/[email protected]
Provenance none
Ecosystem: npm · Outcome: none
Dependencies 96 packages
96 packages in the resolved dependency tree · 95 deprecated · 29 stale.
The dependency tree was only partially resolved, so these counts may be incomplete.
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.
foodblock_agent_draft Create 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.
| Name | Type | Req | Description |
|---|---|---|---|
| agent_hash | string | yes | Hash of the agent creating this draft |
| refs | object | — | Block refs |
| state | object | — | Block state |
| type | string | yes | Block type, e.g. 'transfer.order' |
No output schema declared.
No examples provided.
foodblock_approve_draft Approve Agent Draft ~45
Approve a draft block created by an agent. Creates a confirmed version with draft removed.
| Name | Type | Req | Description |
|---|---|---|---|
| draft_hash | string | yes | Hash of the draft block to approve |
No output schema declared.
No examples provided.
foodblock_batch Batch Create FoodBlocks ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| blocks | array | yes | Array of blocks to create, each with type, state, refs |
No output schema declared.
No examples provided.
foodblock_chain Trace Provenance Chain ~67
Follow the update chain of a FoodBlock backwards through its versions. Shows the full version history: current → previous → original.
| Name | Type | Req | Description |
|---|---|---|---|
| hash | string | yes | The hash of the block to trace backwards from |
| max_depth | number | — | Maximum chain depth to traverse (default 50) |
No output schema declared.
No examples provided.
foodblock_create Create FoodBlock ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| refs | object | — | References to other blocks by hash. Example: { seller: 'abc123...' } |
| state | object | — | The block's properties as a JSON object. Example: { name: 'Sourdough', price: 4.50 } |
| type | string | yes | Block 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 Create AI 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.
| Name | Type | Req | Description |
|---|---|---|---|
| capabilities | array | — | Agent capabilities |
| model | string | — | AI model, e.g. 'claude-sonnet' |
| name | string | yes | Name for the agent, e.g. 'Bakery Assistant' |
| operator_hash | string | yes | Hash of the actor this agent works for |
No output schema declared.
No examples provided.
foodblock_fb Natural Language FoodBlock ~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'.
| Name | Type | Req | Description |
|---|---|---|---|
| text | string | yes | Any food-related natural language text |
No output schema declared.
No examples provided.
foodblock_get Get FoodBlock ~39
Fetch a specific FoodBlock by its SHA-256 hash.
| Name | Type | Req | Description |
|---|---|---|---|
| hash | string | yes | The 64-character hex hash of the block to retrieve |
No output schema declared.
No examples provided.
foodblock_heads List Head Blocks ~45
List all head blocks (latest version of each entity/item). Optionally filter by type.
| Name | Type | Req | Description |
|---|---|---|---|
| type | string | — | Optional type filter (e.g. 'substance.product') |
No output schema declared.
No examples provided.
foodblock_info FoodBlock System 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 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 Load Agent ~88
Load a previously created agent using saved credentials. Required after MCP server restart to restore signing ability.
| Name | Type | Req | Description |
|---|---|---|---|
| agent_hash | string | yes | The agent's block hash (from foodblock_create_agent) |
| private_key | string | yes | The agent's private key hex (from foodblock_create_agent credentials) |
| public_key | string | — | The agent's public key hex (optional, for verification) |
No output schema declared.
No examples provided.
foodblock_query Query FoodBlocks ~129
Search for FoodBlocks by type, ref, or heads. Returns matching blocks.
| Name | Type | Req | Description |
|---|---|---|---|
| heads_only | boolean | — | If true, only return head blocks (latest version in each chain) |
| limit | number | — | Maximum results to return (default 20) |
| ref_role | string | — | Filter by ref role name. Use with ref_value. Example: 'seller' |
| ref_value | string | — | Filter by ref value (a block hash). Use with ref_role. |
| type | string | — | Filter by type (exact or prefix). Examples: 'actor', 'substance.product' |
No output schema declared.
No examples provided.
foodblock_tombstone Tombstone FoodBlock ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| reason | string | — | Reason for erasure (e.g. 'gdpr_erasure', 'user_request') |
| requested_by | string | yes | Hash of the actor requesting erasure |
| target_hash | string | yes | Hash of the block to tombstone (64-character hex string) |
No output schema declared.
No examples provided.
foodblock_tree Trace Provenance Tree ~72
Build the full provenance tree for a FoodBlock by following ALL refs recursively. Shows the complete story: bread ← baking ← flour ← wheat ← farm.
| Name | Type | Req | Description |
|---|---|---|---|
| hash | string | yes | The hash of the block to build the provenance tree from |
| max_depth | number | — | Maximum tree depth (default 10) |
No output schema declared.
No examples provided.
foodblock_update Update FoodBlock ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| previous_hash | string | yes | The hash of the block to update (64-character hex string) |
| refs | object | — | Additional refs (updates ref is added automatically) |
| state | object | — | The new state (full replacement, not a merge) |
| type | string | yes | The block type (must match the original) |
No output schema declared.
No examples provided.
foodblock_validate Validate FoodBlock ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| refs | object | — | Block refs to validate |
| state | object | — | Block state to validate |
| type | string | yes | Block type to validate |
No output schema declared.
No examples provided.