# 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 /.well-known/agent.json
- GET /.well-known/ai-plugin.json
- GET /.well-known/openapi.json
- GET /openapi.json
- GET /mcp
- GET /pricing.json
- GET /billing
- GET /developers
- POST /billing/checkout
- GET /billing/balance
- GET /affiliate-disclosure.json
- GET /about
- GET /methodology
- GET /guides
- GET /guides/amazon-printer-supplies
- GET /privacy
- GET /terms
- GET /disclosure

Operations:
- GET /status
- GET /health

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 successful call, returns neutral non-affiliate buying options, and requires a Product Resolver API key with available credits.

Billing:
- Buy neutral credits at /billing or POST /billing/checkout with pack_id starter_500, builder_2000, or operator_10000.
- Check remaining credits with GET /billing/balance using Authorization: Bearer <key> or x-api-key.
- Do not put API keys in public logs, prompts, or URLs unless no header channel is available.

Current beta limitations:
- Compatibility data is seeded locally.
- Live price and inventory checks are not connected yet.
- Affiliate-supported mode may return disclosed Amazon Associates or 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.