Skip to content
Back to search

OCP-Catalog

The Open Commerce Protocol (OCP) Catalog — the protocol specification, its schema/client packages, the CLI, and minimal reference implementations.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/open-commerce-protocol--ocp-catalog/badge.svg)](/listings/open-commerce-protocol--ocp-catalog)

HTML

<a href="/listings/open-commerce-protocol--ocp-catalog"><img src="/api/listings/open-commerce-protocol--ocp-catalog/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

The skill teaches an agent the OCP workflow — discover a Registration node, inspect a Catalog manifest, query with a declared query pack, resolve an entry — and drives it through the `ocp` CLI. There are two ways to install it, from the same source (`skills/ocp-catalog/`):

**One command, any agent:**

npx @ocp-catalog/skill                # auto-detect
npx @ocp-catalog/skill --agent claude # ~/.claude/skills
npx @ocp-catalog/skill --agent all    # Claude Code + Codex + .agents
npx @ocp-catalog/skill --scope project # ./.claude/skills in the current repo
npx @ocp-catalog/skill doctor         # where is it installed?

It refuses to overwrite a skill it didn't install unless you pass `--force`, and `--dry-run` prints the plan without touching disk.

**As a Claude Code plugin:**

/plugin marketplace add Open-Commerce-Protocol/OCP-Catalog
/plugin install ocp-catalog@ocp-catalog

If you already use the CLI, `ocp skill install` does the same thing.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 21 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "ocp-catalog",
  4. "description": "Open Commerce Protocol (OCP) Catalog — agent tooling for discovering, querying, and resolving commercial objects across independent catalogs.",
  5. "owner": {
  6. "name": "Open Commerce Protocol",
  7. "url": "https://github.com/Open-Commerce-Protocol"
  8. },
  9. "plugins": [
  10. {
  11. "name": "ocp-catalog",
  12. "description": "Work with OCP Catalog protocols and tooling: discover or search Registration nodes, inspect Catalog manifests, query Catalog entries, resolve results, and validate OCP payloads.",
  13. "author": {
  14. "name": "Open Commerce Protocol"
  15. },
  16. "category": "development",
  17. "source": "./plugins/ocp-catalog",
  18. "homepage": "https://github.com/Open-Commerce-Protocol/OCP-Catalog/tree/main/plugins/ocp-catalog"
  19. }
  20. ]
  21. }
