82 lines
2.4 KiB
Markdown
82 lines
2.4 KiB
Markdown
# 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
|