v0.4.0 — stdio proxy to the hosted MCP server

The package no longer reimplements tools. tools/list and tools/call forward to https://api.buywhere.ai/mcp and return responses verbatim, so the stdio package and the hosted server expose the same contract by construction (13 tools, including the v2 family).

Previously the package hardcoded 7 v1 tools and drifted from the hosted server — an agent comparing the two saw different products.

v0.3.17 — Scorecard tools + description fix

Scorecard improvement + MCP Registry description fix (<100 chars). NPM publish required.

v0.3.16 — Point MCP Registry to NPM 0.3.11

Fix: align server.json with actual published NPM version 0.3.11

v0.3.15 — Align MCP Registry version with NPM

Fix: align server.json version with NPM package version (0.3.14→0.3.15)

v0.3.14 — Scorecard tools + MCP Registry description fix

Changes

• Add agent-manifest, capabilities, data-inventory, connection-status discovery tools
• Add readOnlyHint, idempotentHint, openWorldHint annotations
• Add smoke test script
• Fix MCP Registry description (<100 chars)
• Expected scorecard: 55 → 95+

v0.3.13 — Scorecard tools + MCP Registry fix

Changes

• Add agent-manifest, capabilities, data-inventory, connection-status discovery tools
• Add readOnlyHint, idempotentHint, openWorldHint annotations to all read tools
• Add smoke test script
• Fix MCP Registry description (<=100 chars)
• Expected scorecard improvement: 55 → 95+

v0.3.12 — Scorecard improvement (55→95+)

Changes

• Add agent-manifest, capabilities, data-inventory, connection-status discovery tools
• Add readOnlyHint, idempotentHint, openWorldHint annotations to all read tools
• Add smoke test script
• Expected scorecard improvement: 55 → 95+

v1.0.4 — Authorization: Bearer auth fix

v1.0.4 — Authorization: Bearer auth fix

Bug fix

• MCP server source updated from X-API-Key to Authorization: Bearer <key> (BUY-42672)
• The live API at api.buywhere.ai only accepts Bearer auth — X-API-Key was returning 401
• dist/index.js rebuilt with the auth fix
• Resolves the user-facing community issue BuyWhere/buywhere-mcp#18

Source changes

• src/index.ts lines 67, 88: "X-API-Key": API_KEY! → Authorization: \Bearer ${API_KEY!}``
• dist/index.js rebuilt
• package.json version: 1.0.3 → 1.0.4

Verified

• npm run typecheck clean
• npm run build succeeds
• mcp-publisher validate passes against the official MCP Registry schema

What ships automatically

• The Publish to MCP Registry workflow triggers on this release event
• It uses GitHub OIDC to authenticate and mcp-publisher publish
• This will make v1.0.4 discoverable in MCP client registries (Claude Desktop, Cursor, etc.)

What does NOT ship automatically

• npm publish still requires manual NPM_TOKEN (board action via BUY-43187)
• Until npm ships, users running npx -y @buywhere/mcp-server still get the old v0.3.11

v1.0.0 — BuyWhere MCP Server

v1.0.0 — BuyWhere MCP Server

Initial public release. BuyWhere exposes 6 MCP tools (search_products, get_product, get_price, compare_prices, get_affiliate_link, get_catalog) over the Model Context Protocol for AI agents to search and compare products across 11M+ SKUs in Singapore, Southeast Asia, and US markets.

Get a free API key

Get a free BuyWhere API key in 60 seconds at https://buywhere.ai/api-keys — no credit card, no sales call, and 1,000 free lookups per month.

Quickstart

# npm
npx @buywhere/mcp-server

# Or via the official MCP Registry
claude mcp add buywhere -- npx @buywhere/mcp-server

What ships

• 6 tools across catalog discovery, product lookup, price comparison, and affiliate linking
• Bearer auth (Authorization: Bearer ) — server validates and proxies to api.buywhere.ai
• Cross-border coverage: SG, MY, TH, PH, ID, VN, US (more regions shipping in v0.3.10+)
• npm: @buywhere/mcp-server
• MCP Registry: io.github.BuyWhere/buywhere-mcp
• Source: BuyWhere/buywhere-mcp

Resources

• API key: https://buywhere.ai/api-keys
• Docs: https://buywhere.ai/quickstart
• Blog: https://buywhere.ai/blog
• Demos + recipes: https://buywhere.ai/blog/build-an-ai-shopping-agent-with-buywhere-in-5-minutes

For AI agent developers: the API key signup is the fastest path to a working BuyWhere integration. Free tier covers 1,000 lookups/month across 11M+ SKUs.

v0.3.4

What's fixed

• Workflow permissions: Added id-token: write for OIDC auth with MCP Registry
• Server description: Shortened to ≤100 chars per MCP Registry validation
• Server namespace: Changed to io.github.BuyWhere/buywhere-mcp to match GitHub OIDC namespace
• NPM package: Published @buywhere/mcp-server@0.3.4 with corrected mcpName
• Repo config: Updated server.json and package.json for consistency

Publishing to MCP Registry automatically via CI.