Purveyors docs
Documentation
Product context, catalog methodology, CLI workflows, and AI agent setup live here. The API reference is generated from the Parchment API's OpenAPI contract and served from api.purveyors.io/docs, so it always matches the deployed API.
For AI agents
Set up your agent
Paste this into Claude Code, Codex, Cursor, or any agent that can run commands. It installs the Purveyors CLI, asks you to approve sign-in in your browser, and adds the Purveyors skill.
Read https://purveyors.io/docs/agents/setup.md and follow it to install the Purveyors CLI, sign me in, and install the Purveyors skill.Agents that cannot run commands, such as Claude Desktop and ChatGPT, cannot complete this setup yet. Read the setup steps.
API docs
Generated OpenAPI/Scalar reference for the deployed Parchment API.
Live Scalar docs generated from the deployed Parchment API contract.
Catalog methodology
Buyer-facing methodology for Purveyor Score, metadata quality, and catalog trust signals.
CLI docs
Install, authenticate, and use the Purveyors CLI for catalog queries, inventory, roasting, scripting, and agent automation.
- Overview
Install, authenticate, and explore the CLI command structure.
- Auth, config, and output
Sign-in, roles, settings, output modes, exit codes, and IDs.
- Catalog commands
Search, rank, and compare green coffees and suppliers.
- Inventory commands
List and manage your green coffee inventory.
- Roast commands
Record roasts, import and download Artisan files, and watch folders.
- Roast batch commands
List, open, rename, and delete roast batches by ID.
- Sales commands
Record and update roasted-coffee sales.
- Tasting commands
Read supplier notes and record your own cupping scores.
- Agent skill commands
Print or install the Purveyors skill for AI agents.
- Market commands
Value signals, price movement, trends, and evidence.
- Price index commands
Price snapshots, 30-day comparisons, and chart history.
- Procurement commands
Read saved sourcing briefs and their catalog matches.
- Reference profile commands
Compare, plan from, export, and download saved references.
- Context and manifest
Readable reference text and the machine-readable command contract.
- Agent integration
Give AI agents reliable access to your coffee data through the CLI.
Agent setup
Connect an AI agent to your Purveyors account: install the CLI, approve sign-in in your browser, and add the Purveyors skill.
Live OpenAPI reference served by the Parchment API.
Generate API keys, monitor usage, and manage your account.
Browse the green coffee marketplace that the API serves.
Market intelligence: pricing trends, supplier coverage, and origin analysis.
Crawler identity, request behavior, data use, and opt-out instructions for website operators.