[ PKP ]

Product Knowledge Protocol

Open standard for AI agent product knowledge

npm install -g @pkprotocol/cli

The missing layer in agentic commerce

PKP solves "what to buy and why" before payment protocols kick in. Structured product data that AI agents can discover, compare, and recommend.

/.well-known/

Web-native

Data lives on vendor domains. No central database. Just HTTP GET.

<agent/>

Agent-first

Designed for AI to consume. MCP servers included.

{schema}

Typed schemas

15 category schemas. Zod validation. Comparable by design.

★ trust

Confidence levels

Every data point has source + verification timestamp.

PRODUCT.md

Simple YAML frontmatter + Markdown content

galaxy-s25-ultra.md 
---
schema: pkp/1.0
sku: "galaxy-s25-ultra"
brand: "Samsung"
name: "Galaxy S25 Ultra"
category: "celulares/smartphones"
summary: "Flagship smartphone with S Pen and 200MP camera"

price:
  currency: BRL
  value: 9499.00

specs:
  display_size: 6.9
  processor: "Snapdragon 8 Elite"
  ram_gb: 12
  storage_gb: 256
  main_camera_mp: 200
  battery_mah: 5000

confidence:
  specs:
    source: manufacturer
    verified_at: "2025-01-15"
---

## Highlights
- 200MP main camera with AI processing
- S Pen with improved latency
- Titanium frame, Gorilla Glass Armor

## FAQ
### Does it support 5G?
Yes, all major bands including mmWave.

CLI

Everything you need to create, validate, and serve product catalogs

pkp init Initialize a new catalog
pkp validate Validate PRODUCT.md files
pkp build Generate .well-known/pkp/
pkp generate -u <url> AI-generate from product page
pkp serve Local dev server

Packages

Modular architecture. Use what you need.

Package Description Install
@pkprotocol/cli Command-line interface npm i -g @pkprotocol/cli
@pkprotocol/spec Schemas, parser, validator npm i @pkprotocol/spec
@pkprotocol/catalog-server MCP server for catalogs npm i @pkprotocol/catalog-server
@pkprotocol/registry-server Cross-domain discovery npm i @pkprotocol/registry-server
@pkprotocol/skills AI prompts for assistants npm i @pkprotocol/skills

15 Category Schemas

Type-safe specs for each product category

smartphones notebooks tvs tablets audio monitors smartwatches cameras games eletrodomesticos moda moveis brinquedos livros beleza

Architecture

┌─────────────────────────────────────────────────────────────┐
│  LAYER 0 - Static (files on server)                         │
│  ├── /.well-known/pkp/catalog.json                         │
│  ├── /.well-known/pkp/products/*.md                        │
│  └── Access: HTTP GET | Cost: zero                         │
├─────────────────────────────────────────────────────────────┤
│  LAYER 1 - Catalog MCP Server                               │
│  ├── Tools: search, compare, filter, faq, alternatives     │
│  └── Access: MCP protocol (Claude Desktop, etc)            │
├─────────────────────────────────────────────────────────────┤
│  LAYER 2 - Registry Server                                  │
│  ├── Cross-domain indexing and search                      │
│  └── Access: MCP or REST API                               │
└─────────────────────────────────────────────────────────────┘

Get started in 30 seconds

npm install -g @pkprotocol/cli pkp init my-catalog pkp build
Read the Docs View on GitHub