MCP Server
CPG Knowledge Graph
io.github.greencore-solutions/cpg-knowledge-graph
What this MCP does
Maps beauty and personal-care brands, makers, retailers, GTINs, markets, procurement readiness, and supply-demand relationships across global market nodes.
Capabilities
Tools
14
tools
check_eligibility
Check banner eligibility
Check whether a GTIN can ship to a specific retailer banner in a country.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['gtin', 'banner', 'country_iso'], 'properties': {'gtin': {'type': 'string', 'description': 'GS1 GTIN of the product, 8 to 14 digits; zero-padded to the canonical 14-digit GTIN-14 before lookup (e.g. 00990832300624).'}, 'banner': {'type': 'string', 'description': 'Retail banner name exactly as registered in the graph (the retailer_name returned by find_retailers).'}, 'country_iso': {'type': 'string', 'description': 'ISO 3166-1 alpha-2 code of the selling market (e.g. FR), case-insensitive.'}}}
Output schema
{'type': 'object', 'additionalProperties': True}
count_gtin_coverage
Count GTIN coverage
Global coverage statistics: GTINs, nodes, makers (supply), retailers (demand).
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}}
Output schema
{'type': 'object', 'additionalProperties': True}
find_makers
Find makers
Global cross-node maker (supply) search. Filter by segment / region / node / has_website.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'node': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Sovereign node code: the ISO 3166-1 alpha-2 code of the jurisdiction (e.g. FR, KR, AE), case-insensitive; list_nodes returns the 49 codes. Omit for all nodes.'}, 'limit': {'type': 'integer', 'default': 25, 'description': 'Maximum rows to return, 1 to 500 (default 25).'}, 'region': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Region label as stored on the registry row (e.g. EU, ASIA), case-insensitive. Omit for all regions.'}, 'segment': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Maker segment label as stored on the registry row (e.g. Haircare, Skincare); exact match. Omit for all segments.'}, 'has_website': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}], 'default': None, 'description': 'true = only makers with a website on record; false = only makers without one; omit for both.'}}}
Output schema
{'type': 'object', 'additionalProperties': True}
find_retailers
Find retailers
Global cross-node retailer (demand) search. Filter by region / node / parent_banner.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'node': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Sovereign node code: the ISO 3166-1 alpha-2 code of the jurisdiction (e.g. FR, KR, AE), case-insensitive; list_nodes returns the 49 codes. Omit for all nodes.'}, 'limit': {'type': 'integer', 'default': 25, 'description': 'Maximum rows to return, 1 to 500 (default 25).'}, 'region': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Region label as stored on the registry row (e.g. EU, ASIA), case-insensitive. Omit for all regions.'}, 'parent_banner': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Parent banner name, case-insensitive substring match (e.g. Carrefour). Omit for all banners.'}}}
Output schema
{'type': 'object', 'additionalProperties': True}
get_kernel
Get SPARKS 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.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['brand', 'node'], 'properties': {'node': {'type': 'string', 'description': 'Sovereign node code: the ISO 3166-1 alpha-2 code of the jurisdiction (e.g. FR, KR, AE), case-insensitive; list_nodes returns the 49 codes.'}, 'brand': {'type': 'string', 'description': 'Brand name as marketed (e.g. Nivea); normalized exact match, fail-closed.'}}}
Output schema
{'type': 'object', 'additionalProperties': True}
get_signal_chain
Get ACM-68000 signal chain
Return the full ACM-68000 signal chain for a GTIN (zero-pads to 14).
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['gtin'], 'properties': {'gtin': {'type': 'string', 'description': 'GS1 GTIN of the product, 8 to 14 digits; zero-padded to the canonical 14-digit GTIN-14 before lookup (e.g. 00990832300624).'}}}
Output schema
{'type': 'object', 'additionalProperties': True}
list_brands_by_node
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.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['node'], 'properties': {'node': {'type': 'string', 'description': 'Sovereign node code: the ISO 3166-1 alpha-2 code of the jurisdiction (e.g. FR, KR, AE), case-insensitive; list_nodes returns the 49 codes.'}}}
Output schema
{'type': 'object', 'additionalProperties': True}
list_nodes
List sovereign 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).
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}}
Output schema
{'type': 'object', 'additionalProperties': True}
list_sku_types
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.)
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}}
Output schema
{'type': 'object', 'additionalProperties': True}
node_market
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. The market-picture call for a jurisdiction; use this first for 'what does the market look like in X'.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string', 'description': 'Sovereign node code: the ISO 3166-1 alpha-2 code of the jurisdiction (e.g. FR, KR, AE), case-insensitive; list_nodes returns the 49 codes.'}}}
Output schema
{'type': 'object', 'additionalProperties': True}
resolve_gtin
Resolve GTIN
Resolve a GTIN to its procurement readiness signal. Zero-pads input to 14 digits.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['gtin'], 'properties': {'gtin': {'type': 'string', 'description': 'GS1 GTIN of the product, 8 to 14 digits; zero-padded to the canonical 14-digit GTIN-14 before lookup (e.g. 00990832300624).'}}}
Output schema
{'type': 'object', 'additionalProperties': True}
resolve_node
Resolve node
Resolve one node: its GS1 license + its makers (supply) + its retailers (demand). The market-picture call for a jurisdiction; use this first for 'what does the market look like in X'.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string', 'description': 'Sovereign node code: the ISO 3166-1 alpha-2 code of the jurisdiction (e.g. FR, KR, AE), case-insensitive; list_nodes returns the 49 codes.'}}}
Output schema
{'type': 'object', 'additionalProperties': True}
resolve_scope
Resolve scoped agent
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.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'scope_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Scoped agent id to resolve: Era 1 sa-{parent}-{jurisdiction}-m{mcp}-{seq} or Era 2 sa2-{namespace}-m{mcp}-d{station}-w{seq}. Omit for the registry summary.'}}}
Output schema
{'type': 'object', 'additionalProperties': True}
resolve_sparks
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.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['gtin'], 'properties': {'gtin': {'type': 'string', 'description': 'GS1 GTIN of the product, 8 to 14 digits; zero-padded to the canonical 14-digit GTIN-14 before lookup (e.g. 00990832300624).'}}}
Output schema
{'type': 'object', 'additionalProperties': True}
History
Recent tool changes
Changed
node_market
Sept. 19, 2026, 2:42 a.m.
Changed
resolve_node
Sept. 19, 2026, 2:42 a.m.
Added
resolve_sparks
Sept. 17, 2026, 12:42 p.m.
Added
get_kernel
Sept. 17, 2026, 12:42 p.m.
Added
list_brands_by_node
Sept. 17, 2026, 12:42 p.m.
Added
list_sku_types
Sept. 17, 2026, 12:42 p.m.
Added
node_market
Sept. 17, 2026, 12:42 p.m.
Added
find_retailers
Sept. 17, 2026, 12:42 p.m.
Added
find_makers
Sept. 17, 2026, 12:42 p.m.
Added
resolve_node
Sept. 17, 2026, 12:42 p.m.
Added
list_nodes
Sept. 17, 2026, 12:42 p.m.
Added
resolve_scope
Sept. 17, 2026, 12:42 p.m.
Added
count_gtin_coverage
Sept. 17, 2026, 12:42 p.m.
Added
get_signal_chain
Sept. 17, 2026, 12:42 p.m.
Added
check_eligibility
Sept. 17, 2026, 12:42 p.m.
Added
resolve_gtin
Sept. 17, 2026, 12:42 p.m.
Discover
Similar MCP servers
amazon-product-research-mcp
com.webotee/amazon-product-research-mcp
Researches Amazon products, brands, sellers, buy-box activity, sourcing profitability, category competition, and supplier opportu…
API Acre
com.apiacre/api-acre
Offers paid APIs for EVM blockchain inspection, data transformation and validation, geocoding, weather, currency conversion, and …
Ask AI
com.ask-ai-data-connector/ask-ai
Answers questions about connected e-commerce data from Shopify, Klaviyo, GA4, Triple Whale, and other sources, covering sales, ma…
Neonjelly
io.neonjelly/mcp
Analyzes Shopify stores, products, apps, traffic, competitors, catalog changes, market cohorts and outreach contacts across a lar…
zobrx
com.zobrx/zobrx
Provides read-only ecommerce operations and analytics for orders, inventory, marketplace performance, advertising, settlements, t…
sella
io.github.sella-network/sella
Operates an agent marketplace for purchasing datasets, APIs, and products, including catalog discovery, purchase settlement, deli…
kurashigram
io.github.Kotaro-Studio/kurashigram
Provides cited Japanese price comparisons, cost-of-living statistics, product prices, shopping data, public benefit information, …
Keepa
io.github.pipeworx-io/keepa
Searches Amazon products and categories and provides price, sales-rank, deal, bestseller, and historical product data through Kee…