io.github.greencore-solutions/cpg-knowledge-graph

Tools

• check_eligibility

  Check whether a GTIN can ship to a specific retailer banner in a country.

  shallow
• count_gtin_coverage

  Global coverage statistics: GTINs, nodes, makers (supply), retailers (demand).

  shallow
• find_makers

  Global cross-node maker (supply) search. Filter by segment / region / node / has_website.

  shallow
• find_retailers

  Global cross-node retailer (demand) search. Filter by region / node / parent_banner.

  shallow
• get_kernel

  SPARKS completeness tier for a brand in a market: 100 = resolvable (a real pack/size record is held) . 8 = registered (brand known, pack/size pending) . 'floor' = STANDARD default (no brand-specific record). Returns the stored tier flag — do NOT compute a score. Never returns a pack/size.

  shallow
• get_signal_chain

  Return the full ACM-68000 signal chain for a GTIN (zero-pads to 14).

  shallow
• list_brands_by_node

  SPARKS depth surface: the distinct brands SPARKS covers in a sovereign market. Answers 'what brands do you know in [node]'. Coverage only — no pack/size values.

  shallow
• list_nodes

  The 49 sovereign nodes (the spine) — each with its GS1 GTIN and CLEAN per-node maker (supply) and retailer (demand) counts (separate subqueries, never summed).

  shallow
• list_sku_types

  SPARKS taxonomy: the 84 standing BPC product-type codes the graph is structured on. Validate a type against this before a typed query. (BRAND is a tier, not a type.)

  shallow
• node_market

  Supply↔demand bridge for ONE jurisdiction: makers (supply) and retailers (demand) as two separate counts (never summed), plus the same-node potential bridge pairs.

  shallow
• resolve_gtin

  Resolve a GTIN to its procurement readiness signal. Zero-pads input to 14 digits.

  shallow
• resolve_node

  Resolve one node: its GS1 license + its makers (supply) + its retailers (demand).

  shallow
• resolve_scope

  GSC Scoped Agents Registry — Era 1 founding registry (1,000,000 standing) plus Era 2 station-keyed registry (1,000,000 capacity, mint-on-activation) under SM-ECO-10060.

  shallow
• resolve_sparks

  Two-branch SPARKS resolver (zero-pads GTIN to 14). Branch A GSC Territory/License GTIN (990832300xxx) -> FULL license record (public). Branch B any third-party BPC GTIN -> GATED proof {recognized, region_node, kernel_available}; the pack/size VALUE is NEVER returned. Route to Navigator. Brand match is fail-closed (normalized exact match); uncertainty -> recognized:false.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/11ee345f-431f-426d-8af5-1d4ea8434758/badge.svg)](https://vouch.tools/servers/11ee345f-431f-426d-8af5-1d4ea8434758)