BuyNearby MCP

An official MCP server provided by BuyNearby that allows AI assistants to interact with the BuyNearby local marketplace platform. It enables agents to perform natural language product searches across Calgary stores, access structured business information, and retrieve live stock and price data for items available through the BuyNearby POS system.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Vendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-07Operated by BuyNearby

MCP endpoint (Streamable HTTP)

https://buynearby.store/api/v1/mcp-server.php

Vendor documentation

What its tools do

8 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Not annotated (8)

search_products
check_stock
get_todays_deals
get_stores
place_order
place_cart_order
book_courier
shop_and_deliver

8 of 8 have a description · 0 of 8 declare behavior hints · 3 of 8 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

Passed Endpoint answered the live check · Nov 7, 2026, 4:14 AM UTC
Passed Official MCP Registry namespace is tied to buynearby.store · Nov 7, 2026, 12:20 AM UTC
Passed Endpoint is on the registry namespace domain · Nov 7, 2026, 12:20 AM UTC
Availability 1 of 1 checks passed in 30 days

What you can do with it

Search for products using natural language queries
Retrieve live stock and price information
Access structured business and store directory data
Connect AI assistants to the BuyNearby platform

Source and maintenance

Vendor evidenceRegistry 1.0.0

mcp-registry: store.buynearby/mcp@1.0.0

Protocol and capabilities

Server: buynearby 1.0.0
MCP protocol negotiated in check: 2025-06-18
Tools: 8 advertised
Resources: Not advertised
Resource templates: Not advertised
Prompts: Not advertised

Server-advertised capabilities

{
  "tools": {}
}

Tools

8 advertised

search_products

Advertised by the server during the last successful anonymous check.

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.

search_products input schema

{
  "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)"
    }
  }
}

check_stock

Advertised by the server during the last successful anonymous check.

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.

check_stock input schema

{
  "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_todays_deals

Advertised by the server during the last successful anonymous check.

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.

get_todays_deals input schema

{
  "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)"
    }
  }
}

get_stores

Advertised by the server during the last successful anonymous check.

Get a list of local stores in Calgary with location info.

get_stores input schema

{
  "type": "object",
  "required": [],
  "properties": {
    "city": {
      "type": "string",
      "default": "Calgary"
    }
  }
}

place_order

Advertised by the server during the last successful anonymous check.

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.

place_order input schema

{
  "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"
    }
  }
}

place_cart_order

Advertised by the server during the last successful anonymous check.

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.

place_cart_order input schema

{
  "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"
    }
  }
}

book_courier

Advertised by the server during the last successful anonymous check.

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).

book_courier input schema

{
  "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"
    }
  }
}

shop_and_deliver

Advertised by the server during the last successful anonymous check.

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.

shop_and_deliver input schema

{
  "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"
    }
  }
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks: 1 of 1 (100%)
Average latency: 141 ms
95th percentile latency: 141 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

Nov 7, 2026, 4:14 AM UTC · probe · passed · 141 ms · metadata changed · 8 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.

Claude Code configuration

claude mcp add --transport http buynearby-mcp https://buynearby.store/api/v1/mcp-server.php

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).

Codex configuration

codex mcp add buynearby-mcp --url https://buynearby.store/api/v1/mcp-server.php

Cursor

Merge this server into .cursor/mcp.json in your project, then enable buynearby-mcp in your MCP settings.

Cursor configuration

{
  "mcpServers": {
    "buynearby-mcp": {
      "url": "https://buynearby.store/api/v1/mcp-server.php"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).

Cline configuration

{
  "mcpServers": {
    "buynearby-mcp": {
      "type": "streamableHttp",
      "url": "https://buynearby.store/api/v1/mcp-server.php",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start buynearby-mcp and inspect its tools.

VS Code configuration

{
  "servers": {
    "buynearby-mcp": {
      "type": "http",
      "url": "https://buynearby.store/api/v1/mcp-server.php"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.

Gemini CLI configuration

gemini mcp add --transport http buynearby-mcp https://buynearby.store/api/v1/mcp-server.php

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.

Claude Desktop configuration

https://buynearby.store/api/v1/mcp-server.php

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.

Windsurf configuration

{
  "mcpServers": {
    "buynearby-mcp": {
      "serverUrl": "https://buynearby.store/api/v1/mcp-server.php"
    }
  }
}

Let your agent find its tools

Find servers like BuyNearby MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows

Do you run BuyNearby MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing