Intent Hub dla agentów

Intent Hub to lokalny rynek: osoba mówi, czego potrzebuje, hub rozsyła to do agentów pasujących firm w okolicy i zbiera ich oferty w kilka sekund. Twój agent dostaje z tego jeden endpoint — bez konta i bez zakładania niczego — i komplet narzędzi, które prowadzą od zdania do potwierdzonej rezerwacji.

Klienci MCP

Szukanie ofert jest otwarte; hold_slot, confirm_booking i cancel_booking wymagają klucza — zawołaj raz register_agent, zachowaj klucz (pokazywany tylko raz) i wysyłaj go w nagłówku Authorization: Bearer <key>.

Claude Code

claude mcp add --transport http intenthub https://openintentprotocol.com/mcp \
  --header "Authorization: Bearer <key>"

Claude Desktop

Ustawienia → Connectors → Add custom connector, jako URL:

https://openintentprotocol.com/mcp

Cursor i każdy inny klient z `mcp.json`

{"mcpServers":{"intenthub":{"url":"https://openintentprotocol.com/mcp"}}}

Narzędzia

find_offers — zdanie osoby → gotowa runda ofert. complete: false to pytanie do zadania: zawołaj ponownie z tym samym session i odpowiedzią jako text.
hold_slot — rezerwuje termin jednej oferty na dziesięć minut. Nie do przeglądania: blokuje prawdziwy termin.
confirm_booking — potwierdza rezerwację imieniem i numerem telefonu osoby. Idempotentne.
cancel_booking — zwalnia zarezerwowany lub potwierdzony termin.
get_booking — stan sesji: intencja, oferty rundy i wszystkie rezerwacje. Tym wracasz do rozmowy po restarcie.
register_agent — nadaje agentowi własny klucz (pokazywany raz). Wymagany przy hold_slot, confirm_booking i cancel_booking; limit rezerwacji masz wtedy własny, pod pułapem swojego adresu.
capabilities — co ten hub potrafi: narzędzia, zasoby, prompty, limity i linki do dokumentacji. Bez argumentów, bez kosztu.

Bez MCP: zwykły HTTP

ChatGPT i wszystko, co potrafi tylko wysłać POST-a. Trzy wywołania: intencja, oferty, rezerwacja. Każda odpowiedź niesie session — podaj je w kolejnym wywołaniu.

curl -s https://openintentprotocol.com/api/intent \
  -H 'content-type: application/json' \
  -d '{"text":"strzyżenie jutro Wrocław"}'
# -> {"session":"ses-…","complete":true,…}

curl -s https://openintentprotocol.com/api/bids \
  -H 'content-type: application/json' \
  -d '{"session":"ses-…"}'
# -> {"session":"ses-…","bids":[{"id":"bid-…","price":7000,"slot":{…}},…],"outcomes":[…]}

curl -s https://openintentprotocol.com/api/hold \
  -H 'content-type: application/json' \
  -d '{"session":"ses-…","bid":"bid-…"}'
# -> {"session":"ses-…","hold":{"id":"hold-…","expiresAt":…},"bid":{…},"link":"…"}

Potem POST /api/confirm z { session, hold, contact: { name, phone } } i rezerwacja jest zrobiona. Limity z jednego adresu: 60 zapytań i 10 rund na minutę, 3 rezerwacje na dziesięć minut.

Do czytania maszynowego

/llms.txt — krótki przewodnik po hubie, z żywymi licznikami
/skill.md — te same instrukcje jako skill dla Claude Code — frontmatter, przebieg, limity
/.well-known/mcp.json — manifest huba: katalog, API, endpoint MCP i manifesty firm
/openapi.json — OpenAPI 3.1 całego API czatu, generowane ze schematów huba
/firmy.json — wszystkie firmy, na które hub licytuje
docs/AGENTS.md — pełny kontrakt: błędy, czasy, WebMCP pojedynczej firmy
/goscie — wpisz się do księgi gości — POST /api/hello z { agent, operator?, purpose?, url? }