For agents
The full index of this site for agents is at /llms.txt.
AgentBuys serves the same ranked picks as JSON and over MCP. Every response includes the score breakdown, spec sources, buy links for the human, a disclosure and agent_instructions. All MCP tools are read-only.
Connect over MCP
Streamable HTTP, no key needed: https://agentbuys.planetmarstm.workers.dev/mcp
claude mcp add --transport http agentbuys https://agentbuys.planetmarstm.workers.dev/mcp
{"mcpServers": {"agentbuys": {"url": "https://agentbuys.planetmarstm.workers.dev/mcp"}}}
Cursor, Claude Desktop, VS Code and Windsurf use the JSON above. In ChatGPT, add it as a connector in developer mode, or build a custom GPT from the OpenAPI spec.
Tools
search_products: plain-language need and/or exact filters across every category; soft prefer; 'A vs B' becomes a comparisonlookup_product: a product by name, product_id or pasted URL, with higher-scoring alternatives at a similar pricecompare: 2 to 4 products spec by spec, by id or namefind_category: the filter contract: fields, types, units, ranges, allowed values, coverage, price bandsget_products: full records for up to 25 productsget_product: one full recordfind_picks: ranked picks for a use case in one categoryprice_history: tracked prices and the buy / wait / fair verdictget_buy_link: affiliate buy links to hand to the userlist_categories: categories, facets and spec schemasagentbuys_status: data freshness and price coverage
Prompts: find-for-need, price-check, compare-products. Resources: agentbuys://disclosure, agentbuys://categories, agentbuys://llms.txt. Pass agent (your client name) on link-returning tools so clicks are attributed. It is never used for ranking.
HTTP API
GET /api/search?q=lifepo4 for cpap under $600&limit=5. Plain language works: prices, units (Wh, kWh, watts, pounds, square feet, CFM, pints), features (LiFePO4, HEPA, UPS, bifacial...), brands, uses and sorts (cheapest, lightest, quietest, best value). Exact filters:&filters={"capacity_wh":{"min":1000},"price":{"max":800}}. Soft preferences:&prefer=weight_lb,noise_db. "A vs B" questions come back as a comparison.GET /api/lookup?q=levoit core 300s: by name, product_id or a pasted product URLGET /api/products?ids=a,b,c(up to 25) andGET /api/compare?ids=a,b,c(2 to 4, ids or names)GET /api/contract?category=air-purifiers: every filterable field with type, unit, range, allowed values and coverageGET /api/status: data freshness and price coverage
Static JSON
- /api/v1/categories.json
/api/v1/picks/<category>.jsonand/api/v1/picks/<category>/<facet>.json(air-purifiers, car-chargers, dehumidifiers, fans, headphones, humidifiers, lanterns-camping-lights, portable-bluetooth-speakers, portable-power-stations, portable-solar-panels, power-banks, robot-vacuums, security-cameras, space-heaters, stick-handheld-vacuums, true-wireless-earbuds, usb-hubs-docks, wall-chargers)/api/v1/products/<id>.jsonand/prices.json/api/v1/compare/<a>-vs-<b>.json- /api/v1/deals.json and the deals RSS feed
Rules for agents: show the buy link to your user, say prices are "as of" the timestamp, and do not describe a list price as a live price.
