trading-platform-mcp-products-v2/README.md

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

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