StockSpark MCP Server

# StockSpark MCP Documentation Index Complete documentation guide for the StockSpark MCP server with 36 specialized tools for vehicle dealership management. ## 📚 Core Documentation ### Getting Started - **[README.md](../README.md)** - Quick start, setup, and tool reference - **[CLAUDE.md](../CLAUDE.md)** - AI agent guide for working with the codebase - **[.env.example](../.env.example)** - Environment configuration template ### Known Issues & Status - **[KNOWN_ISSUES.md](../KNOWN_ISSUES.md)** - Current issues and fixes ## 🔧 Feature Guides ### Vehicle Management - **[DELETE_VEHICLE_GUIDE.md](DELETE_VEHICLE_GUIDE.md)** - Secure vehicle deletion - **[COLOR_UPDATE_GUIDE.md](COLOR_UPDATE_GUIDE.md)** - Vehicle color updates ### Image Management - **[IMAGE_UPLOAD_GUIDE.md](IMAGE_UPLOAD_GUIDE.md)** - Complete image upload guide ### API Documentation - **[carspark-api-swagger.json](carspark-api-swagger.json)** - Full API specification - **[Example Response](example-carspark-api-get-vehicle-response_1749481980272.json)** - Sample vehicle data ## 📊 Quick Reference ### Environment Setup (Minimal) ```bash # Required - Add to .env file STOCKSPARK_USERNAME=your-email@dealer.com STOCKSPARK_PASSWORD=your-password # Optional - Defaults handled in code # STOCKSPARK_COUNTRY=it # Default: it # LOG_LEVEL=info # Default: info ``` ### Tool Categories (36 Total) | Category | Count | Purpose | |----------|-------|---------| | Organization | 5 | Multi-tenant management | | Reference | 10 | Vehicle specifications | | Vehicle | 6 | CRUD operations | | Image | 4 | Media management | | Analytics | 4 | Business intelligence | | Publishing | 4 | Portal distribution | | Leads | 2 | Customer tracking | | Performance | 1 | System metrics | ### Key Commands ```bash npm install # Setup npm test # Verify configuration npm start # Run MCP server ``` ### Common Workflows **Vehicle Creation (3 steps)** 1. `search_vehicle_versions` - Find specifications 2. `get_vehicle_version_template` - Get complete data 3. `add_vehicle` - Create with template **Image Upload** - Files: `upload_vehicle_images` with paths - URLs: `upload_vehicle_images` with URLs - Pasted: Save to disk first, then upload **Multi-tenant Setup** 1. `get_user_context` - Check current selection 2. `list_user_companies` - View available companies 3. `select_company` - Choose company 4. `select_dealer` - Choose dealer ## 🔍 Troubleshooting | Issue | Solution | |-------|----------| | Auth fails | Check username/password in .env | | No companies | Verify account has company access | | Tool not found | Update to latest version | | Images not uploading | Check file paths are absolute | | Tests failing | Run `npm run test:verbose` for details | ## 📈 Recent Updates ### ✅ Completed - Simplified configuration (only user/pass required) - Fixed organization tools (method name fixes) - Tool consolidation (41 → 36 tools) - Enhanced vehicle search with sorting - Vehicle deletion with confirmation ### 🔧 Known Issues - Auto-main image not setting on upload - `hasImages` flag showing false incorrectly ## 🧪 Testing ```bash npm test # All tests npm run test:unit # Core functionality npm run test:verbose # Detailed debugging ``` --- **For detailed tool documentation, see [README.md](../README.md)** **For development guide, see [CLAUDE.md](../CLAUDE.md)**