Update docs for streamable-HTTP as default transport

Revised documentation to prioritize streamable-HTTP over legacy SSE, updated examples, renamed `Server.Sse` to `Server.Http`, and clarified backward compatibility. Added explicit notes and sections for legacy SSE usage while ensuring consistency across files.

Author: sylvain-guillet

README.md

@@ -3,17 +3,21 @@
 ## Use it now
 > Hosted in production (no setup needed): https://mcp.io-aerospace.org/
 >
-> SSE endpoint: https://mcp.io-aerospace.org/sse
+> **Transport Protocols:**
+> - **Streamable-HTTP** (recommended): https://mcp.io-aerospace.org/ - Modern MCP transport protocol
+> - **SSE** (legacy): https://mcp.io-aerospace.org/sse - For backward compatibility with older MCP clients only
 >
-> Note: Most MCP clients that support HTTP/SSE only need the base URL; they will connect to the SSE stream internally (commonly at `/sse`). The explicit `/sse` URL is provided here for manual/web integrations.
+> Note: Use the base URL with modern MCP clients - they will automatically use the streamable-HTTP transport. Only use the `/sse` endpoint if you have an older client that specifically requires SSE protocol.
 
 A Model Context Protocol (MCP) server for aerospace and astrodynamics calculations, providing tools for celestial body ephemeris, orbital mechanics, and space mission analysis.
 
 ## Overview
 
 This MCP server provides two transport options:
-- **STDIO Transport**: Standard input/output communication (recommended for MCP clients)
-- **SSE Transport**: HTTP Server-Sent Events for web-based integrations
+- **STDIO Transport**: Standard input/output communication (recommended for local MCP clients)
+- **HTTP Transport**: Supports both modern streamable-HTTP and legacy SSE protocols for web-based integrations
+  - **Streamable-HTTP** (default, recommended): Modern MCP protocol at the base URL
+  - **SSE** (legacy): Available at `/sse` endpoint for backward compatibility only
 
 The server includes comprehensive tools for:
 - Celestial body ephemeris and state vector calculations
@@ -32,11 +36,14 @@ This server is powered by the IO Aerospace Astrodynamics framework, which provid
 ## Use the hosted server (recommended)
 
 You can start integrating immediately against the production instance:
-- Base URL: https://mcp.io-aerospace.org/
-- SSE stream: https://mcp.io-aerospace.org/sse
+- **Base URL (streamable-HTTP)**: https://mcp.io-aerospace.org/ - Use this with modern MCP clients
+- **SSE endpoint (legacy)**: https://mcp.io-aerospace.org/sse - Only for older clients requiring SSE protocol
 
-Example (browser/Node):
+**Important**: Modern MCP clients (2024+) should use the base URL with streamable-HTTP transport. The SSE endpoint is maintained only for backward compatibility with older implementations.
+
+Example (legacy SSE - browser/Node):
 ```javascript
+// Only use this if you have an old client that requires SSE
 const eventSource = new EventSource('https://mcp.io-aerospace.org/sse');
 
 eventSource.onmessage = (event) => {
@@ -61,7 +68,7 @@ mcp-server/
 ├── Data/                         # Data providers and solar system kernels
 │   ├── SolarSystem/             # SPICE kernel files
 │   └── SolarSystemObjects/      # Celestial body definitions
-├── Server.Sse/                  # HTTP/SSE transport server
+├── Server.Http/                 # HTTP transport server (streamable-HTTP + legacy SSE)
 ├── Server.Stdio/                # STDIO transport server
 ├── docker-compose.yml           # Development Docker configuration
 ├── docker-compose.prod.example.yml  # Production template
@@ -126,7 +133,7 @@ cd mcp-server
 docker-compose up
 ```
 
-The SSE server will be available at `http://localhost:8080`.
+The HTTP server will be available at `http://localhost:8080`.
 
 #### Production
 1. Copy `docker-compose.prod.example.yml` to `docker-compose.prod.yml`
@@ -170,7 +177,7 @@ $env:IO_DATA_DIR="C:\path\to\your\spice\kernels"
 ./Server.Stdio.exe
 ```
 
-- SSE server configuration: may use appsettings.json as before.
+- HTTP server configuration: may use appsettings.json as before.
 
 **Required Kernel Files:**
 ```
