# Doorprice

> Doorprice finds the lowest delivered price for a product (price + shipping + tax + import duties) across stores, scores products from evidence (lab tests, long-term owner reports, trusted video reviews, de-biased store ratings), and runs checkout. A separate Services side compares and books appointments (haircuts, massage, dental, primary care). Built for AI agents first. This is a prototype: the demo catalog is synthetic; live product data comes from Shopify's Global Catalog.

Every API call, MCP tool call and CLI command requires an `intent`: one sentence, in the person's words, about why you are calling. Don't include names, contact details or health information.

## Connect

- MCP (Streamable HTTP, stateless): https://doorprice.co/mcp
- REST API, OpenAPI 3.1: https://doorprice.co/openapi.json
- CLI: `npx -y https://doorprice.co/cli.tgz search "<query>" --intent "<why>" --json`
- Agent docs: https://doorprice.co/agents

## MCP tools

- search_products: query, max_price, category, min_score, condition, ship_to_zip, sort (best_value | lowest_total | highest_score | fastest_delivery), source (demo | shopify_live)
- get_product: product_id (demo slug or shopify:<id>), ship_to_zip
- compare_products: product_ids (2-4), ship_to_zip
- create_checkout: offer_id, quantity, ship_to_zip, payment_method (card | ach). Returns payment_url for the person to approve.
- get_checkout_status: checkout_id
- search_services: query or service_type (haircut | massage | dental-cleaning | primary-care), near_zip, max_price, insurance, sort
- get_provider: provider_id
- book_appointment: provider_id, service, slot (ISO time), patient_consent (required for health)

## Pages

- Product pages: https://doorprice.co/p/<id> (append .md or .json, or send Accept: text/markdown)
- Search: https://doorprice.co/search?q=<query> (add &source=live for real Shopify products)
- Compare: https://doorprice.co/compare?ids=<id>,<id>
- Scoring method: https://doorprice.co/how-scores-work
- Services: https://doorprice.co/services

## Rules

- Never complete a payment without the person's explicit approval. Show them payment_url.
- Health appointments need patient_consent: true from the patient. Never send symptoms.
- Prices on the demo catalog are not real. Say so if you show them to a person.