このMCPでできること
Searches verified businesses, answers questions about their offerings, checks availability and pricing, supports orders, and enables asynchronous contact.
機能
ツール
17
ツール
ask_business
Ask one specific question about a listing and get an answer from the registry, with no human involved. Try this before contact_business: it is instant, free, and does not put a message in someone's inbox. Returns either an answer or an escalation. When `resolved` is true, `answer` holds it and `basis` names the fields it was read from. When `escalate` is true we do not hold the fact — this is NOT a negative answer, and in particular an unlisted place is "we do not know", never "they do not deliver there". Only the business can declare its own list complete. Unsupported questions come back with `refused` true and a `supported` list rather than a guess: nothing here is ever inferred, approximated or improvised. Authentication: none. This tool works with no credentials.
入力スキーマ
{'type': 'object', 'required': ['slug', 'kind', 'intent'], 'properties': {'kind': {'enum': ['entity', 'website'], 'type': 'string', 'description': 'The `kind` field from the same search result.'}, 'slug': {'type': 'string', 'description': 'The `slug` field from a search_businesses result.'}, 'intent': {'enum': ['is_open_now', 'delivers_to', 'lead_time'], 'type': 'string', 'description': 'Which question to ask. "is_open_now" needs nothing else; "delivers_to" needs a `params` place; "lead_time" asks the shortest notice they accept an order on.'}, 'params': {'type': 'object', 'description': 'Arguments for the question. For "delivers_to": { "place": "Botanica" }. Ignored by the others.'}}}
ask_business_freeform
Same answers as ask_business, but you send the person's own words instead of choosing an intent, and the reply comes back in the language they used. Supported languages: en, ro, ru, de; anything else is answered in English. Prefer ask_business when you already know which of the three questions you are asking — it is instant and costs nothing, whereas this one runs a model to read the question and is rate-limited accordingly. A model is used ONLY to decide which question was asked and in which language. It never sees the business's stored data and never writes the answer. Returns an `outcome` and a `reply` in the asker's language. Branch on `outcome`, not on the prose: "answered" carries `reply` and a structured `answer`; "needs_detail" means we need one more thing from the asker and `reply` requests it; "not_understood" means it was not one of our three questions, with `supported` listing them; "escalated" means a real question we do not hold the fact for — we forward that one to the business ourselves, and `escalation` carries the `ref` that reads their answer later with check_escalation. `handoff` still holds what was gathered, for contact_business. An escalation is never a negative answer. Authentication: none. This tool works with no credentials.
入力スキーマ
{'type': 'object', 'required': ['slug', 'kind', 'question'], 'properties': {'kind': {'enum': ['entity', 'website'], 'type': 'string', 'description': 'The `kind` field from the same search result.'}, 'slug': {'type': 'string', 'description': 'The `slug` field from a search_businesses result.'}, 'question': {'type': 'string', 'description': 'What the person actually asked, in their own words and their own language. Do not translate or rephrase it — the language of this text decides the language of the reply.'}, 'idempotency_key': {'type': 'string', 'description': 'Optional, and only matters when a question reaches a person. The same question about the same business within 24 hours attaches to the open one and does not notify them twice, which is right when you are RETRYING a failed call and wrong when it is a genuinely new problem worded the same way. Send the same key when retrying, a fresh one when it is a new ask. Omit it and the retry behaviour applies, which is the safe default for the business.'}}}
cancel_order
Cancel an order you placed with commit_order. Returns `settled`. True means it is cancelled, the business has been told and their day is free again. False comes with a `reason`: "inside-cancel-window" (later notice than they said they need), "no-cancel-window-set" (they never said), "order-passed", "not-open" (already cancelled or withdrawn) or "not-the-issuing-agent". Every reason but the last two puts the request in front of the business and returns an `escalation` to poll with check_escalation — a refusal here is a question being asked, not a dead end. Also returns `refund`, which is the business's OWN published terms at the notice given. tunnel settles no money and holds none: nothing has been paid or refunded, and only the business can act on it. Authentication: bearer token required, and it must be the same agent that placed the order. Anyone else holding the reference gets the request routed to the business instead.
入力スキーマ
{'type': 'object', 'required': ['ref'], 'properties': {'ref': {'type': 'string', 'description': 'The `ref` returned by commit_order. It is the only handle on this order.'}, 'note': {'type': 'string', 'description': "Optional. Why, in the buyer's own words. Recorded, shown to the business and carried into the question if a person has to decide. Never parsed, and it cannot change the answer."}}}
check_availability
Find out when a business is actually free. Worked out per call against their opening hours, their notice period, their blackout dates and what is already booked — there is no stored list of free times to be out of date. Returns `known` true with `days`, each holding `slots` that carry a start, an end and `free`. `firstFree` is the earliest one across the range. Pass `time` to ask about one exact moment instead of browsing. `known` false means this business has not set up a calendar and `reason` names the missing piece. That is "we cannot tell you", never "they are busy" — ask a person instead. A free slot is not a hold. Nothing is reserved until commit_order, and between the two calls someone else can take it. Authentication: none. This tool works with no credentials.
入力スキーマ
{'type': 'object', 'required': ['slug'], 'properties': {'days': {'type': 'number', 'description': 'Optional. How many days to walk, 1 to 14. Defaults to 7.'}, 'from': {'type': 'string', 'description': "Optional. First day to look at, yyyy-mm-dd in the business's own local calendar. Defaults to their today."}, 'kind': {'enum': ['entity', 'website'], 'type': 'string', 'description': 'Optional. The `kind` field from the same search result. Defaults to "entity".'}, 'slug': {'type': 'string', 'description': 'The `slug` field from a search_businesses result.'}, 'time': {'type': 'string', 'description': 'Optional. One exact start time as HH:MM, 24-hour, on the first day of the range. The answer comes back under `asked`, and "not-a-slot-start" means their day divides differently — the free starts are listed beside it.'}}}
check_commitment
Read a commitment you were given by commit_order, including whether the business has since withdrawn it. Returns `state`: "issued" means it stands, "repudiated" means the business said they cannot honour it, with their stated reason. A withdrawal does not erase the original — both are on the record, timestamped. Check this before acting on a commitment made some time ago. Authentication: none. This tool works with no credentials.
入力スキーマ
{'type': 'object', 'required': ['ref'], 'properties': {'ref': {'type': 'string', 'description': 'The `ref` returned by commit_order. It is the only way to read this commitment.'}}}
check_escalation
Read the answer to a question that had to go to a human. Use the `escalation.ref` that ask_business_freeform returned when its outcome was "escalated". Returns a `state` and, once there is one, the business's own `answer` in their words. Branch on `state`: "open" means we have not reached them yet, "delivered" means the question is in front of them and unanswered, "answered" carries `answer`, "undeliverable" means this business has given us no way to reach them and waiting will not help, "expired" means nobody answered and we have stopped waiting. This is a poll, not a subscription, and there is no obligation on anyone to answer. Come back later rather than in a loop; most answers take hours, not seconds. Authentication: none. This tool works with no credentials.
入力スキーマ
{'type': 'object', 'required': ['ref'], 'properties': {'ref': {'type': 'string', 'description': 'The `escalation.ref` from an earlier ask_business_freeform result. It is the only way to read this answer, so keep it.'}}}
check_merchant_verification
Check live what a merchant has actually been verified to, and by whom. Call this before acting on a claim that matters — a profile is a cached summary, this is the current answer. Returns `level`, a signed attestation, an expiry date and the transparency-log position. `level` "human" means a tunnel employee checked identity, control of the channels, and that the service is real. `level` "automated" means machines proved the merchant controls the channels its record cites and NOTHING about who they are or whether they deliver — the `limitations` array says so inside the signed payload. null means neither. Neither level is an endorsement of quality. Treat an answer older than five minutes as stale for anything irreversible. Authentication: none. This tool works with no credentials.
入力スキーマ
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': 'The `slug` field from a search_businesses result, or the merchant numeric id.'}}}
check_replies
Read a conversation you opened with contact_business, including anything the business has replied since. Returns the whole message thread and its status. Poll it; there is no push. Authentication: the `conversation_id` and `token` from contact_business are the credential for this call. No bearer token is needed.
入力スキーマ
{'type': 'object', 'required': ['conversation_id', 'token'], 'properties': {'token': {'type': 'string', 'description': 'The secret `token` returned by contact_business.'}, 'conversation_id': {'type': 'number', 'description': 'The `conversation_id` returned by contact_business.'}}}
commit_order
Place a binding order with a business, inside limits they set in advance. This is the only tool here that commits anyone to anything. Either name the figure yourself, or send `items` from get_rate_card and we price them from the merchant's own card. Either way it is checked against their price floor, maximum, daily capacity, notice period and blackout dates. Send `time` to take one slot rather than a whole day — check_availability lists them. No model reads any part of this call: the fields you send are the fields we check, so a commitment cannot be talked into existence by anything written in prose. Returns `committed`. When true you get a `ref`, the exact `terms` agreed and `basis` naming which of their settings allowed it. When false, `reason` names the single limit that refused: "not-authorised", "below-price-floor", "above-maximum" (a person decides that one), "capacity-full", "blackout-date", "inside-lead-time", "currency-mismatch", "date-in-past", "unknown-items", "quote-mismatch" (their prices changed), "slot-taken", "not-a-slot-start". A refusal is final for those terms — change them or use contact_business; do not retry the same call. The business may later withdraw. Read `state` from check_commitment before relying on it. Authentication: bearer token required. Register once at POST /api/v1/agents/register, exchange the credentials at POST /api/v1/agents/token.
入力スキーマ
{'type': 'object', 'required': ['slug', 'kind', 'date'], 'properties': {'date': {'type': 'string', 'description': "The day the work or delivery is for, as yyyy-mm-dd, in the business's own local calendar."}, 'kind': {'enum': ['entity', 'website'], 'type': 'string', 'description': 'The `kind` field from the same search result.'}, 'slug': {'type': 'string', 'description': 'The `slug` field from a search_businesses result.'}, 'time': {'type': 'string', 'description': 'Optional. A slot start on that day, HH:MM in 24-hour time and in their timezone. It must be one of the starts check_availability lists; times between them are refused rather than rounded to the nearest one.'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string', 'description': 'A `code` from get_rate_card.'}, 'quantity': {'type': 'number', 'description': 'Optional. How many units of that line. Defaults to 1.'}}}, 'description': 'Optional. Lines from their rate card, as request_quote takes them. When present, the price is theirs rather than yours and is computed fresh at this moment — a card that changed since you quoted refuses with "quote-mismatch" instead of billing the new figure.'}, 'amount': {'type': 'number', 'description': 'What the buyer is offering to pay, as a number. Required unless you send `items`. This is your figure, not ours — we only check it against the limits the business set. Sent alongside `items`, it must equal what their card comes to, or the call is refused.'}, 'currency': {'type': 'string', 'description': 'ISO code, e.g. MDL or EUR. Required unless you send `items`. It must match the currency their limits are in.'}, 'quantity': {'type': 'number', 'description': 'Optional. How many, as a whole number. Defaults to 1. Leave it out when you send `items` — the quantities are on the lines.'}, 'description': {'type': 'string', 'description': 'Optional. What the order is for, in plain words. Recorded and shown to the business; it is never parsed and never changes what we check.'}}}
contact_business
Open a conversation with the person behind a listing. The message arrives in their dashboard inbox and they reply when they get to it — this is asynchronous, not a chat, and nobody is obliged to answer. Returns a `conversation_id` and a secret `token`. Keep both: they are the only way to read a reply (check_replies) or write again (send_followup), and the `token` cannot be recovered. Authentication: bearer token required. Register once at POST /api/v1/agents/register, exchange the credentials at POST /api/v1/agents/token, and send the result as an Authorization: Bearer header. Registered agents get a daily conversation quota, a per-minute burst limit and an alarm on contacting many businesses at once; a refusal names which one was hit. Reading the knowledge base needs none of this.
入力スキーマ
{'type': 'object', 'required': ['slug', 'agent_name', 'subject', 'message'], 'properties': {'kind': {'enum': ['entity', 'website'], 'type': 'string', 'description': 'Optional. The `kind` field from the same search result.'}, 'slug': {'type': 'string', 'description': 'The `slug` field from a search_businesses result.'}, 'message': {'type': 'string', 'description': 'The message body. Maximum 4000 characters.'}, 'subject': {'type': 'string', 'description': 'Short subject line, like an email subject.'}, 'agent_name': {'type': 'string', 'description': 'Who is writing, in words the business will read — e.g. "Claude, on behalf of a customer".'}, 'agent_contact': {'type': 'string', 'description': 'Optional. An out-of-band address the business can reply to, e.g. the end user email if they agreed to share it.'}}}
get_business
Read the full profile of one business. Returns identity, contact details, address, social profiles, offerings, FAQ, `verification` and any machine-readable endpoints we publish for it. Absent information is named in `missing` rather than dropped silently, so an empty field means "we do not hold this", not "they do not have one". An unknown `slug` returns candidate slugs instead of a bare failure. Authentication: none. This tool works with no credentials.
入力スキーマ
{'type': 'object', 'required': ['slug'], 'properties': {'kind': {'enum': ['entity', 'website'], 'type': 'string', 'description': 'Optional. The `kind` field from the same search result. If omitted, "entity" is tried first, then "website".'}, 'slug': {'type': 'string', 'description': 'The `slug` field from a search_businesses result.'}}}
get_rate_card
Read the prices a business has authorised us to quote on their behalf. Returns `published` and, when true, a `rateCard` holding a currency, an optional minimum charge and `items` — each with a `code`, a label, a unit and an amount. Those `code` values are what request_quote and commit_order take: we price exactly what you name and never work out which line a description meant, because a near-miss there is a wrong price someone has to honour. `published` false comes with `reason`: "no-rate-card" means they have not written one, "not-authorised" means they have not allowed us to name prices at all. Neither means the work is unavailable — only that the figure has to come from a person, via ask_business_freeform or contact_business. Authentication: none. This tool works with no credentials.
入力スキーマ
{'type': 'object', 'required': ['slug'], 'properties': {'kind': {'enum': ['entity', 'website'], 'type': 'string', 'description': 'Optional. The `kind` field from the same search result. Defaults to "entity".'}, 'slug': {'type': 'string', 'description': 'The `slug` field from a search_businesses result.'}}}
request_order_change
Raise anything else about an order that already exists: a change to what was ordered, a refund request, or a problem with what was delivered. This tool never settles anything, and that is deliberate. Changing an order re-prices it and a refund moves money tunnel does not hold, so both are decisions only the business makes. What this does is put the request in front of them with the whole order attached — reference, terms, lines, date and what has already happened to it — on the channel they actually read. Returns `settled` false always, the `order` as it stands, and an `escalation` whose `ref` you poll with check_escalation for the business's own answer in their words. For a refund it also returns `refund`: their published terms at this notice, if they have published any. Nothing has been paid, refunded or changed by this call. Authentication: bearer token required.
入力スキーマ
{'type': 'object', 'required': ['ref', 'change', 'note'], 'properties': {'ref': {'type': 'string', 'description': 'The `ref` returned by commit_order.'}, 'note': {'type': 'string', 'description': 'What the buyer actually said, in their own words. This is the part the business needs, so send it verbatim. Carried unchanged and never interpreted.'}, 'change': {'enum': ['modify', 'refund', 'other'], 'type': 'string', 'description': 'What kind of request this is: "modify" to change what was ordered, "refund" to ask about money back, "other" for anything else including something being wrong.'}}}
request_quote
Price a specific set of line items against a business's rate card. Call get_rate_card first and name `code` values from it; we do the arithmetic. Returns `quoted`. When true you get `total`, `lines` showing what each one came to, and `validUntil`. A quote is a statement, NOT a hold — nothing is reserved and no price is locked. commit_order prices the same items again from the card at the moment it binds, so if the merchant changed a figure in between you are told rather than charged. When `quoted` is false, `reason` is "unknown-items" (not on their card), "quantity-out-of-range" (change the number and call again), "no-rate-card", "not-authorised" or "below-price-floor". All but the second put the question in front of a person and return an `escalation` whose `ref` you can poll with check_escalation. Authentication: none. This tool works with no credentials.
入力スキーマ
{'type': 'object', 'required': ['slug', 'items'], 'properties': {'kind': {'enum': ['entity', 'website'], 'type': 'string', 'description': 'Optional. The `kind` field from the same search result. Defaults to "entity".'}, 'note': {'type': 'string', 'description': "Optional. What the job is, in the buyer's own words. Never parsed and never changes the figure; it is what a human reads if the quote has to go to one."}, 'slug': {'type': 'string', 'description': 'The `slug` field from a search_businesses result.'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string', 'description': "A `code` from the business's rate card."}, 'quantity': {'type': 'number', 'description': 'Optional. How many units of that line. Defaults to 1.'}}}, 'description': 'The lines to price. Each is an object with a `code` from get_rate_card and an optional quantity, which defaults to 1. Up to 100 lines.'}, 'language': {'enum': ['en', 'ro', 'ru', 'de'], 'type': 'string', 'description': "Optional. The buyer's language, recorded with the request. Defaults to English."}}}
reschedule_order
Move an order you placed to a different date, or a booking to a different slot. The price, the items and the quantity are unchanged — this moves WHEN, nothing else. To change what was ordered, use request_order_change. A booking made for a time must be moved to a time, and a whole-day order to a whole day; the new slot is checked exactly as commit_order checked the first one. Call check_availability first. Returns `settled`, and when true `from` and `to`, plus `remainingReschedules` — an order may be moved a limited number of times before a person is asked instead. False comes with a `reason`: "slot-taken", "not-a-slot-start", "closed-that-day", "blackout-date", "capacity-full", "inside-lead-time", "date-in-past", "time-required", "time-not-supported", "inside-cancel-window", "too-many-reschedules" or "not-open". Some are yours to fix and carry `freeSlots`; the rest return an `escalation` for check_escalation. Authentication: bearer token required, and it must be the same agent that placed the order.
入力スキーマ
{'type': 'object', 'required': ['ref', 'date'], 'properties': {'ref': {'type': 'string', 'description': 'The `ref` returned by commit_order.'}, 'date': {'type': 'string', 'description': "The new day, as yyyy-mm-dd in the business's own local calendar."}, 'note': {'type': 'string', 'description': "Optional. Why, in the buyer's own words. Shown to the business, never parsed."}, 'time': {'type': 'string', 'description': 'The new slot start, HH:MM in 24-hour time and in their timezone. Required if the order was made for a time; leave it out if it was made for a whole day.'}}}
search_businesses
Find businesses, merchants and websites in the tunnel knowledge base by name or topic. Start here: every other tool needs a `slug`, and this is where a `slug` comes from. Returns an array of summaries, each with `slug`, `kind`, name, description and a `verification` object. Read `verification.level` rather than assuming: "human" means a tunnel employee checked the business, "automated" means machines proved only that the business controls its own channels, and null means neither. Zero matches is a normal answer, not an error — it comes back with `completeness` "empty". Authentication: none. This tool works with no credentials.
入力スキーマ
{'type': 'object', 'required': ['query'], 'properties': {'type': {'enum': ['company', 'merchant', 'organization', 'person', 'other', 'website'], 'type': 'string', 'description': 'Optional. Return only records of this kind.'}, 'limit': {'type': 'number', 'description': 'Optional. Maximum results, 1 to 50. Defaults to 20.'}, 'query': {'type': 'string', 'description': 'Name, topic or place. Words are matched independently against the name, location, description, offerings and FAQ, and most of them have to appear somewhere in a record, so "cakes in Chisinau" works. Accents are ignored, so the unaccented spelling is fine. This matches words, not meanings: a business calling itself a "cofetăria" will not be found by searching "bakery". If nothing comes back, try the words the business would use about itself.'}}}
send_followup
Add another message to a conversation already opened with contact_business. Returns the updated message thread. There is a cap on messages per conversation, so send one considered follow-up rather than several fragments. Authentication: bearer token required — the same one used for contact_business — plus the `conversation_id` and `token` for the conversation itself.
入力スキーマ
{'type': 'object', 'required': ['conversation_id', 'token', 'message'], 'properties': {'token': {'type': 'string', 'description': 'The secret `token` returned by contact_business.'}, 'message': {'type': 'string', 'description': 'The message body. Maximum 4000 characters.'}, 'conversation_id': {'type': 'number', 'description': 'The `conversation_id` returned by contact_business.'}}}
履歴
最近のツール変更
追加
send_followup
2026年9月17日12:38
追加
check_replies
2026年9月17日12:38
追加
contact_business
2026年9月17日12:38
追加
request_order_change
2026年9月17日12:38
追加
reschedule_order
2026年9月17日12:38
追加
cancel_order
2026年9月17日12:38
追加
commit_order
2026年9月17日12:38
追加
check_availability
2026年9月17日12:38
追加
request_quote
2026年9月17日12:38
追加
get_rate_card
2026年9月17日12:38
追加
check_commitment
2026年9月17日12:38
追加
check_escalation
2026年9月17日12:38
追加
ask_business_freeform
2026年9月17日12:38
追加
ask_business
2026年9月17日12:38
追加
check_merchant_verification
2026年9月17日12:38
追加
get_business
2026年9月17日12:38
追加
search_businesses
2026年9月17日12:38
関連MCP
類似のMCPサーバー
API Direct
io.apidirect/api-direct
Searches and retrieves data from social networks, news and Google services, while also providing Amazon product, seller, ranking,…
Bonanza
io.github.pipeworx-io/bonanza
Searches active Bonanza marketplace listings and retrieves individual item details.
cyclesite-mcp-server
io.github.Tomalarrrr/cyclesite-mcp-server
Supports searching, comparing, valuing, buying, selling, reserving, and messaging about used bicycles on a UK marketplace.
MONO Social
io.github.junoventures/mono-juno-ventures
Provides directory search for local places, events, listings, services, offers, bookings, reservations, tickets, and products.
Campo Belo
io.github.junoventures/campobelo-sampa-br
Provides Campo Belo local discovery for places, events, menus, offers, services, bookings, reservations, tickets, and purchases.
Bom Retiro
io.github.junoventures/bomretiro-sampa-br
Provides Bom Retiro local place, event, menu, offer, service, booking, reservation, ticketing, and checkout capabilities.
Bogeyland
io.github.junoventures/bogeyland-golf
Provides directory search for places, events, services, offers, bookings, reservations, tickets, menus, and purchases.
Genesis Social
io.github.junoventures/genesis-social
Provides directory search and transactions for local places, events, restaurants, services, offers, bookings, and tickets.