mcpserver.http

### BuildWithAspire MCP Server (MCP Protocol over HTTP with Session Management)
### This server implements the Model Context Protocol (MCP) specification
### with Streamable HTTP transport and session management via Mcp-Session-Id header
### Base URL: Auto-assigned port (check Aspire dashboard or use http://localhost:5267)

@baseUrl = http://localhost:5267

### === Server Status and Health ===

### Health Check
GET {{baseUrl}}/health

### Debug Info (Session and Transport Information)
GET {{baseUrl}}/debug/info

### Debug Tools (List Available Tools)
GET {{baseUrl}}/debug/tools

### === MCP Protocol with Session Management ===
### The server uses Streamable HTTP transport with stateful sessions
### Session ID is returned in the Mcp-Session-Id header on first request
### Include the same header in subsequent requests to maintain session

### Step 1: Initialize Session (First Request)
### This creates a new session and returns Mcp-Session-Id header
POST {{baseUrl}}/
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "initialize",
  "params": {
    "protocolVersion": "2024-11-05",
    "capabilities": {
      "tools": {}
    },
    "clientInfo": {
      "name": "VSCode HTTP Client",
      "version": "1.0.0"
    }
  }
}

### Step 2: List Available Tools (Using Session ID from Step 1)
### IMPORTANT: Copy the Mcp-Session-Id from Step 1 response headers and use it here
POST {{baseUrl}}/
Content-Type: application/json
Mcp-Session-Id: <paste-session-id-here>

{
  "jsonrpc": "2.0",
  "id": "2",
  "method": "tools/list",
  "params": {}
}

### Step 3: Call Weather Tool - Current Weather (With Session ID)
POST {{baseUrl}}/
Content-Type: application/json
Mcp-Session-Id: <paste-session-id-here>

{
  "jsonrpc": "2.0",
  "id": "3",
  "method": "tools/call",
  "params": {
    "name": "getCurrentWeather",
    "arguments": {}
  }
}

### Step 4: Call Weather Tool - Forecast (With Session ID)
POST {{baseUrl}}/
Content-Type: application/json
Mcp-Session-Id: <paste-session-id-here>

{
  "jsonrpc": "2.0",
  "id": "4",
  "method": "tools/call",
  "params": {
    "name": "getWeatherForecast",
    "arguments": {
      "maxDays": 5
    }
  }
}

### Step 5: Call Temperature Conversion Tool (With Session ID)
POST {{baseUrl}}/
Content-Type: application/json
Mcp-Session-Id: <paste-session-id-here>

{
  "jsonrpc": "2.0",
  "id": "5",
  "method": "tools/call",
  "params": {
    "name": "convertTemperature",
    "arguments": {
      "temperature": 25,
      "fromUnit": "C"
    }
  }
}

### Step 6: Call System Info Tool (With Session ID)
POST {{baseUrl}}/
Content-Type: application/json
Mcp-Session-Id: <paste-session-id-here>

{
  "jsonrpc": "2.0",
  "id": "6",
  "method": "tools/call",
  "params": {
    "name": "getSystemInfo",
    "arguments": {}
  }
}

### Step 7: Open SSE Stream for Notifications (Optional)
### This keeps the session active and receives server-to-client messages
GET {{baseUrl}}/
Mcp-Session-Id: <paste-session-id-here>

### Step 8: Close Session (Optional - or wait for idle timeout)
DELETE {{baseUrl}}/
Mcp-Session-Id: <paste-session-id-here>

### === Session Management Notes ===
### 1. The first POST request creates a new session and returns Mcp-Session-Id
### 2. Use the same Mcp-Session-Id header in all subsequent requests
### 3. Sessions timeout after 2 hours of inactivity
### 4. Max 10,000 idle sessions can be tracked simultaneously
### 5. Without session ID, each request creates a new session (not recommended)

### === Testing via API Service ===
### For easier testing without manual session management,
### use the API Service MCP endpoints (they handle sessions internally):

### Get Available Tools (via API Service)
GET http://localhost:5020/mcp/tools

### Call Weather Forecast (via API Service - camelCase tool name)
POST http://localhost:5020/mcp/call/getWeatherForecast
Content-Type: application/json

{
  "maxDays": 5
}

### Call Current Weather (via API Service - camelCase tool name)
POST http://localhost:5020/mcp/call/getCurrentWeather
Content-Type: application/json

{}

### Call Random Number Tool (via API Service - camelCase tool name)
POST http://localhost:5020/mcp/call/generateRandomNumber
Content-Type: application/json

{
  "min": 1,
  "max": 100
}