BuyWhere MCP Quickstart

Connect BuyWhere to Claude Desktop, Cursor, and any MCP-compatible AI agent in under 5 minutes.

No server hosting required. BuyWhere MCP tools run entirely on your local machine.

---

1. Install the Package

npm install @buywhere/mcp-tools

Requirements:

• Node.js 18+
• A BuyWhere API key (get one free)

---

2. Configure Claude Desktop

Open your Claude Desktop config file:

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

Add the BuyWhere MCP server:

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

Restart Claude Desktop completely.

---

3. Start Using BuyWhere

Ask Claude:

Search for wireless headphones under SGD 100 on BuyWhere

Compare prices for iPhone 15 Pro across Singapore retailers

Find me the best deal on Nintendo Switch OLED

Claude will call BuyWhere tools directly and return formatted results.

---

Available Tools

The MCP server exposes these tools via https://api.buywhere.ai/mcp:

---

4. Test with a Simple Query

After restarting Claude, verify the connection:

What tools do you have available from BuyWhere?

You should see all 5 BuyWhere tools listed.

---

5. Python Integration

For custom agents, use the MCP SDK directly:

pip install mcp

import asyncio
from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

async def main():
    server_params = StdioServerParameters(
        command="npx",
        args=["-y", "@buywhere/mcp-tools"],
        env={"BUYWHERE_API_KEY": "your_api_key"}
    )
    
    async with stdio_client(server_params) as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()
            
            result = await session.call_tool(
                "search_products",
                arguments={"q": "laptop", "limit": 5}
            )
            print(result.content)

asyncio.run(main())

---

Configuration

---

Troubleshooting

Tools not appearing in Claude

1. Restart Claude Desktop completely (not just the chat)
2. Verify your API key is valid at buywhere.ai/api
3. Check Claude's logs: ~/.config/Claude/logs/

"Server not found" errors

Ensure you have Node.js 18+ installed:

node --version

Authentication errors

Verify your API key starts with bw_live_ or bw_free_ and is active.

---

Next Steps

• MCP Integration Guide — Detailed setup for ChatGPT, custom agents
• MCP Deployment Guide — Self-host the MCP server
• API Reference — Full API documentation
• US Quickstart — Query US products

---

Supported Regions

Default: SG (Singapore)

---

Questions? Email api@buywhere.ai