UnifiedOffer/mcp-server-public

🌐 Universal MCP Server

AI-powered e-commerce integration for intelligent shopping assistants

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 - Natural language queries across all connected platforms
• 💰 Price Negotiation - Intelligent pricing with automatic discount generation
• 🔗 Smart Links - Direct product links with automatic discount application
• 🤖 Multi-LLM Support - Works with 6 AI providers (OpenAI, Anthropic, Google, Mistral, Cohere, Groq)
• 🧵 Thread Management - Persistent conversations with 24h expiry
• 🌍 Multi-Currency - Supports 12 currencies (EUR, USD, GBP, CHF, etc.)
• ⚡ Production-Ready - 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

🛠️ Available Tools

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

📚 Documentation

Getting Started

• - API key setup
• - First steps
• - Integration examples

API Reference

• - 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

💡 Use Cases

AI Shopping Assistants

// 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'
    }
  })
});

Price Comparison Tools

# 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']
        }
    }
)

E-Commerce Integration

# Generate product links with automatic discounts
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": "generateLinks",
    "arguments": {
      "productIds": ["prod_abc", "prod_def"]
    }
  }'

🔐 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 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