MCP Integration

BuyWhere works natively with Claude Desktop, Cursor, Windsurf, and any Model Context Protocol (MCP) client. This guide shows you how to set it up.

What You Get

Once connected, your AI agent has access to these tools:

Setup: Claude Desktop

1. Get a BuyWhere API key at buywhere.ai/api-keys

2. Open your Claude Desktop config file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. Add the BuyWhere MCP server:

{
  "mcpServers": {
    "buywhere": {
      "command": "npx",
      "args": ["-y", "@buywhere/mcp-server"],
      "env": {
        "BUYWHERE_API_KEY": "bw_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

1. Restart Claude Desktop.

Setup: Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "buywhere": {
      "command": "npx",
      "args": ["-y", "@buywhere/mcp-server"],
      "env": {
        "BUYWHERE_API_KEY": "bw_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Setup: Claude Code

Add to your Claude Code MCP settings:

{
  "mcpServers": {
    "buywhere": {
      "command": "npx",
      "args": ["-y", "@buywhere/mcp-server"],
      "env": {
        "BUYWHERE_API_KEY": "bw_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Try It

Once connected, ask your AI agent:

"Find me the cheapest wireless headphones in Singapore under $200"

"Compare the Sony WH-1000XM5 with the Bose QuietComfort Ultra"

"What are the best electronics deals right now?"

"Track the price history for this laptop over the last 30 days"

The agent will automatically use BuyWhere's tools to search products, compare prices, and find deals.

Using the TypeScript SDK

For programmatic agent integrations, use the TypeScript SDK:

npm install @buywhere/sdk

const client = new BuyWhereClient({
  apiKey: process.env.BUYWHERE_API_KEY,
});

const results = await client.search.search({
  q: "mechanical keyboard",
  country_code: "SG",
  limit: 5,
});

console.log(results.products);

Using the LangChain Integration

npm install @buywhere/buywhere-langchain

const tools = new BuyWhereTools({
  apiKey: process.env.BUYWHERE_API_KEY,
});

// Use with any LangChain agent
const agent = createAgent({
  tools: tools.getTools(),
  // ...
});

OpenAI Function Calling

Use the OpenAPI spec directly for OpenAI function calling:

GET https://api.buywhere.ai/openapi.json

A ChatGPT Actions-compatible version is available at:

GET https://api.buywhere.ai/chatgpt-openapi.json

Discovery Endpoints

BuyWhere exposes standard discovery endpoints for AI agent platforms:

Next Steps

• Getting Started — get your API key and make your first call
• API Reference — full endpoint documentation
• Build a Price Comparison Tool — Python quickstart