README.md · README · 144 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # OCP Catalog
  2. The **Open Commerce Protocol (OCP) Catalog** — the protocol specification, its
  3. schema/client packages, the CLI, and minimal reference implementations.
  4. An OCP Catalog Node exposes a small HTTP surface that lets AI agents discover,
  5. query, and resolve commercial objects (products, offers, suppliers, …) across
  6. independent catalogs, with a separate Registration layer for discovery and a
  7. Handshake layer for how providers feed data into a catalog.
  8. ## What's in this repo
  9. This repo holds three tiers, in increasing order of distance from the spec:
  10. | Tier | What it is | Where |
  11. |---|---|---|
  12. | **Protocol** | The specs and the schema/client packages that encode them | [`docs/specs/`](./docs/specs), [`packages/`](./packages) |
  13. | **Skill & CLI** | Agent tooling that speaks the protocol — installable in one command | [`skills/`](./skills), [`packages/ocp-cli/`](./packages/ocp-cli), [`plugins/`](./plugins) |
  14. | **Examples** | The smallest correct Catalog Node, in three languages | [`examples/`](./examples) |
  15. Production applications are **not** here — see [Reference applications](#reference-applications).
  16. ```text
  17. docs/specs/ Protocol specifications
  18. registration/v1.md How a Catalog registers with a Registration node
  19. handshake/v1.md How a Provider registers + syncs into a Catalog
  20. ocp.catalog.registration.v1/ Machine-readable JSON Schemas (registration)
  21. ocp.catalog.handshake.v1/ Machine-readable JSON Schemas (handshake)
  22. packages/
  23. ocp-schema/ Zod schemas: manifest, query, resolve, objects, health
  24. registration-schema/ Zod schemas for the registration protocol
  25. ocp-activity-schema/ Zod schemas for catalog activity events
  26. ocp-client/ Typed client helpers + validators
  27. shared/ Small shared utilities
  28. webmcp-adapter/ WebMCP adapter for browser tools
  29. ocp-cli/ `ocp` CLI (published to npm)
  30. ocp-skill/ `npx @ocp-catalog/skill` one-command skill installer
  31. examples/
  32. typescript/ python/ go/ Minimal, spec-valid Catalog Nodes (~3 in-memory products)
  33. skills/ocp-catalog/ The agent skill (single source of truth)
  34. plugins/ocp-catalog/ Claude Code plugin wrapper (generated from skills/)
  35. apps/ocp-site-web/ The OCP protocol website + docs
  36. ```
  37. The published protocol packages (npm, scope `@ocp-catalog`):
  38. [`ocp-schema`](https://www.npmjs.com/package/@ocp-catalog/ocp-schema),
  39. [`registration-schema`](https://www.npmjs.com/package/@ocp-catalog/registration-schema),
  40. [`ocp-activity-schema`](https://www.npmjs.com/package/@ocp-catalog/ocp-activity-schema),
  41. [`ocp-client`](https://www.npmjs.com/package/@ocp-catalog/ocp-client),
  42. [`shared`](https://www.npmjs.com/package/@ocp-catalog/shared),
  43. [`webmcp-adapter`](https://www.npmjs.com/package/@ocp-catalog/webmcp-adapter),
  44. [`ocp-cli`](https://www.npmjs.com/package/@ocp-catalog/ocp-cli).
  45. ## Install the agent skill
  46. The skill teaches an agent the OCP workflow — discover a Registration node,
  47. inspect a Catalog manifest, query with a declared query pack, resolve an entry —
  48. and drives it through the `ocp` CLI. There are two ways to install it, from the
  49. same source (`skills/ocp-catalog/`):
  50. **One command, any agent:**
  51. ```bash
  52. npx @ocp-catalog/skill # auto-detect
  53. npx @ocp-catalog/skill --agent claude # ~/.claude/skills
  54. npx @ocp-catalog/skill --agent all # Claude Code + Codex + .agents
  55. npx @ocp-catalog/skill --scope project # ./.claude/skills in the current repo
  56. npx @ocp-catalog/skill doctor # where is it installed?
  57. ```
  58. It refuses to overwrite a skill it didn't install unless you pass `--force`, and
  59. `--dry-run` prints the plan without touching disk.
  60. **As a Claude Code plugin:**
  61. ```
  62. /plugin marketplace add Open-Commerce-Protocol/OCP-Catalog
  63. /plugin install ocp-catalog@ocp-catalog
  64. ```
  65. If you already use the CLI, `ocp skill install` does the same thing.
  66. ## Reference applications
  67. The production-grade catalog nodes, provider apps, admin UIs, the MCP server,
  68. the skill gateway, demos, and deploy tooling live in a separate repo:
  69. **[Open-Commerce-Protocol/ocp-catalog-instances](https://github.com/Open-Commerce-Protocol/ocp-catalog-instances)**
  70. It depends on the protocol packages above from npm.
  71. > The full pre-split monorepo history (all applications) is preserved on the
  72. > [`legacy-monorepo`](https://github.com/Open-Commerce-Protocol/OCP-Catalog/tree/legacy-monorepo)
  73. > branch and the `pre-split-monorepo` tag.
  74. ## A minimal Catalog Node
  75. A spec-valid Catalog Node answers five endpoints. See
  76. [`examples/`](./examples) for complete implementations in TypeScript, Python, and Go.
  77. | Method | Path | Returns |
  78. |---|---|---|
  79. | GET | `/.well-known/ocp-catalog` | discovery |
  80. | GET | `/ocp/manifest` | capabilities + query packs |
  81. | GET | `/ocp/health` | liveness |
  82. | POST | `/ocp/query` | search entries |
  83. | POST | `/ocp/resolve` | resolve an entry into action bindings |
  84. ## Develop
  85. ```bash
  86. bun install
  87. bun run typecheck
  88. bun test
  89. bun run build # build the packages + site
  90. bun run site:dev # run the protocol website
  91. bun run skill:sync # regenerate the skill copies after editing skills/
  92. bun run skill:check # fail if a generated skill copy has drifted
  93. ```
  94. Requires Bun 1.3+. The minimal examples each have their own README under
  95. [`examples/`](./examples).
  96. `skills/ocp-catalog/` is the single source of truth for the skill. The npm
  97. payload and the Claude Code plugin copy are both generated from it by
  98. `scripts/sync-skill-copies.ts` — edit the source, then run `skill:sync`.
  99. ## Documentation
  100. - [Registration v1 spec](./docs/specs/registration/v1.md)
  101. - [Handshake v1 spec](./docs/specs/handshake/v1.md)
  102. - [docs/README.md](./docs/README.md)
  103. ## Contributing and security
  104. - See [CONTRIBUTING.md](./CONTRIBUTING.md) before opening an issue or pull request.
  105. - Report vulnerabilities privately as described in [SECURITY.md](./SECURITY.md). Do not publicly disclose unresolved security issues.
  106. ## License
  107. MIT — see [LICENSE](./LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.