🌐 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

Tool	Description	Latency	Complexity
searchProducts	Search products across all platforms	~1.7s	Medium
generateLinks	Create direct product links with discounts	~2.1s	Medium
negotiatePrice	Intelligent price negotiation	~2.3s	High
negotiateBatch	Competitive batch pricing	~2.8s	High
negotiateMultiRound	Progressive multi-round negotiation	~3.2s	High
chat	AI shopping assistant (6 LLM providers)	~5.7s	High
listThreads	List conversation threads	~0.6s	Low
getThread	Retrieve thread history	~0.8s	Low
extendThread	Extend thread expiration	~0.8s	Low

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

Platform	Product Sync	Discount Codes	Webhooks	Status
Shopify	✅	✅	✅	Production
WooCommerce	✅	✅	✅	Production
Shopware 6	✅	✅	✅	Production
Magento	⏳	⏳	⏳	Planned

---

💡 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

Tool Category	Limit	Tools
Light	100 req/min	listThreads, getThread, extendThread
Standard	60 req/min	searchProducts, generateLinks
Heavy	30 req/min	negotiatePrice, chat
Batch	20 req/min	negotiateBatch, negotiateMultiRound

---

🌐 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):

Provider	Models	Features
OpenAI	GPT-5, GPT-4.1, GPT-4o series (8 models)	Best function calling, JSON mode
Anthropic	Claude Sonnet 4.5, Opus 4.1, Claude 3.5 (5 models)	Best coding, 1M context
Google	Gemini 2.5 Pro, 2.5 Flash, 2.0 Flash (5 models)	Best price-performance
Mistral	Medium 3, Devstral Small, Large/Small (6 models)	Multilingual support
Cohere	Command A, Aya Expanse (5 models)	23 languages
Groq	OpenAI GPT-OSS, Llama 4 Vision (12 models)	Ultra-fast inference

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

Channel	Package	Status
NPM	@unifiedoffer/mcp-server	✅ v2.0.4
PyPI	uop-mcp-server	✅ v2.0.5
Docker Hub	unifiedoffer/mcp-server	✅ v2.0.0
GitHub MCP Registry	io.github.Chris85appding/unified-offer-protocol	✅ v2.0.5
PulseMCP	Auto-indexing	⏳ Pending
MCP.so	Manual submission	⏳ Pending

---

🤝 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