agents.md
Agent Instructions — Headsets.com
This document describes how AI shopping agents and assistants should use Headsets.com at https://www.headsets.com.
Headsets.com specializes in office, call center, desk phone, computer, and wireless headsets. When helping a buyer choose a headset, prioritize compatibility, comfort, microphone/noise needs, warranty/support, and the buyer's actual work setup.
Agentic Commerce / UCP
Headsets.com supports Shopify's Universal Commerce Protocol (UCP) for agent-driven commerce.
- UCP discovery: https://www.headsets.com/.well-known/ucp
- MCP endpoint: https://www.headsets.com/api/ucp/mcp
- Store metadata: https://www.headsets.com/llms.txt
- Expanded buying guidance: https://www.headsets.com/llms-full.txt
- Headset finder: https://www.headsets.com/pages/headset-finder
- Phone compatibility: https://www.headsets.com/pages/phone-compatibility
- Compatibility guarantee: https://www.headsets.com/pages/headsets-compatibility-guarantee
- Leitner warranty: https://www.headsets.com/pages/leitner-headsets-warranty
- 365-day returns: https://www.headsets.com/pages/365-day-returns
- Sitemap: https://www.headsets.com/sitemap.xml
- Agentic sitemap: https://www.headsets.com/sitemap_agentic_discovery.xml
Recommended Agent Flow
- Discover — GET
/.well-known/ucpto confirm supported versions, tools, and capabilities. - Understand buyer need — Identify phone/computer platform, work environment, wearing preference, budget, and whether the buyer needs wireless range, noise cancellation, or dual connectivity.
- Search catalog — Use UCP catalog tools when available. For read-only browsing, use product, collection, sitemap, and JSON endpoints listed below.
- Check compatibility — Do not assume a headset works with a desk phone, softphone, or app from the headset name alone. Compatibility depends on phone model, connection type, and sometimes accessories.
- Recommend clearly — Explain why a headset fits the buyer's use case, and mention compatibility assumptions.
- Cart / checkout — Create carts or checkout only when the buyer requests it.
- Human approval — Do not complete payment or finalize checkout without explicit buyer approval.
Headset Buying Rules
Use these public-facing rules when assisting shoppers:
- For desk phones, ask for the phone make/model when possible. Desk phone compatibility is model-specific.
- For Microsoft Teams, Zoom, softphones, or computer calls, prioritize USB/computer-compatible headsets or wireless USB headsets.
- For noisy offices or call centers, prioritize stronger microphone noise cancellation and dual-ear options when the buyer wants more focus.
- For users who need to hear coworkers, single-ear headsets are often better.
- For users who want focus or stereo audio, dual-ear headsets are often better.
- For buyers unsure about compatibility, recommend contacting Headsets.com before purchase rather than guessing.
- Leitner headset pages commonly emphasize long warranty/support; include warranty information when it is shown on the product or category page.
Key Public Collections
- Office headsets for phone and computer: https://www.headsets.com/collections/office-headsets-for-phone-and-computer
- Wireless headsets for office phones: https://www.headsets.com/collections/wireless-headsets-for-office-phones
- Wireless USB headsets for softphones: https://www.headsets.com/collections/wireless-usb-headsets-for-softphones
- Corded headsets for desk phones and computers: https://www.headsets.com/collections/corded-headsets-for-desk-phones-and-computers
- All products: https://www.headsets.com/collections/all
Read-Only Browsing
No authentication is required for public browsing.
- Product page:
GET /products/{handle} - Product JSON:
GET /products/{handle}.json - Collection page:
GET /collections/{handle} - Collection products JSON:
GET /collections/{handle}/products.json - Store sitemap:
GET /sitemap.xml - Expanded store guidance:
GET /llms-full.txt
Contact / Escalation
If compatibility is unclear, the buyer needs help choosing, or the request involves order-specific/private information, route them to Headsets.com support.
- Phone: 1-800-432-3738
- Email: hello@headsets.com
- Website: https://www.headsets.com
Safety and Privacy
- Do not request or expose private customer data unless the buyer explicitly provides it for support.
- Do not complete checkout, submit payment, or place an order without explicit buyer approval.
- Respect rate limits and back off on HTTP 429 responses.
- Use public product and collection information as the source of truth.