@@ -196,12 +203,12 @@ kernels/
 ./Server.Stdio -k /path/to/kernels
 ```
 
-##### SSE Transport (For Web/HTTP)
+###### HTTP Transport (For Web/HTTP)
 ```bash
-cd Server.Sse
+cd Server.Http
 dotnet run
 # Server available at http://localhost:8080
-```
+``
 
 ## Docker Configuration
 
@@ -252,7 +259,7 @@ Alternatively, set an environment variable if your client supports it:
 ```
 
 ### Claude Desktop Configuration (HTTP transport to hosted server)
-Use your production server over HTTP/SSE by specifying the base URL only:
+Use your production server over HTTP by specifying the base URL only. Modern MCP clients will use streamable-HTTP:
 
 ```json
 {
@@ -267,22 +274,24 @@ Use your production server over HTTP/SSE by specifying the base URL only:
 }
 ```
 
-- Only the base URL is required; the client will use the SSE stream internally (commonly at `/sse`).
-- This schema is for Claude Desktop; other clients may use different keys.
+- The base URL uses the modern **streamable-HTTP** transport protocol
+- Do NOT append `/sse` - that's only for legacy SSE clients
+- This schema is for Claude Desktop; other clients may use different keys
 
 ### Other MCP clients
 - Provide the base URL: https://mcp.io-aerospace.org
 - Add headers (e.g., Authorization) only if your deployment requires it
 - Don’t append `/sse` unless your client documentation requires it; most discover the SSE path
 - Refer to your client’s documentation for the exact JSON schema or settings UI
 
-### Node.js MCP client (HTTP/SSE)
-Using the MCP SDK to connect to the hosted server and list tools:
+### Node.js MCP client (streamable-HTTP)
+Using the MCP SDK to connect to the hosted server with modern streamable-HTTP transport:
 
 ```ts
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { HttpClientTransport } from "@modelcontextprotocol/sdk/client/transport/http.js";
 
+// Modern streamable-HTTP transport (recommended)
 const transport = new HttpClientTransport(new URL("https://mcp.io-aerospace.org"));
 const client = new Client(
   { name: "example-client", version: "1.0.0" },

docs/HowTo-Wix.md

@@ -3,9 +3,10 @@ Title: How to Use the IO Aerospace MCP Server
 Summary: Quick steps to use the hosted server, connect MCP clients, or self-host with Docker/.NET. Includes SPICE kernels info, tool calls, and troubleshooting.
 
 Section: Use the hosted server (no setup)
-- Base URL: https://mcp.io-aerospace.org/
-- SSE stream (manual/web): https://mcp.io-aerospace.org/sse
-- Most MCP clients that support HTTP/SSE only need the base URL.
+- **Base URL (streamable-HTTP, recommended)**: https://mcp.io-aerospace.org/
+- **SSE endpoint (legacy)**: https://mcp.io-aerospace.org/sse - Only for backward compatibility
+- Modern MCP clients (2024+) automatically use streamable-HTTP transport with the base URL
+- Only use the `/sse` endpoint if you have an older client that specifically requires SSE protocol
 
 
 
@@ -39,7 +40,7 @@ Claude Desktop (STDIO with env):
 }
 ```
 
-Claude Desktop (HTTP/SSE to hosted):
+Claude Desktop (HTTP to hosted, streamable-HTTP):
 ```json
 {
   "mcpServers": {
@@ -52,6 +53,7 @@ Claude Desktop (HTTP/SSE to hosted):
   }
 }
 ```
+Note: Uses modern streamable-HTTP transport. Do NOT append `/sse`.
 
 Section: Self-host with Docker
 Development:
@@ -91,14 +93,15 @@ $env:IO_DATA_DIR="C:\\path\\to\\your\\spice\\kernels"
 ```
 
 Choose transport:
-- STDIO (recommended): `./Server.Stdio -k /path/to/kernels`
-- HTTP/SSE (web): `cd Server.Sse && dotnet run` → http://localhost:8080
+- STDIO (recommended for local): `./Server.Stdio -k /path/to/kernels`
+- HTTP (web, supports streamable-HTTP + legacy SSE): `cd Server.Http && dotnet run` → http://localhost:8080
 
-Section: Call tools (Node.js MCP SDK)
+Section: Call tools (Node.js MCP SDK - streamable-HTTP)
 ```ts
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { HttpClientTransport } from "@modelcontextprotocol/sdk/client/transport/http.js";
 
