msfs-mcp-server/demo-prompts.md

Model Context Protocol server for Microsoft Flight Simulator SimConnect integration

# MSFS SimConnect MCP Server - Demo Prompts

This file contains example prompts to test the natural language → SimVar mapping functionality of the MSFS MCP server.

## 🎯 **Basic Aircraft Data Reading**

### Position & Navigation
- "What's my current altitude?"
- "How fast am I going?"
- "What heading am I flying?"
- "What's my current position?" (lat/lon)
- "What's my vertical speed?"
- "Am I climbing or descending?"

### Engine & Performance
- "What's my engine RPM?"
- "How much fuel do I have?"
- "What's my fuel flow rate?"
- "Is my engine running?"
- "What's my manifold pressure?"

### Flight Controls
- "What's my flaps position?"
- "Is my gear down?"
- "What's my trim setting?"
- "Are my brakes on?"
- "What's my elevator position?"

## 💡 **Lighting Systems**

### Individual Light Status
- "Are my landing lights on?"
- "What's the status of my navigation lights?"
- "Check my beacon lights status"
- "Are my strobe lights on?"
- "What about my taxi lights?"
- "Is my panel lighting on?"

### Comprehensive Light Check
- "Check all my lights status"
- "Give me a complete lighting report"
- "What lights are currently on?"

## 🎛️ **Aircraft Controls & Events**

### Lighting Controls
- "Turn on my landing lights"
- "Toggle navigation lights"
- "Turn off beacon lights"
- "Switch on strobe lights"
- "Toggle taxi lights"

### Gear & Flaps
- "Raise the landing gear"
- "Lower the landing gear"
- "Extend flaps"
- "Retract flaps"
- "Set flaps to 10 degrees"

### Autopilot Controls
- "Turn on autopilot altitude hold"
- "Set autopilot altitude to 5000 feet"
- "Turn on heading hold"
- "Set autopilot heading to 270 degrees"
- "Enable autopilot speed hold"
- "Set autopilot speed to 250 knots"

## 📡 **Communication & Navigation**

### Radio & Transponder
- "Set transponder to 7000"
- "Change transponder to 1200"
- "What's my current transponder code?"
- "Set COM1 frequency to 121.5"
- "What's my NAV1 frequency?"

### Autopilot & Navigation
- "What's my autopilot target altitude?"
- "What heading is the autopilot set to?"
- "Is autopilot engaged?"
- "What's my GPS course?"

## 🔧 **System Status Checks**

### Electrical & Systems
- "What's my battery voltage?"
- "Is my alternator working?"
- "Check electrical system status"
- "What's my hydraulic pressure?"
- "Is my pitot heat on?"

### Environmental
- "What's the outside air temperature?"
- "What's the barometric pressure?"
- "What's the wind speed and direction?"
- "Is it raining?"
- "What's the visibility?"

## 🚁 **Comprehensive Status Reports**

### Complete Aircraft Status
- "Give me a full aircraft status report"
- "Check all critical systems"
- "What's my complete flight status?"
- "Show me everything important right now"

### Pre-flight Checks
- "Are all lights working?"
- "Check flight controls status"
- "Verify all systems are ready"
- "Give me a pre-takeoff checklist status"

### Emergency Checks
- "Check all engine parameters"
- "Verify all electrical systems"
- "Are all flight controls responding?"
- "Check fuel and hydraulics"

## 🎯 **Advanced SimVar Testing**

### Specific SimVar Names (for testing)
- "Get PLANE ALTITUDE in feet"
- "Read LIGHT LANDING status"
- "Check GEAR HANDLE POSITION"
- "What's AUTOPILOT MASTER status?"
- "Read FUEL TOTAL QUANTITY"

### Multiple Data Points
- "Check altitude, speed, and heading"
- "Give me position, altitude, and fuel"
- "Show me all autopilot settings"
- "Check engine RPM, fuel flow, and manifold pressure"

## 📝 **Event Testing**

### Specific Events (for testing)
- "Send event LANDING_LIGHTS_TOGGLE"
- "Send event GEAR_TOGGLE"
- "Send event AP_ALT_HOLD_ON"
- "Send event BEACON_LIGHTS_TOGGLE"

### Events with Parameters
- "Send event LANDING_LIGHTS_SET with data 1"
- "Send event FLAPS_SET with data 2"
- "Send event TRANSPONDER_SET with data 7000"

## 🛠️ **Troubleshooting Prompts**

### Connection Testing
- "Are you connected to MSFS?"
- "Check connection status"
- "Connect to MSFS"

### Error Testing
- "Get invalid SimVar name"
- "Send invalid event"
- "Test with wrong units"

---

## 💡 **Tips for Using These Prompts**

1. **Natural Language**: The system understands natural language, so feel free to ask in your own words
2. **Specific vs General**: You can ask for specific SimVars or let Claude choose the appropriate ones
3. **Combinations**: Try asking for multiple pieces of information at once
4. **Context**: The system knows MSFS terminology, so use aviation terms naturally
5. **Fallback**: If natural language doesn't work, try the specific SimVar names or event names

## 🔧 **Common SimVar Examples**

| Natural Request | SimVar Name | Unit |
|----------------|-------------|------|
| Altitude | PLANE ALTITUDE | feet |
| Speed | AIRSPEED INDICATED | knots |
| Heading | PLANE HEADING DEGREES MAGNETIC | degrees |
| Landing Lights | LIGHT LANDING | bool |
| Gear Position | GEAR HANDLE POSITION | percent |
| Fuel | FUEL TOTAL QUANTITY | gallons |
| Engine RPM | GENERAL ENG RPM:1 | rpm |
| Flaps | FLAPS HANDLE PERCENT | percent |

---

*Generated for MSFS SimConnect MCP Server - Natural Language SimVar Interface*