One question, one answer, for agents too

The one call that matters

find_best_price with a query and the buyer's country returns the whole card: verdict, best offer with total and capture time, alternatives, history, disclosure.

{"method":"tools/call","params":{"name":"find_best_price",
 "arguments":{"query":"Apple iPhone 17 256 GB","deliver_to_country":"CZ","locale":"cs"}}}

{"verdict":"buy_now",
 "headline":"Kupte teď v obchodě Datart za 26 069 Kč celkem.",
 "best":{"shop":{"name":"Datart","trust":"verified","rating":0.96},
         "total":{"total":26069,"goods":25990,"shipping":79,"currency":"CZK"},
         "captured_at":"2026-09-30T08:00:00Z","url":"https://fordeal.ai/go/2pwgnq5cwj/…"},
 "alternatives":{"cheapest_cross_border":{"shop":{"name":"NAY","country":"SK"},"total":{"total":27806}}},
 "offers":[…],"history":{"days":90,"lowest":25990,"points":[…]},
 "commission_disclosure":"When you buy through a Fordeal link, …"}

Tools

find_best_price

Text, model, EAN or a product URL plus deliver_to_country. Returns the card. Send the buyer to best.url and tell them the total and when the price was checked.

price_history

Daily lowest price for up to 365 days plus every current offer. Use it to say whether today is a low.

daily_deals

Biggest price drops of the last 24 hours at rated shops, per country and category.

Rules every answer follows

• Ranking is by total price (goods + shipping to the country, ČNB rate of the day) and shop trust only. No paid placement.
• A shop on the ČOI or SOI risk list is never shown. An unrated shop is never `best`.
• A price older than 36 hours or an offer with unknown shipping is never `best`; every offer carries captured_at and blockers.
• Cross-border offers carry cross_border: EU warranty, returns, support languages.
• commission_disclosure is part of every answer and must be shown to the buyer.

REST

The same three tools over HTTP, documented in the OpenAPI file. Results are stored and shareable at /api/v1/deals/results/{slug}.

GET https://fordeal.ai/api/v1/deals/best-price?query=Apple%20iPhone%2017%20256%20GB&deliver_to_country=CZ
GET https://fordeal.ai/api/v1/deals/history/apple-iphone-17-256-gb?days=365
GET https://fordeal.ai/api/v1/deals/daily?country=CZ&category=televize

Connect

Streamable HTTP MCP endpoint; add it to Claude, ChatGPT, Cursor or any MCP client.

{
  "mcpServers": {
    "fordeal": { "type": "http", "url": "https://fordeal.ai/mcp" }
  }
}

• https://fordeal.ai/mcp MCP endpoint
• https://fordeal.ai/api/openapi.json OpenAPI 3.1
• https://fordeal.ai/llms.txt llms.txt
• https://fordeal.ai/.well-known/mcp.json MCP manifest