# MCP CPG Agent Protocols

> MCP CPG Agent Protocols is an MCP server for developer tools. MCP server for SKU eligibility signals and jurisdiction lookups in commerce. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** API
- **Website:** https://cpgagentprotocols.ai
- **Repository:** https://github.com/greencore-solutions/cpg-agent-protocols
- **MCP Registry name:** io.github.greencore-solutions/cpg-agent-protocols
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [e-commerce](https://ai-powered.com/categories/e-commerce)
- **Listing updated:** 2026-11-18

## About

Rather than a conventional catalogue, this server answers deterministic questions about consumer packaged goods: whether a product can be procured in a given context, how a SKU is classified, and which jurisdiction governs it. Each answer is generated from compiled protocol definitions, so an agent that asks the same question gets the same response regardless of who asks.

The server is stateless and runs over streamable HTTP at a single public endpoint. The README notes there is no database and no stored customer data. It exposes nine tools covering the protocol family, the signal register, SPARKS dimensions, jurisdictional member nodes and the GSC wire-header canon.

It is aimed at developers building buyer-side or retailer-side agents that need a shared vocabulary for eligibility outcomes, and at teams that want to check how a signal code maps between its ACM and CPG forms before wiring it into an ordering flow.

## Features

- **Stateless signal lookups:** Every tool answers from compiled canon, so repeated queries return identical results with no session state.
- **Signal register resolution:** Resolves an ACM or CPG signal code to its state and meaning, reporting both the input code and the resolved ACM form.
- **SPARKS dimension reference:** Lists the six SPARKS dimensions used to classify a SKU and returns the canon record for any single dimension.
- **Jurisdictional member nodes:** Lists sovereign member nodes with their code, namespace, jurisdiction, region and GS1 territory GTIN, and resolves individual members.
- **Wire header canon:** Returns the x-gsc-* headers that GSC surfaces emit, in canonical order.
- **Live endpoint with connect kit:** A public streamable-http endpoint is documented alongside Python and TypeScript examples that call it.

## Good for

- Checking whether a SKU is eligible for autonomous procurement before an agent completes an order
- Mapping CPG- profile signal codes to their ACM- wire-form definitions
- Looking up which jurisdictional node governs a given market code such as FR or AU
- Listing the SPARKS classification dimensions when designing a product data schema
- Testing an agent's signal handling against the full set of seven defined outcomes

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http cpg-agent-protocols https://mcp.cpgagentprotocols.ai/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.cpgagentprotocols.ai/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "cpg-agent-protocols": {
      "url": "https://mcp.cpgagentprotocols.ai/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "cpg-agent-protocols": {
      "type": "http",
      "url": "https://mcp.cpgagentprotocols.ai/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "cpg-agent-protocols": {
      "serverUrl": "https://mcp.cpgagentprotocols.ai/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "cpg-agent-protocols": {
      "type": "http",
      "url": "https://mcp.cpgagentprotocols.ai/mcp"
    }
  }
}
```

## Tools

- `list_protocols`: Lists the protocol family and its three-stage spine.
- `get_protocol`: Returns the full canon record for a named protocol.
- `list_signals`: Enumerates the signal register.
- `resolve_signal`: Returns the state and meaning of a single signal code.
- `list_sparks_dimensions`: Lists the six SPARKS dimensions.
- `resolve_sparks_dimension`: Returns the canon record for one SPARKS dimension.
- `list_members`: Lists sovereign jurisdictional member nodes.
- `resolve_member`: Returns the canon record for one member node.
- `get_header_canon`: Returns the GSC wire-header canon.

## FAQ

### Does the server keep any state between requests?

No. The README describes it as stateless with no database, and says every answer is the same for every agent that asks.

### Which tools does it expose?

The README lists nine: list_protocols, get_protocol, list_signals, resolve_signal, list_sparks_dimensions, resolve_sparks_dimension, list_members, resolve_member and get_header_canon.

### What does an ACM-451 signal mean?

It means the outcome cannot be resolved deterministically and needs human review, which the README says is served by mcp.cpghumanintheloop.ai.

### What languages are the examples in?

Python 3 using only the standard library, and TypeScript that runs on Node 24 with no dependencies. Both target the live endpoint only.

### How do I add MCP CPG Agent Protocols to Claude Code?

Run this command in your terminal: claude mcp add --transport http cpg-agent-protocols https://mcp.cpgagentprotocols.ai/mcp

### What are the best alternatives to MCP CPG Agent Protocols?

The closest alternatives to MCP CPG Agent Protocols are WebMCP Demo Store, Universal Data API, MCP Rating, ChannelEngine MCP by usefulapi and MCP Liveness.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [WebMCP Demo Store](https://ai-powered.com/mcp/webmcp-demo-store): WebMCP Demo Store is an open-source MCP server for e-commerce.
- [Universal Data API](https://ai-powered.com/mcp/universal-data-api): Universal Data API is a paid MCP server for web search and scraping.
- [MCP Rating](https://ai-powered.com/mcp/mcp-rating): MCP Rating is a free MCP server for developer tools.
- [ChannelEngine MCP by usefulapi](https://ai-powered.com/mcp/channelengine-mcp-by-usefulapi): ChannelEngine MCP by usefulapi is a freemium MCP server for e-commerce.
- [MCP Liveness](https://ai-powered.com/mcp/mcp-liveness): MCP Liveness is a free MCP server for developer tools.
- [Gumroad MCP by usefulapi](https://ai-powered.com/mcp/gumroad-mcp-by-usefulapi): Gumroad MCP by usefulapi is a freemium MCP server for e-commerce.
- [Sample Shop MCP server](https://ai-powered.com/mcp/sample-shop-mcp-server): Sample Shop MCP server is an open-source MCP server for developer tools.
- [Ecommerce Mcp](https://ai-powered.com/mcp/ecommerce-mcp): Ecommerce Mcp is a freemium MCP server for e-commerce.

---
Source: https://ai-powered.com/mcp/mcp-cpg-agent-protocols
