Catalog PyPI
PACKAGE EXPLORERView in registry

agentic-product-protocol-mcp

PyPI

Klarna-style product discovery for AI agents — structured product data, comparison, feed conversion

agentic-commerceai-agentse-commerceklarnamcpproduct-discovery
Versions collected1
Direct dependencies2From release 0.1.0
Last observed20 Oct, 22:20 UTC

README

Version 0.1.0 documentation

Agentic Product Protocol MCP Server

Klarna-style product discovery for AI shopping agents.

Makes product catalogs machine-readable so AI agents can search, compare, and purchase products programmatically — no screen scraping, no landing pages.

The Problem

Today's e-commerce is built for humans: landing pages, image carousels, "Add to Cart" buttons. AI shopping agents can't efficiently navigate this. They need structured product data — not HTML.

Klarna introduced the Agentic Product Protocol (December 2025) to solve exactly this: a standardized way for merchants to expose their product catalogs to AI agents. Think of it as RSS feeds, but for shopping.

What This Server Does

This MCP server implements the core ideas of agentic product discovery:

  • Structured search results — not web pages, but clean JSON with name, price, nutrition, ratings
  • Product comparison — side-by-side structured comparison across multiple dimensions
  • Feed conversion — take any product feed (JSON, CSV, Open Food Facts) and normalize it into an agent-friendly schema
  • Schema generation — convert raw product data into the Agentic Product Protocol format
  • Availability checking — real-time product status in a machine-readable format

Uses Open Food Facts as a demo data source — works with any product feed.

Installation

pip install agentic-product-protocol-mcp

Or with uvx (no install needed):

uvx agentic-product-protocol-mcp

Configuration

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "product-protocol": {
      "command": "uvx",
      "args": ["agentic-product-protocol-mcp"]
    }
  }
}

Claude Code (CLI)

claude mcp add product-protocol -- uvx agentic-product-protocol-mcp

Tools

ToolDescription
search_productsSearch products with structured results (name, nutrition, labels, stores)
get_product_detailsGet full product data by barcode/ID
compare_productsSide-by-side comparison of 2-5 products
convert_feedConvert JSON/CSV/OFF feeds into normalized agent schema
generate_product_schemaGenerate Agentic Product Protocol schema from raw data
check_availabilityCheck product availability and store information

Example Usage

Search for products:

"Search for organic chocolate bars"

Compare products:

"Compare these three chocolate bars: 3017620422003, 7622210449283, 7613034626844"

Convert a feed:

"Convert this Open Food Facts search into agent-friendly format: https://world.openfoodfacts.org/cgi/search.pl?search_terms=protein+bar&page_size=10"

Generate schema:

"Generate an agentic product schema for this product data: {name: 'Widget Pro', price: 29.99, category: 'Electronics'}"

Why Structured Feeds > Landing Pages

Landing PagesStructured Feeds
ParsingScreen scraping, fragileClean JSON, reliable
SpeedLoad page → parse DOM → extractSingle API call
AccuracyLayout changes break everythingSchema-validated
ComparisonManual extraction per siteNormalized across sources
Agent UXBuilt for human eyesBuilt for agent consumption

Data Source

This server uses Open Food Facts as its demo data source — a free, open, community-built database of food products from around the world. No API key required.

For production use, connect your own product feeds using the convert_feed tool with JSON or CSV format.

License

MIT

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Versions 1

Collected releases
VersionPublishedDirect dependenciesOpen version
0.1.020 Mar 20262

Package advisories

0
No matching advisories collected

This describes our collected data; it is not a security assessment.

Repository

PENDING
aiagentkarl/agentic-product-protocol-mcp

Shared repository data · GitHub

License detected in repository
Not collected

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 22:20 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package:f7c8e37ea0a7364960aebe5a14037e79593c6dbd4102d5f5d6c5433025689b32