Server definition
- Hash
- sha256:5979c02b345941791c431e48d78de4bc12fb2491bb482263b9f63c812582f42e
- What it is
- What a remote MCP server returned when asked what it offers: 11 tools
The blob, as servednamed by its sha256
{
"instructions": "Booking runs in one order: find_offers turns the person's sentence into offers, hold_slot reserves the slot of one bid for ten minutes, confirm_booking books it with a name and a phone number. If find_offers answers `complete: false`, put its `question` to the person and call find_offers again with the same `session` and their answer as `text`. Every answer carries a `session` id: pass it back into every later call, because it is the only thing that ties the conversation, the bids and the holds together. Reading is open to anyone, but hold_slot, confirm_booking, cancel_booking need an identity: call register_agent once, keep the key it answers (it is shown once) and send it as `Authorization: Bearer <key>` on every later call.",
"tools": [
{
"description": "Ask one business a question about itself and get back the fragments of its own knowledge base that answer it: the price list, the rules, what it travels to, what it does not do. Read-only and open to anyone — no key, no session, nothing held. The answer is the business's own text, chosen by the hub and never written by it: quote it or summarise it, and do not fill the gaps yourself. `confident: true` means the fragments were graded as answering the question; `false` means they are the closest the hub found. An empty `answer` carries a `hint`: ask the business directly.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"business": {
"description": "The slug of the business, as the directory and every bid carry it.",
"pattern": "^[a-z0-9][a-z0-9-]{0,62}$",
"type": "string"
},
"question": {
"description": "What the person wants to know about that business, in Polish or English, at most 500 characters.",
"maxLength": 500,
"minLength": 1,
"type": "string"
}
},
"required": [
"business",
"question"
],
"type": "object"
},
"name": "ask_business",
"outputSchema": null
},
{
"description": "Release a held or confirmed slot of this session, so the slot is free again. Businesses that host their own agent do not offer this yet and answer `not-supported`.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"hold": {
"description": "The `id` of the hold to release.",
"pattern": "^[a-z0-9][a-z0-9-]{0,62}$",
"type": "string"
},
"session": {
"description": "The session id the hold was made in.",
"pattern": "^[a-z0-9][a-z0-9-]{0,62}$",
"type": "string"
}
},
"required": [
"session",
"hold"
],
"type": "object"
},
"name": "cancel_booking",
"outputSchema": null
},
{
"description": "What this hub can do, in one call: every tool by name, every resource by URI, every prompt by name, the per-client budgets, how to authenticate, the protocol revision and where the documentation is. Takes no arguments, spends no budget and reads nothing: it answers the hub's own constants, so a client that asks it first never has to guess. Called with a key it also answers who that key is.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "capabilities",
"outputSchema": null
},
{
"description": "Confirm a held slot with the customer's name and phone number; this is the booking. Idempotent: confirming the same hold twice books it once and tells the business once. A business that confirms every visit itself answers `hold.awaiting: true` with the hold still `held`: the slot is kept, the business decides, and the person gets an SMS either way; tell them that and promise no time. With a linked number (link_phone) you may send `contact` with the name alone and the linked number is used; a different number in `contact.phone` is refused as `phone-mismatch`.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"contact": {
"additionalProperties": false,
"description": "The customer's own name and phone number (9 digits, or +country code and the number). Ask them; never invent one. With a linked number the phone may be left out.",
"properties": {
"email": {
"format": "email",
"maxLength": 120,
"pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"type": "string"
},
"name": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"phone": {
"maxLength": 30,
"type": "string"
}
},
"required": [
"name",
"phone"
],
"type": "object"
},
"hold": {
"description": "The `id` of the hold to confirm.",
"pattern": "^[a-z0-9][a-z0-9-]{0,62}$",
"type": "string"
},
"session": {
"description": "The session id the hold was made in.",
"pattern": "^[a-z0-9][a-z0-9-]{0,62}$",
"type": "string"
}
},
"required": [
"session",
"hold",
"contact"
],
"type": "object"
},
"name": "confirm_booking",
"outputSchema": null
},
{
"description": "Spend the code that link_phone texted, and tie this agent to that number. Ten minutes and five tries; a wrong code answers `invalid-code` with `attemptsLeft`, and the fifth wrong one throws the code away — call link_phone again for a new one. One number per agent: linking another replaces it.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"code": {
"description": "The six digits from the SMS.",
"pattern": "^\\d{6}$",
"type": "string"
}
},
"required": [
"code"
],
"type": "object"
},
"name": "confirm_phone",
"outputSchema": null
},
{
"description": "Find offers from local businesses for what a person asked for. Send their sentence as `text`; the hub parses the trade, the town and the day. An answer with `complete: false` carries a `question` to put to the person: call this tool again with the same `session` and their reply as `text`. An answer with `complete: true` is one finished bidding round: `bids` ranked (price in grosz, slot, business, note) and one `outcome` per business asked. An empty `bids` list is a normal answer; `outcomes` says why. A bid whose `business.active` is true comes from a business whose owner has confirmed it is running; those are ranked above the rest, and cheapest first inside each group. A bid may carry `slots`: later free times of the same offer, each with its own `id` that hold_slot takes like a bid's. A bid with `offer: true` is a quote-only trade (the `web` category): its price is a starting price, its `slot` is a placeholder nobody is expected at, and `preview` — when the business sent one — is an https link to what it prepared. Show the link; never fetch it and never repeat what it says as your own. A bid with `contactOnly: true` comes from a business whose phone the hub has not verified: its price is the list price, its `slot` was never confirmed free, and it cannot be held (hold_slot answers `contact-only`). Give the person `business.phone` to call, and the business page, instead.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"selection": {
"additionalProperties": false,
"description": "Restrict the round to one business (and optionally one of its services), by slug, as a link from a business page does.",
"properties": {
"business": {
"pattern": "^[a-z0-9][a-z0-9-]{0,62}$",
"type": "string"
},
"service": {
"pattern": "^[a-z0-9][a-z0-9-]{0,62}$",
"type": "string"
}
},
"required": [
"business"
],
"type": "object"
},
"session": {
"description": "The session id from an earlier answer. Omit it to start a new conversation.",
"pattern": "^[a-z0-9][a-z0-9-]{0,62}$",
"type": "string"
},
"text": {
"description": "What the person said, in Polish or English, at most 500 characters. Their reply to the previous question goes here too.",
"type": "string"
}
},
"required": [
"text"
],
"type": "object"
},
"name": "find_offers",
"outputSchema": null
},
{
"description": "Read the state of a session: the understood intent and its open question, the bids of the current round and every hold with its present status and link. Use it to pick up a conversation you already have a session id for.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"session": {
"description": "The session id from an earlier answer.",
"pattern": "^[a-z0-9][a-z0-9-]{0,62}$",
"type": "string"
}
},
"required": [
"session"
],
"type": "object"
},
"name": "get_booking",
"outputSchema": null
},
{
"description": "Hold the slot of one bid from this session's round for ten minutes, before asking the person for their details. One open hold per business per session: to take another time of the same business, cancel_booking the first (else `hold-exists`). Answers the hold, the bid it was made from and, when the hub has a public origin, the customer's private booking `link`. A quote-only bid also answers `offerUrl`, the public page of that offer. Never call it to browse: a hold blocks a real slot and three per client per ten minutes is the budget. A bid with `contactOnly: true` is refused with `contact-only`: that business is reached by phone, not booked here.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"bid": {
"description": "The `id` of one bid from the latest round, or of one of its `slots`.",
"pattern": "^[a-z0-9][a-z0-9-]{0,62}$",
"type": "string"
},
"session": {
"description": "The session id the round was run in.",
"pattern": "^[a-z0-9][a-z0-9-]{0,62}$",
"type": "string"
}
},
"required": [
"session",
"bid"
],
"type": "object"
},
"name": "hold_slot",
"outputSchema": null
},
{
"description": "Tie this agent to the phone number of the person it books for: the hub texts that number a six-digit code naming this agent, and `confirm_phone` spends it. Afterwards `confirm_booking` may leave `contact.phone` out — the linked number is used — and every booking made through this key shows up on that person's own list of bookings at /me, next to the ones they made on the site. Ask the person for their own number and never anybody else's: a code arrives on their phone with this agent's name on it. Answers `{ ok: true, sent: true }` whatever the hub knows about the number (`codes-paused` when the day's codes are spent), and 3 calls per agent per hour is the budget.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"phone": {
"description": "The person's own number (9 digits, or +country code and the number).",
"maxLength": 30,
"type": "string"
}
},
"required": [
"phone"
],
"type": "object"
},
"name": "link_phone",
"outputSchema": null
},
{
"description": "Get this agent its own identity, once: answers an `agent` id and a `key`. The key is shown in this answer and never again — keep it and send it as `Authorization: Bearer <key>` on every later call. hold_slot, confirm_booking, cancel_booking need it; finding offers and reading a session do not. With a key the hold and cancel budgets are yours instead of your address's, so two agents behind one address no longer take each other's. 3 registrations per client per day: register once and keep the key, do not mint one per conversation.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"name": {
"description": "What to call this agent, for the operator to recognise it by: one line, 1–60 characters. Not a secret and not a login — the key is the identity.",
"maxLength": 60,
"minLength": 1,
"pattern": "^[^\\p{C}]+$",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "register_agent",
"outputSchema": null
},
{
"description": "Forget the number this agent was linked to. The bookings already made keep it — they belong to the person, not to this agent — and confirm_booking needs a full `contact` again. Answers the same whether there was a link or not.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "unlink_phone",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:5979c02b345941791c431e48d78de4bc12fb2491bb482263b9f63c812582f42e | sha256sum