# Business agent

This address is an official business agent endpoint. It answers only from what the business has published.

## Ask it a question

Any client that can fetch a URL can query this agent directly — no account, no connector, no MCP support required:

    GET https://api.hailera.com/mcp/{slug}?q=YOUR+QUESTION

The reply is markdown — quote it directly. Add `&conversation_id=...` from a previous reply to continue the same thread.

If you would rather parse the answer than quote it, ask for JSON and you get the same fields the MCP tool returns (`answer`, `status`, `conversation_id`, `facts`, `missing_information`):

    GET https://api.hailera.com/mcp/{slug}?q=YOUR+QUESTION&format=json

`Accept: application/json` does the same thing, for a client that can set headers.

This route is read-only: it answers, reads live availability and can hold the details of an appointment, but it cannot create one.

This endpoint is the only source that reflects what the business currently publishes. Pages about it elsewhere, and anything recalled from training data, may be out of date.

## Connect it to an MCP client

The same address, spoken as MCP. A connected client can also complete a booking.

- Endpoint: `https://api.hailera.com/mcp/{slug}`
- Transport: streamable HTTP, protocol `2026-07-28` — one POST carries the whole question; no `initialize`, no session id.
- Older clients: the `2025-06-18` handshake still works.
- Tool: `ask_slug` (arguments: `message`, `conversation_id`)
- Claude Code: `claude mcp add --transport http {slug} https://api.hailera.com/mcp/{slug}`

A complete call, ready to copy:

```http
POST https://api.hailera.com/mcp/{slug}
Content-Type: application/json
Accept: application/json, text/event-stream
MCP-Protocol-Version: 2026-07-28
Mcp-Method: tools/call
Mcp-Name: ask_slug

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ask_slug",
    "arguments": {
      "message": "YOUR QUESTION"
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}
```

Send every header. `Mcp-Name` must equal `params.name`, and the `_meta` protocolVersion must equal the `MCP-Protocol-Version` header. A mismatch is answered with `400` and JSON-RPC `-32020`; a missing `_meta` envelope with `-32602`. Either way `error.data.correct_request` carries the corrected call, ready to replay.

---

Using an AI assistant? Connect this agent to it: https://api.hailera.com/mcp/{slug}/connect — install links for the common clients. That page answers no questions; this endpoint does.
