tindevelopers/skulabs-mcp-v2

🚀 Skulabs MCP Server

A Model Context Protocol (MCP) server that exposes Skulabs API functionality as tools for AI agents via Railway deployment.

✨ Features

• Inventory Management: Get and update inventory items
• Product Management: Retrieve and create products
• Order Management: Handle orders and order status updates
• Customer Management: Manage customer information
• Analytics: Sales and inventory summaries
• Cloud Deployment: Ready-to-use Railway deployment

🚀 Quick Start

Claude Desktop Configuration

Add to your Claude Desktop config:

{
  "mcpServers": {
    "skulabs": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://web-production-8493.up.railway.app/sse"
      ]
    }
  }
}

Install mcp-remote (if not already installed)

npm install -g mcp-remote

🛠️ Available Tools

• get_inventory - Get inventory items with filtering
• update_inventory - Update inventory quantities
• get_products - Get product information
• get_orders - Get order data with status filtering
• get_customers - Get customer information
• create_product - Create new products
• create_order - Create new orders
• create_customer - Create new customers
• get_sales_summary - Get sales analytics
• get_inventory_summary - Get inventory analytics

🌐 Railway Deployment

The server is automatically deployed to Railway and available at:

• URL: https://web-production-8493.up.railway.app
• SSE Endpoint: /sse
• Health Check: /health

📋 Environment Variables

Required environment variables (set in Railway):

• SKULABS_API_KEY - Your Skulabs API key

🔧 Development

Local Development

# Install dependencies
pip install -r requirements.txt

# Set environment variables
cp env.example .env
# Edit .env and add your SKULABS_API_KEY

# Run the server locally
python mcp_remote_server.py

Testing the Deployment

# Test health endpoint
curl https://web-production-8493.up.railway.app/health

# Test MCP initialize
curl -X POST https://web-production-8493.up.railway.app/initialize \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "initialize"}'

# Test tools list
curl -X POST https://web-production-8493.up.railway.app/tools/list \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

📚 Documentation

• - Complete setup instructions
• - Deployment details
• - Troubleshooting guide

🎯 Usage

Once configured, you can ask Claude to:

• "Get my inventory"
• "Show me all products"
• "Create a new order for customer X"
• "Update inventory for SKU ABC123"
• "Get sales summary for this month"

📄 License

MIT License