AtoC Korea — AI Agent Channel

An open, machine-readable channel for AI assistants to discover Korea private & small-group tours, fetch deterministic prices, and complete a booking on the traveller's behalf — up to the payment step. Agents never charge cards; the traveller confirms and pays at our hosted checkout.

Start here

OpenAPI 3.1 contract: /api/agent/openapi.json
llms.txt: /llms.txt
Tour catalogue (JSON): /api/agent/v1/tours
MCP server (Streamable HTTP): https://www.atockorea.com/api/agent/mcp

MCP (for assistants that speak it)

Connect an MCP client to /api/agent/mcp (Model Context Protocol over Streamable HTTP). Tools: search_tours, get_tour, check_availability, quote_price, and create_booking. Same guarantees as the REST channel — signed prices, and create_booking returns a hosted checkout URL the traveller pays. No card is charged by the agent.

The flow

Discover — GET /api/agent/v1/tours?region=jeju&search=unesco returns the catalogue. One tour: GET /api/agent/v1/tours/{slug}.
Check availability (optional) — GET /api/agent/v1/tours/{slug}/availability?date=YYYY-MM-DD for a best-effort open/sold-out read before quoting.
Quote — POST /api/agent/v1/quote with { slug, date, guests }. You get a price and a quote_token (HMAC-signed, valid 15 min). Prices are server-authoritative and deterministic — you cannot invent them.
Book — POST /api/agent/v1/book with { quote_token, contact? }. You receive a checkout_url. Hand it to the traveller; they review and pay on our hosted checkout.

Trust guarantees

No card is ever charged by an agent — payment is human-confirmed.
Prices are deterministic and signed; the booking step rejects altered or expired quotes.
Out-of-scope requests fail loudly (e.g. party too large) with a contact path, never a silent wrong booking.
Read and quote endpoints need no auth or API key. CORS-open for browser-based agents.

Questions or want a higher rate limit / API key tier? contact@atockorea.com