A
security-
licenseA
qualityA 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
The Bargainer MCP Server is a Model Context Protocol server that enables users to find, aggregate, filter, and compare deals from multiple sources (including Slickdeals, RapidAPI, and web scraping) through natural language commands in a chat interface.
Key capabilities:
Search Deals: Find deals using keywords, stores, categories, price ranges, and minimum ratings
Get Top Deals: Retrieve trending deals from all or specific sources with configurable limits
Filter Deals: Apply advanced filtering criteria like tags, stores, categories, price range, and rating range
Get Deal Details: Fetch detailed information about specific deals using their unique ID
Compare Deals: Compare similar deals to identify the best options based on your criteria
Get Available Sources: List all configured deal sources to understand where deals are being pulled from
Interactive Chat Interface: Access all functionality through a web-based chat interface using natural language commands
Provides the web server functionality for hosting the chat interface and API endpoints.
Provides integration for repository access, contribution management, and issue tracking for the Bargainer MCP client.
Serves as the runtime environment for the Bargainer MCP server with support for Node.js 18+.
Integrates with the RapidAPI marketplace for finding and comparing deals across multiple sources.
Enables real-time messaging in the web-based chat interface for interactive deal searching.
Powers the fully typed codebase with strict type checking for improved development experience.
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
BaseDealProviderImplement 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!
Related MCP Servers
- Asecurity-licenseAqualityA Model Context Protocol server that enables web search, scraping, crawling, and content extraction through multiple engines including SearXNG, Firecrawl, and Tavily.Last updated -42857MIT License
- -security-license-qualityA Model Context Protocol server that enables price lookup and trading across multiple cryptocurrency exchanges including Upbit, Gate.io, and Binance.Last updated -10MIT License
- -security-license-qualityA 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 -