+// Modern streamable-HTTP transport
 const transport = new HttpClientTransport(new URL("https://mcp.io-aerospace.org"));
 const client = new Client(
   { name: "example-client", version: "1.0.0" },
@@ -111,8 +114,10 @@ const tools = await client.listTools();
 console.log("Tools:", tools);
 ```
 
-Code (optional quick check in browser/Node):
+Section: Legacy SSE example (only for old clients)
+Code (optional quick check in browser/Node - legacy SSE only):
 ```js
+// ONLY use this if you have an older client that requires SSE
 const eventSource = new EventSource('https://mcp.io-aerospace.org/sse');
 
 eventSource.onmessage = (event) => {

docs/howto-mini.html

@@ -25,16 +25,17 @@
   <p>Use the hosted server now, or self-host fast with Docker or .NET. Minimal steps below.</p>
 
   <section>
-    <h3>Hosted (no setup)</h3>
+    <h3>Hosted (no setup) - Streamable-HTTP</h3>
     <ul>
-      <li>Base URL: <a href="https://mcp.io-aerospace.org" target="_blank" rel="noreferrer noopener">https://mcp.io-aerospace.org</a></li>
-      <li>SSE (manual/web): <a href="https://mcp.io-aerospace.org/sse" target="_blank" rel="noreferrer noopener">/sse</a></li>
-      <li>Most MCP clients only need the base URL.</li>
+      <li><strong>Base URL (streamable-HTTP, recommended)</strong>: <a href="https://mcp.io-aerospace.org" target="_blank" rel="noreferrer noopener">https://mcp.io-aerospace.org</a></li>
+      <li><strong>SSE endpoint (legacy)</strong>: <a href="https://mcp.io-aerospace.org/sse" target="_blank" rel="noreferrer noopener">/sse</a> - Only for backward compatibility</li>
+      <li>Modern MCP clients (2024+) automatically use streamable-HTTP with the base URL.</li>
+      <li>Only use <code>/sse</code> if you have an older client that specifically requires SSE protocol.</li>
     </ul>
   </section>
 
   <section>
-    <h3>MCP client (Claude Desktop, HTTP)</h3>
+    <h3>MCP client (Claude Desktop, HTTP - Streamable-HTTP)</h3>
     <pre><code class="language-json">{
   "mcpServers": {
     "astrodynamics": {
@@ -43,6 +44,7 @@ <h3>MCP client (Claude Desktop, HTTP)</h3>
   }
 }
 </code></pre>
+    <p><small>Uses modern streamable-HTTP transport. Do NOT append <code>/sse</code>.</small></p>
   </section>
 
   <section>
@@ -96,8 +98,8 @@ <h3>Self-host quick</h3>
 ./Server.Stdio -k /path/to/kernels
 # or via env
 export IO_DATA_DIR="/path/to/kernels" && ./Server.Stdio
-# HTTP/SSE (web)
-cd Server.Sse && dotnet run  # http://localhost:8080
+# HTTP (web - supports streamable-HTTP + legacy SSE)
+cd Server.Http && dotnet run  # http://localhost:8080
 </code></pre>
   </section>
 
@@ -120,6 +122,16 @@ <h3>Troubleshooting</h3>
     </ul>
   </section>
 
+  <section>
+    <h3>Legacy SSE (old clients only)</h3>
+    <p><small>Only use this if you have an older client that requires SSE protocol:</small></p>
+    <pre><code class="language-javascript">// ONLY for legacy SSE clients
+const eventSource = new EventSource('https://mcp.io-aerospace.org/sse');
+eventSource.onmessage = (event) => console.log('message', event.data);
+eventSource.onerror = (err) => console.error('sse error', err);
+</code></pre>
+  </section>
+
   <section>
     <h3>Links</h3>
     <ul>