# Fordeal

> Marketplace for services, online consultations, goods and work in Czechia and Slovakia, ordered by people and by AI agents. Providers work through WhatsApp, customers pay into escrow, and Fordeal takes 8 % from the provider only after a job is finished and paid.

Everything a person can do on the website an agent can do over the public MCP server or the REST API. Every response carries an id, a status, a price with a currency, times in ISO 8601 UTC and a next_actions list.

## For agents

- [Agent documentation](https://fordeal.ai/en/agents): tool list, example calls and copy-paste configs
- [MCP server](https://fordeal.ai/mcp): Streamable HTTP, Authorization: Bearer <key>
- [REST API](https://fordeal.ai/api/v1): same capabilities over HTTP
- [OpenAPI 3.1](https://fordeal.ai/api/openapi.json): machine-readable API description
- [MCP manifest](https://fordeal.ai/.well-known/mcp.json): server capabilities and tool names
- [Agent manifest](https://fordeal.ai/.well-known/agent.json): who operates the service and how to reach it
- [Sandbox](https://fordeal.ai/en/agents#sandbox): an fd_test_ key runs the whole flow against simulated providers with fake money, an fd_live_ key does it for real

## Tools

- `search_providers` — GET /api/v1/providers?address=&category=
- `estimate_price` — POST /api/v1/price-estimate
- `create_job` — POST /api/v1/jobs
- `request_anything` — POST /api/v1/requests
- `list_open_requests` — GET /api/v1/requests/open?address=&radius_km=
- `get_offers` — GET /api/v1/jobs/{job_id}/offers
- `accept_offer` — POST /api/v1/jobs/{job_id}/accept
- `get_status` — GET /api/v1/jobs/{job_id}
- `confirm_done` — POST /api/v1/jobs/{job_id}/confirm
- `create_task` — POST /api/v1/tasks
- `post_job` — POST /api/v1/job-postings
- `list_categories` — GET /api/v1/categories?locale=en
- `explain_medical_report` — POST /api/v1/medical/explain
- `search_consultants` — POST /api/v1/search_consultants
- `book_consultation` — POST /api/v1/consultations
- `get_consultation_link` — GET /api/v1/consultations/{job_id}/link
- `search_tutors` — GET /api/v1/tutors?subject=&level=&mode=
- `book_lesson` — POST /api/v1/lessons
- `buy_lesson_package` — POST /api/v1/lesson-packages
- `get_lesson_package` — GET /api/v1/lesson-packages/{package_id}
- `search_items` — POST /api/v1/search_items
- `buy_item` — POST /api/v1/items/{item_id}/buy
- `make_offer` — POST /api/v1/items/{item_id}/offers
- `list_item` — POST /api/v1/items
- `accept_item_offer` — POST /api/v1/items/{item_id}/offers/{offer_id}/accept
- `book_service` — POST /api/v1/bookings
- `cancel_job` — POST /api/v1/jobs/:id/cancel
- `leave_review` — POST /api/v1/jobs/:id/review
- `get_item_status` — GET /api/v1/items/:id
- `update_item` — PATCH /api/v1/items/:id
- `mark_item_shipped` — POST /api/v1/items/:id/shipped
- `confirm_item_received` — POST /api/v1/items/:id/confirm-received

## Key pages

- [Services](https://fordeal.ai/en/sluzby): 60 service categories across 15 cities, with a price from for each
- [Consultations](https://fordeal.ai/en/konzultace): 21 specialties, online, 15/30/60 minute slots
- [Goods](https://fordeal.ai/en/zbozi): 12 categories, escrow payment
- [Work](https://fordeal.ai/en/prace): temp, seasonal and full-time positions
- [Open requests](https://fordeal.ai/en/poptavky): free-form requests no category fits, open to every verified provider nearby (GET /api/v1/requests/open)
- [For providers](https://fordeal.ai/en/pro-poskytovatele): how providers join and what they pay
- [For parents](https://fordeal.ai/en/pro-poskytovatele/rodic): providers aged 15-18 through a guardian: rules per country, the guardian endpoints, whether the mode is on
- [Trust](https://fordeal.ai/en/duvera): verification, escrow and disputes
- [Terms](https://fordeal.ai/en/pravni/obchodni-podminky): terms and conditions (draft)
- [Privacy](https://fordeal.ai/en/pravni/ochrana-osobnich-udaju): GDPR privacy policy (draft)

## Optional

- [llms-full.txt](https://fordeal.ai/llms-full.txt): the whole catalogue: every category, city and page URL
- [Sitemap](https://fordeal.ai/sitemap.xml): all pages in en, cs, sk, de, pl, es, fr