Unified Offer Protocol MCP Server

Install

Config snippet generator goes here (5 client tabs)

README

# 🌐 Universal MCP Server

**AI-powered e-commerce integration for intelligent shopping assistants**

[![NPM Version](https://img.shields.io/npm/v/@unifiedoffer/mcp-server.svg)](https://www.npmjs.com/package/@unifiedoffer/mcp-server)
[![PyPI Version](https://img.shields.io/pypi/v/uop-mcp-server.svg)](https://pypi.org/project/uop-mcp-server/)
[![Docker Pulls](https://img.shields.io/docker/pulls/unifiedoffer/mcp-server.svg)](https://hub.docker.com/r/unifiedoffer/mcp-server)
[![MCP Protocol](https://img.shields.io/badge/MCP-v2024--11--05-blue)](https://modelcontextprotocol.io)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE)

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)

```bash
# 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

```bash
npm install @unifiedoffer/mcp-server
```

### Option 3: PyPI Package

```bash
pip install uop-mcp-server
```

### Option 4: Docker

```bash
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](./docs/authentication.md) - API key setup
- [Quick Start Guide](./docs/quick-start.md) - First steps
- [Code Examples](./docs/examples.md) - Integration examples

### API Reference
- [Tool Specifications](./mcp.json) - Complete MCP manifest
- [OpenAPI Spec](https://api.unifiedoffer.com/functions/v1/mcp-openapi-spec) - REST API docs

### Advanced Topics
- [Multi-LLM Configuration](https://unifiedoffer.com/docs/llm) - Provider setup
- [Thread Management](https://unifiedoffer.com/docs/threads) - Conversation persistence
- [Rate Limits](https://unifiedoffer.com/docs/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
```javascript
// 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
```python
# 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
```bash
# Generate product links with automatic discounts
curl -X POST htt