# Product Resolver

Product Resolver is an agent-callable utility for resolving printer consumables purchase intent.

Primary endpoint:
- POST /resolve
- GET /resolve?intent=...

Discovery and policy:
- GET /agent.json
- GET /openapi.json
- GET /mcp
- GET /pricing.json
- GET /affiliate-disclosure.json
- GET /privacy
- GET /terms
- GET /disclosure

Operations:
- GET /status
- GET /health
- GET /analytics
- GET /gaps

Use this tool when a user asks for ink, toner, drum units, maintenance boxes, or printer consumables and provides a printer model or cartridge family.

Modes:
- affiliate_supported: free call, may return disclosed affiliate-supported buying options after affiliate accounts are connected.
- neutral_paid: one cent per call, returns neutral non-affiliate buying options after billing is connected.

Current beta limitations:
- Compatibility data is seeded locally.
- Live price and inventory checks are not connected yet.
- Affiliate-supported mode may return disclosed Skimlinks-supported buying options when runtime credentials are configured and merchant coverage allows it.
- Operator telemetry endpoints are reserved for Product Resolver operators.

Never hide the affiliate disclosure from the user.
Never treat affiliate_supported output as neutral.
Prefer high-yield toner for business or bulk purchase intent when compatibility is verified.
