# MCP Products Server

Products Marketplace MCP Server for the Trading Platform. Manages product catalog, purchases, and delivery.

## Features

- **Product Catalog**: ML predictions, agent access, education, and more
- **Purchase System**: Wallet + Stripe payment support
- **Automatic Delivery**: Prediction credits, agent access grants
- **VIP Products**: Exclusive items for VIP subscribers
- **Search & Filtering**: Full-text search, category, price filters

## Quick Start

```bash
npm install
cp .env.example .env
npm run dev
```

## API Endpoints

### Products
- `GET /api/v1/products` - List with filters
- `GET /api/v1/products/featured` - Featured products
- `GET /api/v1/products/vip` - VIP-only products
- `GET /api/v1/products/predictions` - ML prediction products
- `GET /api/v1/products/agents` - Agent access products
- `GET /api/v1/products/search?q=...` - Search
- `GET /api/v1/products/category/:category` - By category
- `GET /api/v1/products/:id` - Get by ID
- `GET /api/v1/products/:id/availability` - Check stock
- `GET /api/v1/products/:id/related` - Related products

### Purchases
- `POST /api/v1/purchases/calculate` - Preview purchase
- `POST /api/v1/purchases` - Create purchase
- `GET /api/v1/purchases/:id` - Get purchase
- `GET /api/v1/users/:userId/purchases` - User history
- `GET /api/v1/users/:userId/owns/:productId` - Check ownership

## MCP Tools (16 total)

| Tool | Description |
|------|-------------|
| `product_get` | Get product by ID/SKU/slug |
| `product_list` | List with filters |
| `product_featured` | Featured products |
| `product_by_category` | By category |
| `product_predictions` | ML predictions |
| `product_agents` | Agent access |
| `product_vip` | VIP products |
| `product_search` | Search |
| `product_availability` | Check stock |
| `product_related` | Related products |
| `purchase_calculate` | Preview amounts |
| `purchase_create` | Create purchase |
| `purchase_get` | Get details |
| `purchase_history` | User history |
| `purchase_check_ownership` | Check if owns |
| `purchase_update_delivery` | Update status |

## Product Categories

- `PREDICTION` - ML model predictions
- `EDUCATION` - Courses, tutorials
- `CONSULTING` - Coaching sessions
- `AGENT_ACCESS` - Money Manager access
- `SIGNAL_PACK` - Trading signals
- `API_ACCESS` - API keys
- `PREMIUM_FEATURE` - VIP features

## Purchase Types

- `WALLET` - 100% wallet credits
- `STRIPE` - 100% card payment
- `COMBINED` - Wallet + card

## License

UNLICENSED - Private