OPNSense MCP Server

# Phase 2 - Current Status & Next Steps ## 🚨 Issue Identified The OPNsense API is returning errors: - **400 Bad Request** - "Invalid JSON syntax" on system status - **404 Not Found** - "Endpoint not found" on VLAN search ## 🔍 Root Cause Analysis The errors suggest: 1. Some endpoints might require POST with empty JSON object `{}` instead of GET 2. The VLAN endpoint paths might have changed in your OPNsense version 3. The API might require different headers or authentication format ## 🛠️ Immediate Actions Needed ### Option 1: Quick Diagnostic Tests Run these scripts to help identify the correct endpoints: ```bash # Test direct API calls node test-direct-api.js # Test with curl test-curl.bat # Test different endpoint variations node test-api-debug.js ``` ### Option 2: Browser-Based Discovery 1. Open `phase2docs\api-endpoint-discovery.html` in your browser 2. Enter your API credentials 3. Test various endpoints directly from the browser ### Option 3: Manual Discovery (Most Reliable) 1. Login to OPNsense web UI 2. Open browser DevTools (F12) 3. Go to Network tab 4. Navigate to Interfaces → Other Types → VLAN 5. Capture the actual API calls ## 📝 What We Need to Know 1. **OPNsense Version**: Check System → Firmware → Status 2. **Actual API Endpoints**: From browser DevTools 3. **Request Format**: GET vs POST, headers, payload structure ## 🔧 Once We Have the Correct Endpoints 1. Update `src/api/client.ts` with correct endpoints 2. Fix the request methods (GET/POST) 3. Update payload formats 4. Rebuild and test ## 💡 Possible Solutions ### If endpoints require POST instead of GET: ```javascript // Change from: await client.get('/core/system/status'); // To: await client.post('/core/system/status', {}); ``` ### If VLAN endpoints are different: ```javascript // Possible alternatives: '/interfaces/vlan/searchItem' '/interfaces/vlans/search' '/interfaces/vlan_settings/searchItems' ``` ## 🚀 Quick Test Commands Once we identify the correct endpoints: ```bash # Rebuild with fixes npm run build # Test again node test-simple.js ``` ## 📊 Progress Status - ✅ ES Module imports fixed - ✅ Test infrastructure ready - ❌ API endpoints need discovery - ⏳ VLAN implementation waiting - ⏳ Other resources pending --- **Next Step**: Run `node test-direct-api.js` or use the browser discovery tool to find the correct API endpoints for your OPNsense version.