Shop BuyNearby's local Calgary marketplace, book couriers, and request personal shopping runs.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
API key for authenticated tools (place_order, place_cart_order, book_courier, shop_and_deliver). Not required for search_products, check_stock, or get_stores.
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.
Get a courier price quote, book a REAL point-to-point courier/parcel delivery in Calgary, check a booking's status, or cancel one - no BuyNearby account needed. action:'book' immediately creates the booking and auto-assigns a driver if one is available, exactly like a human finishing the form at buynearby.store/courier-book.php; the response's booking_ref is a real, live booking, not a draft. Payment is a link texted to the customer afterward (this call never charges a card). Use action:'quote' first if you just need a price before the user has decided to book. Use action:'status' to check on an existing booking, and action:'cancel' to self-cancel one (only while it's still 'pending' or 'assigned' — once a driver has picked up the package, direct the customer to support instead).
Required for action 'status'/'cancel', e.g. 'CB-20260912-0007'
Optional, action 'cancel' only
Required for action 'book'
Required for action 'book', 'status', and 'cancel' — for 'status'/'cancel' this must match the phone on the booking (it's the ownership check, since booking_ref alone is guessable)
Required for action 'quote'/'book'
Optional, action 'book' only — pass the same value on a retry (e.g. after a dropped connection) to avoid creating a duplicate booking
Required for action 'quote'/'book'
Any parseable date/time; omit for ASAP dispatch
Any parseable date/time the customer needs the delivery completed by, e.g. 'today 10pm'; must not be before preferred_pickup_time
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Get a courier price quote, book a REAL point-to-point courier/parcel delivery in Calgary, check a booking's status, or cancel one - no BuyNearby account needed. action:'book' immediately creates the booking and auto-assigns a driver if one is available, exactly like a human finishing the form at buynearby.store/courier-book.php; the response's booking_ref is a real, live booking, not a draft. Payment is a link texted to the customer afterward (this call never charges a card). Use action:'quote' first if you just need a price before the user has decided to book. Use action:'status' to check on an existing booking, and action:'cancel' to self-cancel one (only while it's still 'pending' or 'assigned' — once a driver has picked up the package, direct the customer to support instead).
| Argument | Type | Description |
|---|---|---|
| action* | string | |
| size_tier | string | |
| booking_ref | string | Required for action 'status'/'cancel', e.g. 'CB-20260912-0007' |
| cancel_reason | string | Optional, action 'cancel' only |
| customer_name | string | Required for action 'book' |
| package_count | integer | |
| customer_email | string | |
| customer_phone | string | Required for action 'book', 'status', and 'cancel' — for 'status'/'cancel' this must match the phone on the booking (it's the ownership check, since booking_ref alone is guessable) |
| delivery_notes | string | |
| pickup_address | string | Required for action 'quote'/'book' |
| idempotency_key | string | Optional, action 'book' only — pass the same value on a retry (e.g. after a dropped connection) to avoid creating a duplicate booking |
| delivery_address | string | Required for action 'quote'/'book' |
| preferred_pickup_time | string | Any parseable date/time; omit for ASAP dispatch |
| preferred_dropoff_time | string | Any parseable date/time the customer needs the delivery completed by, e.g. 'today 10pm'; must not be before preferred_pickup_time |
{
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"enum": [
"quote",
"book",
"status",
"cancel"
],
"type": "string"
},
"size_tier": {
"enum": [
"small",
"standard",
"heavy"
],
"type": "string",
"default": "standard"
},
"booking_ref": {
"type": "string",
"description": "Required for action 'status'/'cancel', e.g. 'CB-20260912-0007'"
},
"cancel_reason": {
"type": "string",
"description": "Optional, action 'cancel' only"
},
"customer_name": {
"type": "string",
"description": "Required for action 'book'"
},
"package_count": {
"type": "integer",
"default": 1
},
"customer_email": {
"type": "string"
},
"customer_phone": {
"type": "string",
"description": "Required for action 'book', 'status', and 'cancel' — for 'status'/'cancel' this must match the phone on the booking (it's the ownership check, since booking_ref alone is guessable)"
},
"delivery_notes": {
"type": "string"
},
"pickup_address": {
"type": "string",
"description": "Required for action 'quote'/'book'"
},
"idempotency_key": {
"type": "string",
"description": "Optional, action 'book' only — pass the same value on a retry (e.g. after a dropped connection) to avoid creating a duplicate booking"
},
"delivery_address": {
"type": "string",
"description": "Required for action 'quote'/'book'"
},
"preferred_pickup_time": {
"type": "string",
"description": "Any parseable date/time; omit for ASAP dispatch"
},
"preferred_dropoff_time": {
"type": "string",
"description": "Any parseable date/time the customer needs the delivery completed by, e.g. 'today 10pm'; must not be before preferred_pickup_time"
}
}
}Check live stock level for a specific product. Optionally filter by store. If the caller's API key is a store-scoped partner key, the result is limited to that key's own store regardless of store_id.
| Argument | Type | Description |
|---|---|---|
| store_id | integer | Store ID (optional) |
| product_id* | string | Product ID from search results |
{
"type": "object",
"required": [
"product_id"
],
"properties": {
"store_id": {
"type": "integer",
"description": "Store ID (optional)"
},
"product_id": {
"type": "string",
"description": "Product ID from search results"
}
}
}Get a list of local stores in Calgary with location info.
| Argument | Type | Description |
|---|---|---|
| city | string |
{
"type": "object",
"required": [],
"properties": {
"city": {
"type": "string",
"default": "Calgary"
}
}
}Get today's real discounted products and active flash deals — products currently priced below their regular price, and time-limited flash deals. This is the actual sale/discount data; search_products has no discount flag so a text search for "sale" or "deals" won't find this.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max results per section. Default 20, max 50 |
| store_id | integer | Limit to one store (optional — omit for deals across all stores) |
{
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"description": "Max results per section. Default 20, max 50"
},
"store_id": {
"type": "integer",
"description": "Limit to one store (optional — omit for deals across all stores)"
}
}
}Shop BuyNearby's real marketplace catalog: add multiple products (from one store or several) to a cart and check out as ONE real order in a single call - price/stock for every item is looked up from the live catalog server-side (you cannot supply your own price). Use this instead of place_order whenever the user wants more than one item, or items from different stores. Uses the exact same tax/delivery-fee/coupon pricing engine as the human checkout page, so the total you quote back to the user is authoritative. Creates a REAL order immediately - not a draft - visible right away in the store's dashboard for confirmation. Payment is a pre-authorization link texted/emailed to the customer (card held, not charged) - the actual charge happens once the store confirms.
| Argument | Type | Description |
|---|---|---|
| items* | array | |
| express | boolean | |
| coupon_code | string | |
| customer_name* | string | |
| customer_email | string | |
| customer_phone* | string | |
| tip_percentage | number | Only set this if the user explicitly chose a tip - don't default one in on their behalf |
Place an order for a single product from BuyNearby's own catalog (stores running the BuyNearby POS - stock/price are live and guaranteed). Requires API key authentication. A store-scoped partner key can only order products from its own store. Payment is a pre-authorization link texted/emailed to the customer (card is held, not charged) - the actual charge happens once the store confirms the order, not at booking time.
| Argument | Type | Description |
|---|---|---|
| express | boolean | Adds an express fee (default $4.99 CAD) |
| quantity | integer | |
| product_id* | string | |
| customer_email* | string | |
| delivery_address* | string | |
| requested_by_time | string | Any parseable date/time, e.g. 'today 22:00' - recorded on the order, not an enforced SLA at this tier |
{
"type": "object",
"required": [
"product_id",
"customer_email",
"delivery_address"
],
"properties": {
"express": {
"type": "boolean",
"default": false,
"description": "Adds an express fee (default $4.99 CAD)"
},
"quantity": {
"type": "integer",
"default": 1
},
"product_id": {
"type": "string"
},
"customer_email": {
"type": "string"
},
"delivery_address": {
"type": "string"
},
"requested_by_time": {
"type": "string",
"description": "Any parseable date/time, e.g. 'today 22:00' - recorded on the order, not an enforced SLA at this tier"
}
}
}Search for products available at local Calgary stores. Returns product name, store, price, stock level, and store categories. Use this when the user asks about finding, buying, or locating any product locally.
| Argument | Type | Description |
|---|---|---|
| q* | string | Product search query — can be a product name, ingredient, or natural language description |
| city | string | City to search. Default: Calgary |
| limit | integer | Number of results (max 50) |
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "Product search query — can be a product name, ingredient, or natural language description"
},
"city": {
"type": "string",
"default": "Calgary",
"description": "City to search. Default: Calgary"
},
"limit": {
"type": "integer",
"default": 5,
"description": "Number of results (max 50)"
}
}
}Book a REAL personal-shopper run - a BuyNearby driver goes into a named physical store, shops from the given item list, and delivers it. Works even for stores that aren't BuyNearby partners (set needs_verification expectations: our team calls ahead to confirm stock first for those). This immediately creates the order, exactly like a customer finishing the Shop & Deliver chat flow on buynearby.store - it is not a draft. Estimate each item's price yourself (or via search_products if it's a known BuyNearby-catalog item) since the customer is only charged the driver's actual receipt total afterward, not this estimate.
| Argument | Type | Description |
|---|---|---|
| items* | array | |
| notes | string | |
| store_hint* | string | Physical store name, e.g. 'Purdys Chocolatier Chinook Centre' |
| customer_name* | string | |
| customer_email | string | |
| customer_phone* | string | |
| delivery_address* | string |
| delivery_address* |
| string |
| Required unless fulfillment_type is 'pickup' |
| fulfillment_type | string |
{
"type": "object",
"required": [
"customer_name",
"customer_phone",
"delivery_address",
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"product_id"
],
"properties": {
"quantity": {
"type": "integer",
"default": 1
},
"product_id": {
"type": "string",
"description": "From search_products results"
}
}
}
},
"express": {
"type": "boolean",
"default": false
},
"coupon_code": {
"type": "string"
},
"customer_name": {
"type": "string"
},
"customer_email": {
"type": "string"
},
"customer_phone": {
"type": "string"
},
"tip_percentage": {
"type": "number",
"default": 0,
"description": "Only set this if the user explicitly chose a tip - don't default one in on their behalf"
},
"delivery_address": {
"type": "string",
"description": "Required unless fulfillment_type is 'pickup'"
},
"fulfillment_type": {
"enum": [
"delivery",
"pickup"
],
"type": "string",
"default": "delivery"
}
}
}{
"type": "object",
"required": [
"customer_name",
"customer_phone",
"delivery_address",
"store_hint",
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"item_name",
"estimated_price"
],
"properties": {
"unit": {
"type": "string",
"default": "each"
},
"notes": {
"type": "string"
},
"quantity": {
"type": "number",
"default": 1
},
"store_id": {
"type": "integer"
},
"item_name": {
"type": "string"
},
"product_id": {
"type": "string"
},
"estimated_price": {
"type": "number",
"description": "CAD, your best estimate for this line - becomes the driver's shopping budget"
}
}
}
},
"notes": {
"type": "string"
},
"store_hint": {
"type": "string",
"description": "Physical store name, e.g. 'Purdys Chocolatier Chinook Centre'"
},
"customer_name": {
"type": "string"
},
"customer_email": {
"type": "string"
},
"customer_phone": {
"type": "string"
},
"delivery_address": {
"type": "string"
}
}
}