Към съдържанието
Agent Storefront

Разработчици

Всеки публикуван бизнес е MCP сървър

Streamable HTTP с JSON-RPC 2.0. Цялата техническа информация на едно място.

Бърз старт

Добавете бизнес към Claude Code с една команда. Заменете slug с адреса на бизнеса. Примерният магазин е публичен и само за четене.

bash
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.

Свързване

Claude Desktop · mcp-remote
{
    "mcpServers": {
        "zoomag": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://storefront.fleetq.net/mcp/zoomag"
            ]
        }
    }
}
TypeScript SDK
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

заявка · POST /mcp/dvora-bistro (демонстрационен бизнес)
{
    "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.

Пълна MCP справка в документацията

Планове и лимити

Платените планове започват от 99 € на месец и се таксуват според повикванията; операция със запис се брои за 5 повиквания. По време на бета версията всичко е безплатно и лимитите не се прилагат.

Започнете още днес при условията на Sandbox: ползвайте адреса по-горе. API ключ не е нужен.

Вижте цените

Ще настроим профила на вашия бизнес заедно.

Използваме само бисквитки, които са необходими, за да работи сайтът: сесия, защита на формите и вход. Няма анализи и реклама. Политика за бисквитки