Search local businesses and book, order, quote or message any of them from one connection.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Choose a business's quote. This creates a real order at that business and declines the others. If that business protects payments, the reply carries a payment link where the money is held by Agoria until the customer confirms they got the work — hand that link to the customer.
The business whose quote to accept
From request_quotes
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Choose a business's quote. This creates a real order at that business and declines the others. If that business protects payments, the reply carries a payment link where the money is held by Agoria until the customer confirms they got the work — hand that link to the customer.
| Argument | Type | Description |
|---|---|---|
| slug* | string | The business whose quote to accept |
| briefToken* | string | From request_quotes |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"briefToken",
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "The business whose quote to accept"
},
"briefToken": {
"type": "string",
"description": "From request_quotes"
}
},
"additionalProperties": false
}Same index as search_market, but takes a plain sentence — 'three bedroom house under 800k in Geelong', 'automatic ute under 80,000km' — and works out the filters itself. Use it when you have the user's own words; use search_market when you already know the exact filters.
| Argument | Type | Description |
|---|---|---|
| question* | string | The user's request, in their words |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"question"
],
"properties": {
"question": {
"type": "string",
"description": "The user's request, in their words"
}
},
"additionalProperties": false
}Book an appointment at any business by slug. Confirm the slot with check_availability first.
| Argument | Type | Description |
|---|---|---|
| note | string | |
| slug* | string | Business slug |
| startsAt* | string | ISO datetime from check_availability |
| serviceId* | string | |
| customerName* | string | |
| customerContact* | string | Phone or email |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"slug",
"serviceId",
"startsAt",
"customerName",
"customerContact"
],
"properties": {
"note": {
"type": "string"
},
"slug": {
"type": "string",
"description": "Business slug"
},
"startsAt": {
"type": "string",
"description": "ISO datetime from check_availability"
},
"serviceId": {
"type": "string"
},
"customerName": {
"type": "string"
},
"customerContact": {
"type": "string",
"description": "Phone or email"
}
},
"additionalProperties": false
}Check open appointment slots for a service at a business on a date (YYYY-MM-DD).
| Argument | Type | Description |
|---|---|---|
| date* | string | YYYY-MM-DD |
| slug* | string | Business slug |
| serviceId* | string | Service id from get_business |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"slug",
"serviceId",
"date"
],
"properties": {
"date": {
"type": "string",
"description": "YYYY-MM-DD"
},
"slug": {
"type": "string",
"description": "Business slug"
},
"serviceId": {
"type": "string",
"description": "Service id from get_business"
}
},
"additionalProperties": false
}See every business's answer to a brief side by side: price, what it covers, lead time, rating, whether the payment would be protected, and which is cheapest or soonest.
| Argument | Type | Description |
|---|---|---|
| briefToken* | string | From request_quotes |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"briefToken"
],
"properties": {
"briefToken": {
"type": "string",
"description": "From request_quotes"
}
},
"additionalProperties": false
}Save a standing search on the customer's behalf. They get told when matching supply appears, AND — anonymously, without their contact details — sellers who could satisfy it can see it and offer. Use this when search_market found nothing good: it converts a dead end into a request the market can answer.
| Argument | Type | Description |
|---|---|---|
| name | string | |
| cadence | string | How often to tell them about new matches |
| contact* | string | The customer's email — never shown to sellers |
| request* | string | What they want, in their words |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"contact",
"request"
],
"properties": {
"name": {
"type": "string"
},
"cadence": {
"enum": [
"instant",
"daily",
"weekly"
],
"type": "string",
"description": "How often to tell them about new matches"
},
"contact": {
"type": "string",
"description": "The customer's email — never shown to sellers"
},
"request": {
"type": "string",
"description": "What they want, in their words"
}
},
"additionalProperties": false
}Get full details for a business by slug: description, contact, hours, services, FAQs, and the actions its agent supports.
| Argument | Type | Description |
|---|---|---|
| slug* | string | Business slug from search_businesses |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "Business slug from search_businesses"
}
},
"additionalProperties": false
}Everything about a single item: full facets, photos, where it is, who is selling it and how well-proven they are, a price guide computed from comparable items on the network, and the adjacent services a buyer usually needs next (finance, inspection, conveyancing, transport).
| Argument | Type | Description |
|---|---|---|
| ref* | string | Item ref from search_market, e.g. 'acme-motors/offering:stk991' |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ref"
],
"properties": {
"ref": {
"type": "string",
"description": "Item ref from search_market, e.g. 'acme-motors/offering:stk991'"
}
},
"additionalProperties": false
}Get a business's aggregate rating and reviews by slug. Optionally filter to a product/service id.
| Argument | Type | Description |
|---|---|---|
| slug* | string | Business slug |
| targetId | string | Product/service id; omit for whole business |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "Business slug"
},
"targetId": {
"type": "string",
"description": "Product/service id; omit for whole business"
}
},
"additionalProperties": false
}What can be searched and filtered on. Call this when you are unsure which `kind` or which `filters` keys search_market will accept.
| Argument | Type | Description |
|---|---|---|
| kind | array | Narrow to specific kinds |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"kind": {
"type": "array",
"items": {
"type": "string"
},
"description": "Narrow to specific kinds"
}
},
"additionalProperties": false
}List the products a business sells by slug — price/sale, availability/stock, brand, SKU/GTIN, variants, specs, dimensions.
| Argument | Type | Description |
|---|---|---|
| slug* | string | Business slug |
| query | string | Optional keyword filter |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "Business slug"
},
"query": {
"type": "string",
"description": "Optional keyword filter"
}
},
"additionalProperties": false
}Open standing requests from real buyers, anonymised. Useful for a business deciding what to stock or list, and for understanding where the network has no supply at all.
| Argument | Type | Description |
|---|---|---|
| kind | array | |
| where | string | |
| unmetOnly | boolean | Only requests nothing currently matches |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"kind": {
"type": "array",
"items": {
"type": "string"
}
},
"where": {
"type": "string"
},
"unmetOnly": {
"type": "boolean",
"description": "Only requests nothing currently matches"
}
},
"additionalProperties": false
}A price distribution for comparable items on the network — asking prices, and where the network settled the sale, what buyers actually paid. Widens the comparison and says so when the exact match is too thin to be meaningful.
| Argument | Type | Description |
|---|---|---|
| kind* | string | Item kind, e.g. 'vehicle' or 'listing' |
| where | string | Restrict to a locality first; dropped automatically if too thin |
| attributes* | object | What is being priced, e.g. {"make":"Toyota","model":"HiLux","year":2021} |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"kind",
"attributes"
],
"properties": {
"kind": {
"type": "string",
"description": "Item kind, e.g. 'vehicle' or 'listing'"
},
"where": {
"type": "string",
"description": "Restrict to a locality first; dropped automatically if too thin"
},
"attributes": {
"type": "object",
"description": "What is being priced, e.g. {\"make\":\"Toyota\",\"model\":\"HiLux\",\"year\":2021}",
"additionalProperties": {
"type": [
"string",
"number"
]
}
}
},
"additionalProperties": false
}Describe a job once and send it to the businesses that can price it. Each one answers with a real number, what it covers, and how long the price stands. Returns a briefToken — poll compare_quotes with it to see the prices as they land, then accept_quote to choose one. Use this instead of calling request_quote at each business separately.
| Argument | Type | Description |
|---|---|---|
| slugs | array | Specific businesses to ask. Omit to have Agoria match them. |
| title | string | Short label for the job |
| budget | number | |
| details* | string | What the customer needs, in plain language. The more specific, the better the quotes. |
| category | string | Business category to target, e.g. 'Plumber' |
| location | string | City or suburb |
| neededBy | string | When it's needed |
| customerName | string | |
| customerContact* | string | Email or phone — businesses quote back to this |
Resolve a suburb, postcode or city to coordinates and the radius that name implies. Use it to check a place exists before passing it to search_market.
| Argument | Type | Description |
|---|---|---|
| where* | string | e.g. 'Fitzroy', '3065', 'Geelong VIC' |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"where"
],
"properties": {
"where": {
"type": "string",
"description": "e.g. 'Fitzroy', '3065', 'Geelong VIC'"
}
},
"additionalProperties": false
}Find businesses on Agoria by free-text query, category, and/or city. Returns each business's slug plus the actions its agent can take, so you can act on it directly from this same connection.
| Argument | Type | Description |
|---|---|---|
| city | string | |
| query | string | e.g. 'emergency plumber', 'gluten free pizza' |
| category | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"city": {
"type": "string"
},
"query": {
"type": "string",
"description": "e.g. 'emergency plumber', 'gluten free pizza'"
},
"category": {
"type": "string"
}
},
"additionalProperties": false
}Search individual items across every business on the network — property listings, vehicles, courses, products, services, events, plans — with typed filters, a price range and a radius around a place. Prefer this over search_businesses whenever the user is looking for a THING rather than a company. Returns items with prices, locations, photo counts and the seller's verification status.
| Argument | Type | Description |
|---|---|---|
| kind | array | Item kinds to include, e.g. ['listing'], ['vehicle'], ['course']. Call list_market_filters to see what exists. |
| page | number | |
| sort | string | |
| limit | number | |
| query | string | Free text, e.g. 'renovated terrace', 'diesel ute' |
| where | string | A suburb, postcode, city or 'lat,lng' |
| filters | object | Typed facet filters keyed by field id, e.g. {"beds":{"min":3},"make":"toyota"} |
| maxPrice | number | |
| minPrice |
Perform any non-booking action a business supports (request_quote, place_order, send_message, pay_invoice, sign_document, subscribe, register…). Get valid action ids and their fields from get_business. Pass the action's fields as a JSON object. If the result is 'action_required', hand the user the next.url (payment/signing link) or re-call with fields.confirmToken to confirm.
| Argument | Type | Description |
|---|---|---|
| slug* | string | Business slug |
| action* | string | Action id, e.g. 'request_quote' |
| fields* | object | The action's input fields as a JSON object (include confirmToken to complete a gated action) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"slug",
"action",
"fields"
],
"properties": {
"slug": {
"type": "string",
"description": "Business slug"
},
"action": {
"type": "string",
"description": "Action id, e.g. 'request_quote'"
},
"fields": {
"type": "object",
"description": "The action's input fields as a JSON object (include confirmToken to complete a gated action)",
"additionalProperties": {}
}
},
"additionalProperties": false
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"details",
"customerContact"
],
"properties": {
"slugs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Specific businesses to ask. Omit to have Agoria match them."
},
"title": {
"type": "string",
"description": "Short label for the job"
},
"budget": {
"type": "number"
},
"details": {
"type": "string",
"description": "What the customer needs, in plain language. The more specific, the better the quotes."
},
"category": {
"type": "string",
"description": "Business category to target, e.g. 'Plumber'"
},
"location": {
"type": "string",
"description": "City or suburb"
},
"neededBy": {
"type": "string",
"description": "When it's needed"
},
"customerName": {
"type": "string"
},
"customerContact": {
"type": "string",
"description": "Email or phone — businesses quote back to this"
}
},
"additionalProperties": false
}| number |
| radiusKm | number | Radius around `where`. Defaults to the size of the place named. |
| verifiedOnly | boolean | Only items from businesses whose details have been checked against an outside register |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"kind": {
"type": "array",
"items": {
"type": "string"
},
"description": "Item kinds to include, e.g. ['listing'], ['vehicle'], ['course']. Call list_market_filters to see what exists."
},
"page": {
"type": "number"
},
"sort": {
"enum": [
"relevance",
"price_asc",
"price_desc",
"newest",
"nearest",
"proven"
],
"type": "string"
},
"limit": {
"type": "number"
},
"query": {
"type": "string",
"description": "Free text, e.g. 'renovated terrace', 'diesel ute'"
},
"where": {
"type": "string",
"description": "A suburb, postcode, city or 'lat,lng'"
},
"filters": {
"type": "object",
"description": "Typed facet filters keyed by field id, e.g. {\"beds\":{\"min\":3},\"make\":\"toyota\"}",
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "object",
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"additionalProperties": false
}
]
}
},
"maxPrice": {
"type": "number"
},
"minPrice": {
"type": "number"
},
"radiusKm": {
"type": "number",
"description": "Radius around `where`. Defaults to the size of the place named."
},
"verifiedOnly": {
"type": "boolean",
"description": "Only items from businesses whose details have been checked against an outside register"
}
},
"additionalProperties": false
}