Разработчици
Всеки публикуван бизнес е MCP сървър
Streamable HTTP с JSON-RPC 2.0. Цялата техническа информация на едно място.
Бърз старт
Добавете бизнес към Claude Code с една команда. Заменете slug с адреса на бизнеса. Примерният магазин е публичен и само за четене.
claude mcp add --transport http zoomag https://storefront.fleetq.net/mcp/zoomag
Адреси
| Адрес | Какво връща |
|---|---|
| POST /mcp/{slug} | MCP сървър на един бизнес; инструментите зависят от вида му |
| POST /mcp | Директория с find_business; връща mcp_url на подходящите бизнеси. search_products без business търси във всички магазини |
| GET /.well-known/mcp/directory.json | Директорията като JSON |
| GET /b/{slug}/llms.txt | Профилът като текст за хора и агенти |
Чернова или спрян бизнес връща 404.
Свързване
{
"mcpServers": {
"zoomag": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://storefront.fleetq.net/mcp/zoomag"
]
}
}
}
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
const client = new Client({ name: "my-agent", version: "1.0.0" });
await client.connect(new StreamableHTTPClientTransport(new URL("https://storefront.fleetq.net/mcp/zoomag")));
const res = await client.callTool({
name: "search_products",
arguments: { query: "храна за куче", max_price: 35, limit: 5 },
});
Примерите за външни клиенти не са проверени срещу всяка тяхна версия.
Инструменти по вид бизнес
| Вид | Четене | Заявки |
|---|---|---|
| Всички | get_info get_policies get_request_status |
accept_counter_offer reject_counter_offer cancel_request |
| Магазин | search_products get_product |
create_order |
| Ресторант | get_menu |
book_table create_food_order |
| Места и събития | get_menu |
book_table create_food_order |
| Услуги | get_services get_availability get_schedule |
book_appointment book_class request_rental request_quote |
| Транспорт | find_station search_trips |
|
| Здраве | get_services get_availability |
book_visit |
| Настаняване | get_rooms check_stay |
request_stay |
| Имоти и превозни средства | search_listings get_listing |
request_viewing |
| Събития | list_events get_event |
|
| Директория | find_business |
няма |
Бизнес, който не е поет от собственика, е само за четене: инструментите за заявки връщат грешка unsupported, а агентът изпраща клиента към source_url.
Магазин с жив каталог добавя get_categories; при него search_products и get_product четат магазина в момента на повикването.
Описанията на инструментите са на английски, защото ги четат агентите. Пълна справка с всички аргументи
Заявки с потвърждение
Заявката не е резервация или поръчка, докато собственикът не я потвърди. Агентът проверява състоянието с get_request_status.
pending_confirmation confirmed / counter_offered / declined / expired / cancelled
{
"jsonrpc": "2.0",
"id": 7,
"method": "tools/call",
"params": {
"name": "book_table",
"arguments": {
"date": "2026-10-16",
"time": "19:30",
"party_size": 4,
"name": "Мария"
}
}
}
{
"request_id": "rq_example",
"kind": "booking",
"status": "pending_confirmation",
"expected_response": "PT15M",
"next_actions": [
"get_request_status",
"cancel_request"
]
}
Пълният списък със състояния и причини е в справката.
Данни и свежест
- Всеки успешен отговор носи source_url и last_verified.
- За магазин с жив каталог get_product чете магазина в момента на повикването; ако сайтът не отговаря, връща последното копие с stale: true.
- За бизнес със запазен каталог get_product връща откъс-доказателство от страницата.
- Търсенията могат да идват от кеш до 1 час, а last_verified казва кога магазинът е бил прочетен.
- Цените са в евро; наличността е последното проверено състояние.
- Всички инструменти за четене са с readOnlyHint: true.
- Текст, написан от модел, носи generated_by.
Сесии, лимити, грешки
-
Сесия
initialize връща заглавие mcp-session-id; изпращайте го с всяка следваща заявка. Методи: POST, DELETE; GET връща 405.
-
Лимит
Заглавия x-ratelimit-limit и x-ratelimit-remaining.
-
Кодиране
UTF-8. Невалиден JSON (например повредена кирилица) връща -32700 Parse error.
Планове и лимити
Платените планове започват от 99 € на месец и се таксуват според повикванията; операция със запис се брои за 5 повиквания. По време на бета версията всичко е безплатно и лимитите не се прилагат.
Започнете още днес при условията на Sandbox: ползвайте адреса по-горе. API ключ не е нужен.