Bargainer MCP Client 🛍️

A powerful Model Context Protocol (MCP) client for finding and comparing deals from multiple sources including Slickdeals, RapidAPI marketplace, and web scraping. Features a modern web-based chat interface for interactive deal searching.

Features ✨

Multi-Source Deal Aggregation: Integrates with Slickdeals API, RapidAPI marketplace, and web scraping
Interactive Chat Interface: Modern web UI with real-time messaging via Socket.IO
Intelligent Deal Filtering: Filter by price, rating, store, and category
Deal Comparison: Compare deals across multiple sources
MCP Protocol Integration: Full Model Context Protocol implementation with 6 specialized tools
Provider Pattern Architecture: Extensible design for adding new deal sources
TypeScript: Fully typed codebase with strict type checking

Quick Start 🚀

Prerequisites

Node.js 18+
npm or yarn
API keys for external services (optional, fallback to mock data)

Installation

# Clone the repository git clone https://github.com/karthiksivaramms/bargainer-mcp-client.git cd bargainer-mcp-client # Install dependencies npm install # Build the project npm run build

Usage

Web Chat Interface

# Start the web interface npm run web # Or with auto-reload for development npm run dev:web

Then open http://localhost:3001 in your browser and start chatting!

MCP Server

# Start the MCP server npm run dev # Or run the built version npm start

Demo & Testing

# Run interactive demo npm run demo # Test the server npm run test:server

Available Commands 💬

Use these natural language commands in the chat interface:

Search deals: "Find laptop deals under $500"
Get top deals: "Show me today's top electronics deals"
Filter deals: "Gaming headphones under $100 with 4+ stars"
Deal details: "Tell me more about this iPhone deal"
Compare deals: "Compare iPad deals across sources"
List sources: "What deal sources are available?"

MCP Tools 🛠️

The server provides 6 specialized tools:

search_deals - Search for deals by product name or keywords
get_top_deals - Get trending deals from all sources
filter_deals - Filter deals by price, rating, store, category
get_deal_details - Get detailed information about specific deals
compare_deals - Compare deals across multiple sources
get_available_sources - List all configured deal sources

Architecture 🏗️

src/ ├── server.ts # Main MCP server ├── providers/ # Deal source providers │ ├── base.ts # Base provider interface │ ├── slickdeals.ts # Slickdeals API provider │ ├── rapidapi.ts # RapidAPI marketplace provider │ └── webscraping.ts # Web scraping provider ├── services/ │ └── aggregator.ts # Deal aggregation service └── types/ # TypeScript type definitions ui/ ├── index.html # Chat interface ├── chat-interface.js # Frontend JavaScript └── server.js # Express server with Socket.IO test/ # Test files scripts/ # Utility scripts

Contributing 🤝

Contributions are welcome! Please feel free to submit a Pull Request.

Development Setup

# Install dependencies npm install # Start development with auto-reload npm run dev # Start web interface with auto-reload npm run dev:web # Run linting npm run lint # Format code npm run format

Adding New Deal Sources

Create a new provider in src/providers/
Extend BaseDealProvider
Implement required methods
Register in aggregator.ts

API Documentation 📚

Deal Object Structure

interface Deal { id: string; title: string; price: number; originalPrice?: number; discount?: number; rating?: number; store: string; url: string; imageUrl?: string; description?: string; category?: string; source: string; timestamp: Date; }

License 📄

This project is licensed under the MIT License - see the LICENSE file for details.

Author 👨‍💻

Karthik Sivaram M

GitHub: @karthiksivaramms

Support 💡

If you have any questions or run into issues, please open an issue on GitHub.

Roadmap 🗺️

More deal source integrations
Deal alerts and notifications
Price history tracking
Advanced filtering options
Mobile app version
Deal sharing features

Made with ❤️ for bargain hunters everywhere!

Deploy Server

HTTP connection URL

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

A Model Context Protocol server that aggregates and compares deals from multiple sources including Slickdeals, RapidAPI marketplace, and web scraping, enabling users to search, filter, and compare deals through a chat interface.

Related Resources

Reddit Discussion about this server

Related MCP Servers

BigGo MCP Server
Funmula-Corp
A
security
A
license
A
quality
A Model Context Protocol server enabling product searches across e-commerce platforms, price history tracking, and product specification-based searches using natural language prompts.
Last updated -
2
14
MIT License
OneSearch MCP Server
yokingma
A
security
A
license
A
quality
A Model Context Protocol server that enables web search, scraping, crawling, and content extraction through multiple engines including SearXNG, Firecrawl, and Tavily.
Last updated -
4
28
57
MIT License
Crypto Trading MCP
vkdnjznd
-
security
A
license
-
quality
A Model Context Protocol server that enables price lookup and trading across multiple cryptocurrency exchanges including Upbit, Gate.io, and Binance.
Last updated -
10
MIT License
E-commerce MCP Server
Noyonchandrasaha
-
security
F
license
-
quality
A Model Context Protocol server that provides real-time access to MongoDB product data, enabling sophisticated e-commerce queries with price range filters, category searching, and product recommendations through a conversational interface.
Last updated -

View all related MCP servers

Bargainer MCP Server