Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "buynearby": {
      "type": "http",
      "url": "https://buynearby.store/api/v1/mcp-server.php",
      "headers": {
        "X-API-Key": "${X_API_KEY}"
      }
    }
  }
}

claude mcp add --transport http buynearby https://buynearby.store/api/v1/mcp-server.php --header "X-API-Key: ${X_API_KEY}"

[mcp_servers.buynearby]
url = "https://buynearby.store/api/v1/mcp-server.php"
env_http_headers = { "X-API-Key" = "X_API_KEY" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "buynearby": {
      "type": "remote",
      "url": "https://buynearby.store/api/v1/mcp-server.php",
      "enabled": true,
      "headers": {
        "X-API-Key": "{env:X_API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "buynearby": {
      "type": "http",
      "url": "https://buynearby.store/api/v1/mcp-server.php",
      "headers": {
        "X-API-Key": "${X_API_KEY}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=buynearby&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYnV5bmVhcmJ5LnN0b3JlL2FwaS92MS9tY3Atc2VydmVyLnBocCIsImhlYWRlcnMiOnsiWC1BUEktS2V5IjoiJHtYX0FQSV9LRVl9In19"
}

{
  "servers": {
    "buynearby": {
      "type": "http",
      "url": "https://buynearby.store/api/v1/mcp-server.php",
      "headers": {
        "X-API-Key": "${X_API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "buynearby": {
      "httpUrl": "https://buynearby.store/api/v1/mcp-server.php",
      "headers": {
        "X-API-Key": "${X_API_KEY}"
      }
    }
  }
}

extensions:
  "buynearby":
    enabled: true
    name: "buynearby"
    type: streamable_http
    uri: "https://buynearby.store/api/v1/mcp-server.php"
    headers:
      "X-API-Key": "${X_API_KEY}"
    timeout: 300

Placeholders to fill from your own secret store: ${X_API_KEY}. The registry never accepts secret values.

Quality 79 / 100good

protocol75 · weight 25

warn
protocol.modernnewest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
n/a
protocol.statelessonly applies to 2026-07-28 servers
pass
protocol.transportstreamable HTTP
n/a
protocol.list_ttlonly applies to 2026-07-28 servers

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene71 · weight 30

pass
tools.descriptionsevery tool has a description
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
fail
tools.annotationsno tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
fail
tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: search_products (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_todays_deals (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); book_courier (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
pass
tools.token_costabout 2,005 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability100 · weight 15

pass
stability.changesno tool changes in 30 days
pass
stability.rug_pullno tool changed its meaning under the same name

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

8 tools, about 2,005 tokens to load them all · tool set 134ce23060ef · checked 2026-10-20 14:54 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 77 / 100

no-repository

provenance45

liveness100

freshness85

hygiene80

+dns-namespace +reachable +uptime-99% ~updated-46d-ago -no-repository

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://buynearby.store/api/v1/mcp-server.php` streamable-http	none	yes	99%	417 ms	2025-06-18	2026-10-20

Tools (8)

`book_courier`	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).
`check_stock`	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.
`get_stores`	Get a list of local stores in Calgary with location info.
`get_todays_deals`	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.
`place_cart_order`	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_order`	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.
`search_products`	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.
`shop_and_deliver`	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.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "store.buynearby/mcp",
  "title": "BuyNearby",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://buynearby.store/api/v1/mcp-server.php",
      "type": "streamable-http",
      "headers": [
        {
          "name": "X-API-Key",
          "isSecret": true,
          "description": "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."
        }
      ]
    }
  ],
  "version": "1.0.0",
  "description": "Shop BuyNearby's local Calgary marketplace, book couriers, and request personal shopping runs."
}