MCP Server Public

🚀 Universal MCP Server

AI-powered e-commerce integration for intelligent shopping assistants

This project enables seamless connection of AI applications to multiple e - commerce platforms. It offers features like automatic product search, price negotiation, and intelligent discount generation through the Model Context Protocol.

Connect your AI applications to 3+ e - commerce platforms (Shopify, WooCommerce, Shopware 6) with automatic product search, price negotiation, and intelligent discount generation through the Model Context Protocol.

✨ Features

• 🔍 Product Search: Conduct natural language queries across all connected platforms.
• 💰 Price Negotiation: Enjoy intelligent pricing with automatic discount generation.
• 🔗 Smart Links: Get direct product links with automatic discount application.
• 🤖 Multi - LLM Support: Works with 6 AI providers (OpenAI, Anthropic, Google, Mistral, Cohere, Groq).
• 🧵 Thread Management: Maintain persistent conversations with 24 - hour expiry.
• 🌍 Multi - Currency: Supports 12 currencies (EUR, USD, GBP, CHF, etc.).
• ⚡ Production - Ready: Offers enterprise - grade performance and security.
• 🆓 Free to Use: No fees, no commissions, open for everyone.

🚀 Quick Start

Option 1: Direct HTTP API (Recommended)

# Get your free API key at https://unifiedoffer.com
curl -X POST https://api.unifiedoffer.com/functions/v1/mcp-http-wrapper \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "searchProducts",
    "arguments": {
      "query": "gaming laptop under $1500",
      "limit": 5
    }
  }'

Option 2: NPM Package

npm install @unifiedoffer/mcp-server

Option 3: PyPI Package

pip install uop-mcp-server

Option 4: Docker

docker pull unifiedoffer/mcp-server:latest
docker run -p 8080:8080 -e UOP_API_KEY=your_key unifiedoffer/mcp-server

💻 Usage Examples

Basic Usage

// Natural language product search
const response = await fetch('https://api.unifiedoffer.com/functions/v1/mcp-http-wrapper', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    tool: 'chat',
    arguments: {
      message: 'I need a laptop for video editing under $2000',
      configName: 'openai-gpt-4o'
    }
  })
});

Advanced Usage

# Compare multiple products competitively
import requests

response = requests.post(
    'https://api.unifiedoffer.com/functions/v1/mcp-http-wrapper',
    headers={'x-api-key': 'YOUR_API_KEY'},
    json={
        'tool': 'negotiateBatch',
        'arguments': {
            'productIds': ['prod_123', 'prod_456', 'prod_789']
        }
    }
)

🛠️ Available Tools

Average Response Time: 2.2s | Success Rate: 100%

📚 Documentation

Getting Started

• Authentication Guide - API key setup
• Quick Start Guide - First steps
• Code Examples - Integration examples

API Reference

• Tool Specifications - Complete MCP manifest
• OpenAPI Spec - REST API docs

Advanced Topics

• Multi - LLM Configuration - Provider setup
• Thread Management - Conversation persistence
• Rate Limits - Usage quotas

🌍 Supported Platforms

🔐 Authentication

Get your free API key at https://unifiedoffer.com

Two key types available:

• Developer Keys (dk_*) - Search across ALL shops, optimize for customer value
• Merchant Keys (mk_*) - Shop - scoped search, optimize for merchant margin

Usage:

# Standard header (recommended)
-H "x-api-key: dk_YOUR_API_KEY"

# Alternative authorization header
-H "X-Authorization: Bearer dk_YOUR_API_KEY"

# Query parameter (fallback)
?api_key=dk_YOUR_API_KEY

⚡ Rate Limits

🌐 Multi - Currency Support

Automatic currency handling for 12 currencies:

EUR (€) • USD ($) • GBP (£) • CHF (CHF) • CAD (C$) • AUD (A$) • JPY (¥) • SEK (kr) • NOK (kr) • DKK (kr) • PLN (zł) • CZK (Kč)

Minimum discounts automatically adjusted per currency (e.g., €1.00, $1.00, £0.85).

🤖 AI Provider Support

Works seamlessly with 6 LLM providers (40+ models):

BYOK Model: Bring Your Own Key - use your own LLM API keys for zero cost.

🏗️ Architecture

┌─────────────────┐
│   AI App/Agent  │
└────────┬────────┘
         │ MCP Protocol (HTTP/WebSocket)
         ▼
┌─────────────────┐
│  MCP Server     │
│  (Edge Func)    │
└────────┬────────┘
         │ REST API
         ▼
┌─────────────────────────────────┐
│  Product Database (PostgreSQL)  │
│  - Shopify Products             │
│  - WooCommerce Products         │
│  - Shopware Products            │
└─────────────────────────────────┘

📊 Performance

• Uptime: 99.9%
• Average Latency: 2.2s
• Success Rate: 100%
• Concurrent Requests: 1000+
• Database: Enterprise PostgreSQL with 145+ optimized indexes

🔒 Security

• ✅ API keys hashed before storage
• ✅ 170 active Row - Level Security policies
• ✅ Rate limiting with fail - safe defaults
• ✅ CORS properly configured
• ✅ Zero secrets in responses
• ✅ Grade A+ security audit

📦 Distribution Channels

🤝 Support & Community

• Website: https://unifiedoffer.com
• Documentation: https://unifiedoffer.com/mcp
• API Endpoint: https://api.unifiedoffer.com/functions/v1/mcp-http-wrapper
• Email: support@unifiedoffer.com
• Issues: https://github.com/UnifiedOffer/mcp-server-public/issues

📄 License

MIT License - see LICENSE for details.

🎯 Roadmap

v2.1 (Q1 2026)

• [ ] Magento platform integration
• [ ] Real - time inventory sync
• [ ] Enhanced batch negotiation strategies
• [ ] WebSocket transport layer

v2.2 (Q2 2026)

• [ ] Multi - region deployment
• [ ] GraphQL API endpoint
• [ ] Enhanced analytics dashboard
• [ ] Custom LLM fine - tuning

🌟 Why Choose UOP MCP Server?

✅ Production - Ready: Enterprise - grade performance and security
✅ Zero Setup: Direct HTTP API, no complex configuration
✅ Multi - Platform: Works with Shopify, WooCommerce, Shopware 6
✅ Cost - Effective: BYOK model, pay only for what you use
✅ Fully Featured: 9 tools covering search, negotiation, links, chat
✅ Well - Documented: Comprehensive guides and examples
✅ Open Source: MIT License, community - driven
✅ 100% Free: No fees, no commissions, no hidden costs

Built with ❤️ by the Unified Offer Protocol Team
Get Started Free • Documentation • Report Bug