# io.github.IsaiahDupree/commercebridge (remote · commercebridge-isaiahduprees-projects.vercel.app)

Remote MCP connector for eBay, Shopify, Best Buy & Etsy marketplace data via the Commerce API

- Trust score: 70/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `commercebridge-isaiahduprees-projects.vercel.app`: 70/100 (this document), [markdown](https://verifymcp.io/servers/isaiahdupree-commercebridge/api-mcp.md), [page](https://verifymcp.io/servers/isaiahdupree-commercebridge/api-mcp)

## Channel facts

- Endpoint: `https://commercebridge-isaiahduprees-projects.vercel.app/api/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 80/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 61/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 1833 tokens (~130/item across 14 items; 14 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 7/100
  - Stability observed for 2 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 94/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 82% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http isaiahdupree-commercebridge https://commercebridge-isaiahduprees-projects.vercel.app/api/mcp
```

### Codex

```toml
[mcp_servers.isaiahdupree-commercebridge]
url = "https://commercebridge-isaiahduprees-projects.vercel.app/api/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "isaiahdupree-commercebridge": {
      "type": "remote",
      "url": "https://commercebridge-isaiahduprees-projects.vercel.app/api/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add isaiahdupree-commercebridge --url https://commercebridge-isaiahduprees-projects.vercel.app/api/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  isaiahdupree-commercebridge:
    url: "https://commercebridge-isaiahduprees-projects.vercel.app/api/mcp"
```

### Other

```json
{
  "mcpServers": {
    "isaiahdupree-commercebridge": {
      "type": "http",
      "url": "https://commercebridge-isaiahduprees-projects.vercel.app/api/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 70, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-02 (score 69, 0)

- [functional improvement] Stability: unverified → 0.03

### 2026-08-01 (score 69)

First indexed and scored.

## MCP tools (14)

### `search_ebay` (~251 tokens)

Search eBay listings

Search live eBay listings by keyword and/or category across 8 sites (US, GB, DE, AU, CA, FR, IT, ES), built on eBay's official Browse API. Returns id, title, price, condition, seller feedback, shipping, image, categories, and URL per listing. Returns an honest `credentials_required` error until the upstream deployment has EBAY_CLIENT_ID/EBAY_CLIENT_SECRET provisioned.

Input parameters:

- `buyingOptions` (string): FIXED_PRICE and/or AUCTION, comma-separated.
- `category` (string): eBay category id(s) to constrain the search.
- `condition` (string): Condition enum(s), comma-separated (e.g. NEW,USED).
- `country` (string): Default us.
- `currency` (string): Default USD.
- `freeShipping` (boolean)
- `limit` (integer): Default 20.
- `offset` (integer): Default 0.
- `priceMax` (number)
- `priceMin` (number)
- `q` (string): Keyword query. Required unless `category` is given.
- `sort` (string): `price` = ascending, `-price` = descending.

### `get_ebay_item` (~128 tokens)

Get one eBay item

Get one eBay item's full detail — description, brand/MPN/GTIN, color, item specifics, images, return terms, availability, item end date — by REST item id or legacy numeric id. Returns an honest `credentials_required` error until the upstream deployment has eBay app credentials provisioned.

Input parameters:

- `country` (string): Default us.
- `id` (string): eBay REST item id, e.g. v1|256801234567|0.
- `legacy_id` (string): Legacy numeric item id (used when `id` is omitted).

### `get_ebay_items` (~85 tokens)

Get up to 20 eBay items in one call

Bulk-fetch full item detail for up to 20 eBay items in a single call, given comma-separated item ids. Returns an honest `credentials_required` error until the upstream deployment has eBay app credentials provisioned.

Input parameters:

- `country` (string): Default us.
- `item_ids` (string, required): Comma-separated eBay item ids (max 20). Required.

### `search_ebay_sold` (~87 tokens)

Search sold/completed eBay listings (Marketplace Insights)

Sold/completed-item price comps. This needs eBay's Marketplace Insights API, which is a limited-release approval separate from the base Browse API. Until that is enabled on the upstream deployment, this always returns a 501 `not_enabled` gate rather than a fabricated result — that is expected, honest behavior, not a bug.

Input parameters:

- `q` (string): Keyword query.

### `search_shopify_products` (~112 tokens)

List a Shopify store's catalog

List any public Shopify store's product catalog straight from that store's own /products.json — no keys, no auth, works today. Returns title, vendor, product type, tags, price range, variants, images, and URL per product. Pass a bare storefront domain, e.g. `allbirds.com`.

Input parameters:

- `limit` (integer): Default 50.
- `page` (integer): Default 1.
- `store` (string, required): Shopify store domain, e.g. allbirds.com. Required.

### `get_shopify_product` (~71 tokens)

Get one Shopify product by handle

Get one product from a public Shopify store by its handle (slug), from that store's own /products.json — keyless, live now.

Input parameters:

- `handle` (string, required): Product handle (slug). Required.
- `store` (string, required): Shopify store domain, e.g. allbirds.com. Required.

### `get_shopify_collections` (~76 tokens)

List a Shopify store's collections

List a public Shopify store's collections (id, handle, title, product count, image) — keyless, live now.

Input parameters:

- `limit` (integer): Default 50.
- `page` (integer): Default 1.
- `store` (string, required): Shopify store domain, e.g. allbirds.com. Required.

### `search_shopify` (~83 tokens)

Keyword-filter a Shopify store's catalog

Filter a public Shopify store's catalog by keyword across title, vendor, product type, and tags — keyless, live now.

Input parameters:

- `limit` (integer): Default 50.
- `q` (string, required): Keyword filter, e.g. "wool runner". Required.
- `store` (string, required): Shopify store domain, e.g. allbirds.com. Required.

### `search_bestbuy` (~172 tokens)

Search Best Buy's product catalog

Search Best Buy's US product catalog by keyword and/or category, built on Best Buy's official Products API. Returns sku, title, sale/regular price, rating, manufacturer/model, image, online/in-store availability, and UPC per product. Errors honestly until this engine is fully live upstream: currently returns `not_found` (route not yet redeployed on the production commerce-api), then `credentials_required` once deployed without BESTBUY_API_KEY provisioned.

Input parameters:

- `category` (string): Best Buy categoryPath.id to constrain the search.
- `limit` (integer): Default 20. Best Buy caps page size at 100.
- `page` (integer): Default 1.
- `q` (string): Keyword query. Required unless `category` is given. Matches across name, manufacturer, and description.

### `get_bestbuy_product` (~84 tokens)

Get one Best Buy product by SKU

Get one Best Buy product by SKU, full detail. Errors honestly until this engine is fully live upstream: currently returns `not_found` (route not yet redeployed on the production commerce-api), then `credentials_required` once deployed without BESTBUY_API_KEY provisioned.

Input parameters:

- `sku` (string, required): Best Buy SKU, e.g. 6418599. Required.

### `search_etsy` (~264 tokens)

Search Etsy's site-wide active listings

Search Etsy's site-wide active listings by keyword, built on Etsy's official Open API v3 (app-only, no OAuth). Returns title, description, price, quantity, tags/materials, favorites, images, and shop per listing. Errors honestly until this engine is fully live upstream: currently returns `not_found` (route not yet redeployed on the production commerce-api), then `credentials_required` once deployed without ETSY_KEYSTRING/ETSY_SHARED_SECRET provisioned.

Input parameters:

- `buyer_country` (string): ISO 3166-1 alpha-2 — filters to listings that ship there.
- `currency` (string): ISO 4217 code to convert listing prices into.
- `is_safe` (boolean): When true, filters out mature/adult content.
- `limit` (integer): Default 20. Etsy caps limit at 100.
- `max_price` (number)
- `min_price` (number)
- `offset` (integer): Default 0.
- `q` (string, required): Keyword query, e.g. "macrame wall hanging". Required.
- `shop_location` (string)
- `sort_on` (string)
- `sort_order` (string)
- `taxonomy_id` (string): Etsy seller-taxonomy category id.

### `get_etsy_listing` (~146 tokens)

Get one Etsy listing by id

Get one Etsy listing by id, full detail — the only endpoint where Etsy's API populates `views` (search and shop-listings results always have `views: null`, since Etsy doesn't carry that field there). Errors honestly until this engine is fully live upstream: currently returns `not_found` (route not yet redeployed on the production commerce-api), then `credentials_required` once deployed without ETSY_KEYSTRING/ETSY_SHARED_SECRET provisioned.

Input parameters:

- `language` (string): IETF language tag, e.g. de, en, es, fr.
- `listing_id` (string, required): Etsy listing id, e.g. 1234567890. Required.

### `get_etsy_shop` (~125 tokens)

Get one Etsy shop

Get one Etsy shop by shop_id or shop_name — name, listing counts, favorites, total sold, aggregate review count/average. Errors honestly until this engine is fully live upstream: currently returns `not_found` (route not yet redeployed on the production commerce-api), then `credentials_required` once deployed without ETSY_KEYSTRING/ETSY_SHARED_SECRET provisioned.

Input parameters:

- `shop_id` (string): Etsy shop id, e.g. 12345678.
- `shop_name` (string): Used when shop_id is omitted, e.g. PaperGoodsCo.

### `get_etsy_shop_listings` (~149 tokens)

List a shop's active Etsy listings

List one Etsy shop's active listings, optionally keyword-filtered within the shop. Errors honestly until this engine is fully live upstream: currently returns `not_found` (route not yet redeployed on the production commerce-api), then `credentials_required` once deployed without ETSY_KEYSTRING/ETSY_SHARED_SECRET provisioned.

Input parameters:

- `limit` (integer): Default 20.
- `offset` (integer): Default 0.
- `q` (string): Keyword filter within the shop.
- `shop_id` (string): Etsy shop id.
- `shop_name` (string): Used when shop_id is omitted.
- `sort_on` (string)
- `sort_order` (string)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/isaiahdupree-commercebridge/api-mcp#diagnostics

## Score history

- 2026-08-03: 70
- 2026-08-02: 69
- 2026-08-01: 69

## Links

- Remote endpoint: https://commercebridge-isaiahduprees-projects.vercel.app/api/mcp
- Repository: https://github.com/IsaiahDupree/commercebridge
- Website: https://commercebridge-isaiahduprees-projects.vercel.app/
- Changelog RSS feed: https://verifymcp.io/servers/isaiahdupree-commercebridge/api-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/isaiahdupree-commercebridge/api-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/isaiahdupree-commercebridge/api-mcp