# Shelfprotocol

> robots.txt for commerce — the open directory AI agents query before they buy - Signal-All/shelfprotocol

- **Website:** https://github.com/Signal-All/shelfprotocol
- **Pricing:** paid
- **Categories:** Developer Tools, AI Agents
- **Tags:** developer-tools, ai-agents, writing-content
- **Platforms:** CLI
- **Last verified:** 2026-09-10
- **Canonical page:** https://linkrena.com/tools/shelfprotocol

## About

robots.txt for commerce. The open directory AI agents query before they buy.

Merchants publish a tiny shelf.json describing what they sell and what agents

are allowed to do. Agents make one lookup before transacting. Shelf Protocol is the

index in the middle — the handshake layer between agents and the commercial web.

Merchants publish to avoid being invisible to AI shoppers. FOMO, not a sales call.

Developers add one lookup because it's cheaper and safer than scraping. One line, spreads by copy-paste.

The index compounds : more merchants → agents prefer it → more developers depend on it → more merchants join.

The registry API (FastAPI + SQLite). Register, lookup, search, verify, stats.

The one-line lookup client a developer drops into an agent, plus the MCP server and the LangChain/CrewAI tool adapters. Pip-installable ( pyproject.toml at repo root).

A shopping agent that uses Shelf Protocol to decide what it's allowed to buy.

Test suites ( cd tests && for t in test_*.py; do python3 $t; done ).

buy autonomously (within the merchant's declared limit) or escalate to a human.

Note: SQLite stores its file next to server/db.py by default. If you run

POST /v1/merchants with a shelf.json body (see spec/shelf.json.example for the full schema):

## Related tools

- [Tako VM](https://linkrena.com/tools/tako-vm): Tako VM is a secure file system and Python execution layer for AI agents: gVisor-isolated Docker containers with job queues, workers, retries, and replay.
- [Ratify Agent Relay Harness](https://linkrena.com/tools/ratify-agent-relay-harness): Offline, one-command reproduction harness + adversarial annex for the Agent Relay x Ratify Phase 2 flagship.
- [Confdiff](https://linkrena.com/tools/confdiff): Semantic, format-aware diff for config & structured-data files (JSON, YAML, TOML, INI, .env, .properties, CSV, XML).
- [TDQS](https://linkrena.com/tools/tdqs): An open framework for scoring how well an MCP tool definition communicates to an AI agent.
- [Declick](https://linkrena.com/tools/declick): Compile an API, an MCP server, a database or a web page into a CLI your agent can run.
- [Webmcp React](https://linkrena.com/tools/webmcp-react): React hooks for exposing your app's functionality as WebMCP tools - transport-agnostic, SSR-safe, Strict Mode safe, W3C spec-aligned - agentcathq/webmcp-react