Bill Of Materials Integrity

Pure, bounded analysis of an explicit bill-of-materials graph: validates structure, finds missing references, duplicate IDs, duplicate edges, and cycles (whole graph, even parts unreachable from the root), and - when the graph is completely clean - exactly explodes root quantity through every assembly level with exact-decimal arithmetic, aggregating shared components reached via different branches. No network access and no manufacturing/supplier certification: this checks the data you supply, not the real world.

Pricing

0.05 per analysis

Requires x402 capable MCP client with wallet for payment settlement.

Input Schema

{
  "type": "object",
  "required": [
    "root",
    "quantity",
    "parts"
  ],
  "additionalProperties": false,
  "properties": {
    "root": {
      "type": "string",
      "description": "ID of the part to explode from. Must match one of parts[].id.",
      "minLength": 1,
      "maxLength": 128
    },
    "quantity": {
      "type": "string",
      "description": "Positive exact decimal, <=12 integer digits, <=6 fraction digits.",
      "pattern": "^(?!0+(?:\\.0{1,6})?$)\\d{1,12}(\\.\\d{1,6})?$"
    },
    "parts": {
      "type": "array",
      "maxItems": 500,
      "items": {
        "type": "object",
        "required": [
          "id",
          "unit"
        ],
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          },
          "unit": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          },
          "components": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "type": "object",
              "required": [
                "part_id",
                "quantity"
              ],
              "additionalProperties": false,
              "properties": {
                "part_id": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128
                },
                "quantity": {
                  "type": "string",
                  "pattern": "^(?!0+(?:\\.0{1,6})?$)\\d{1,12}(\\.\\d{1,6})?$"
                }
              }
            }
          }
        }
      }
    }
  }
}

Example Input

{
  "root": "bike",
  "quantity": "2",
  "parts": [
    {
      "id": "bike",
      "unit": "each",
      "components": [
        {
          "part_id": "wheel",
          "quantity": "2"
        },
        {
          "part_id": "frame",
          "quantity": "1"
        }
      ]
    },
    {
      "id": "wheel",
      "unit": "each",
      "components": [
        {
          "part_id": "spoke",
          "quantity": "16"
        },
        {
          "part_id": "tire",
          "quantity": "1"
        },
        {
          "part_id": "bolt",
          "quantity": "2"
        }
      ]
    },
    {
      "id": "frame",
      "unit": "each",
      "components": [
        {
          "part_id": "bolt",
          "quantity": "4"
        }
      ]
    },
    {
      "id": "spoke",
      "unit": "each"
    },
    {
      "id": "tire",
      "unit": "each"
    },
    {
      "id": "bolt",
      "unit": "each"
    }
  ]
}

Example Output

{
  "ok": true,
  "issues": [],
  "summary": {
    "parts": 6,
    "assemblies": 3,
    "leaves": 3,
    "issues": 0,
    "reachable_parts": 6
  },
  "explosion": [
    {
      "part_id": "bike",
      "unit": "each",
      "quantity": "2"
    },
    {
      "part_id": "wheel",
      "unit": "each",
      "quantity": "4"
    },
    {
      "part_id": "frame",
      "unit": "each",
      "quantity": "2"
    },
    {
      "part_id": "spoke",
      "unit": "each",
      "quantity": "64"
    },
    {
      "part_id": "tire",
      "unit": "each",
      "quantity": "4"
    },
    {
      "part_id": "bolt",
      "unit": "each",
      "quantity": "16"
    }
  ],
  "scope": "supplied_bom_only"
}

Limitations

• Supplied-data only: no network calls, no supplier/manufacturing certification, no real-world verification of parts.
• Input capped at 128 KiB, JSON depth <=12, JSON nodes <=20000.
• IDs (part and component) <=128 chars and nonblank; unit <=64 chars.
• Quantities must be positive exact decimals: <=12 integer digits, <=6 fraction digits.
• At most 500 parts, 100 components per part, 2000 total component edges.
• Reachable depth from root capped at 20 levels; exceeding it is reported, not silently truncated into the result.
• Cycles are detected across the whole submitted graph, including parts unreachable from root, and are reported (bounded to one representative cycle per strongly connected component).
• Reported issues and cycles are each capped at 200 with explicit truncation metadata if the cap is hit.
• Explosion (the exploded quantity table) is returned only when the whole graph has zero reported issues; any issue anywhere - even in an unreachable part - conservatively nulls the explosion.
• Exact arithmetic uses reduced BigInt fractions; a result requiring more than 300 combined numerator/denominator digits is refused as a reported issue instead of silently rounded.
• Duplicate component references within the same assembly are reported and are not double-counted.
• Results at most 96 KiB; retry identical input and authorization within 24 hours to recover a purchase.

Connect via MCP

Add to your MCP client configuration:

{
  "mcpServers": {
    "bill-of-materials-integrity": {
      "type": "http",
      "url": "https://mcp-factory.bowling-anthony.workers.dev/bill-of-materials-integrity/mcp"
    }
  }
}