--- title: Build MCP Server with SSE Transport in .NET description: "Build a Model Context Protocol (MCP) server with legacy SSE transport in .NET and ASP.NET Core—HTTP streaming, client setup, and Claude Desktop integration." image: "https://wavepillars.com/learn/mcp-og.webp" url: "https://wavepillars.com/learn/ai/build-mcp-server-sse-dotnet/" --- [Server-Sent Events (SSE)](/learn/ai/server-sent-events-sse-eventsource/) is a standard HTTP transport for MCP servers—unidirectional streams from server to client. This guide builds an MCP server with legacy SSE in .NET and connects it to Claude Desktop. **Note:** Legacy SSE (protocol `2024-11-05`) is maintained for compatibility. New remote deployments should prefer **Streamable HTTP**—see [Build MCP Server with Streamable HTTP](/learn/ai/build-mcp-server-streamable-http-dotnet/) and the [MCP protocol overview](/learn/ai/what-is-mcp-server/). This article focuses on legacy SSE because some clients and bridges (including `mcp-remote`) still target `/sse`. ## Key Takeaways - SSE MCP uses POST plus an EventSource stream—dual endpoints to maintain. - Treat SSE MCP as legacy; choose Streamable HTTP for new remote servers. - Disable buffering and configure proxy timeouts so SSE streams stay alive. - Test SSE through production reverse proxies—not only localhost. - Docker deployment works—watch health checks that drop long-lived connections. ## Prerequisites - Basic understanding of .NET and C# programming - Familiarity with HTTP protocols and web APIs - Knowledge of asynchronous programming concepts - Understanding of the [MCP protocol overview](/learn/ai/what-is-mcp-server/) - Recommended: [Server-Sent Events (SSE) and EventSource](/learn/ai/server-sent-events-sse-eventsource/) for SSE wire format, headers, and reconnection behavior ## Understanding Server-Sent Events (SSE) Server-Sent Events (SSE) is a web standard that allows a server to push data to a client over a single HTTP connection. Unlike WebSockets, SSE provides unidirectional communication from server to client, making it well suited for streaming updates over HTTP. For a full treatment of event framing, `EventSource` clients, C# and Node.js server examples, and production tuning, see [Server-Sent Events (SSE) and EventSource](/learn/ai/server-sent-events-sse-eventsource/). ### Key benefits of SSE for MCP - Simplicity: Built on standard HTTP, no special protocols needed - Automatic reconnection: Clients can reconnect on connection loss - Event-driven: Fits MCP's message-based architecture - Firewall friendly: Works through most corporate firewalls - Low overhead: Minimal protocol overhead compared to WebSockets ## How MCP uses SSE Legacy MCP over HTTP splits traffic across two endpoints: | Endpoint | Role | |----------|------| | `GET /sse` | Long-lived SSE stream (server → client) | | `POST /message` | JSON-RPC requests (client → server) | MCP JSON-RPC responses travel as standard SSE frames on `Content-Type: text/event-stream`: ``` data: {"jsonrpc":"2.0","id":1,"result":{...}} ``` For the full field reference (`data`, `event`, `id`, `retry`, comment heartbeats), see [Server-Sent Events (SSE) and EventSource](/learn/ai/server-sent-events-sse-eventsource/). ## Complete example: Echo MCP server ### Create the project ```bash dotnet new web -n SseMcpServer cd SseMcpServer dotnet package add ModelContextProtocol.AspNetCore ``` Pin the port so Claude config stays predictable. In `Properties/launchSettings.json`: ```json "applicationUrl": "http://localhost:5130" ``` ### Define tools Create `Tools/EchoTools.cs`: ```csharp using System.ComponentModel; using ModelContextProtocol.Server; [McpServerToolType] public sealed class EchoTools { [McpServerTool, Description("Echoes the input back to the client.")] public static string Echo(string message) => message; } ``` ### Configure Program.cs Legacy SSE is disabled by default in the MCP C# SDK. Enable it explicitly: ```csharp var builder = WebApplication.CreateBuilder(args); builder.Services .AddMcpServer() .WithHttpTransport(options => { options.Stateless = false; options.EnableLegacySse = true; }) .WithTools(); var app = builder.Build(); app.MapMcp(); app.Run(); ``` ### Run and smoke test Start the server: ```bash dotnet run ``` ## Test with Claude Desktop Claude Desktop connects to legacy SSE MCP servers through **`mcp-remote`**: a stdio bridge that forwards to your HTTP URL (`GET /sse` and `POST /message`). ### Prerequisites - [Claude Desktop](https://claude.ai/download) installed - Node.js 18+ (for `npx mcp-remote`) - The .NET MCP server running locally on port 5130 ### Configure Claude Desktop Edit `claude_desktop_config.json`: - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` - Windows: `%APPDATA%\Claude\claude_desktop_config.json` ```json { "mcpServers": { "sse-echo": { "command": "npx", "args": [ "mcp-remote", "http://localhost:5130/sse" ] } } } ``` ### Step-by-step 1. Start the server: `dotnet run` (leave the terminal open) 2. Add the config above to `claude_desktop_config.json` 3. **Fully quit** Claude Desktop and relaunch (config is read at startup) 4. Open Claude and check the MCP/tools indicator (hammer icon)—`sse-echo` should show as connected 5. Send a test prompt, for example: *"Use the echo tool to repeat the phrase hello mcp"* 6. Confirm Claude calls `Echo` and returns the echoed text ### Verify and troubleshoot - **Claude logs:** Help → View Logs (or Developer settings)—look for connection errors - **Server terminal:** should log incoming HTTP requests when Claude connects - **Wrong port:** align `launchSettings.json` with the URL in `claude_desktop_config.json` - **Server not running:** start the server before restarting Claude - **Stale config:** quit Claude completely (not just close the window), then relaunch - **Firewall:** ensure localhost traffic on port 5130 is allowed - **SSE disconnects behind a proxy:** disable response buffering and send periodic comment heartbeats—see [Server-Sent Events (SSE) and EventSource](/learn/ai/server-sent-events-sse-eventsource/) For local development without HTTP, stdio transport is simpler—see [Building MCP Server Using .NET](/learn/ai/build-mcp-server-stdio-dotnet/). ## Conclusion An MCP server over legacy SSE fits existing clients and bridges that target `/sse`. The .NET MCP SDK handles concurrent connections well; for new remote deployments, use [Build MCP Server with Streamable HTTP](/learn/ai/build-mcp-server-streamable-http-dotnet/) when your clients support it. ### Next steps - Implement custom tools for your use case - Add authentication and authorization - Set up monitoring and logging - Deploy to your preferred cloud platform ### Related reading - [Build MCP Server with Streamable HTTP](/learn/ai/build-mcp-server-streamable-http-dotnet/) — recommended remote HTTP transport - [Server-Sent Events (SSE) and EventSource](/learn/ai/server-sent-events-sse-eventsource/) — SSE protocol deep dive - [What is the MCP Protocol?](/learn/ai/what-is-mcp-server/) — transports overview - [Building MCP Server Using .NET](/learn/ai/build-mcp-server-stdio-dotnet/) — stdio and HTTP basics - [Run MCP Server in Docker](/learn/ai/run-mcp-server-in-docker/) — container deployment ## FAQ ### How do I build an MCP server with SSE transport in .NET? Configure the MCP .NET SDK for SSE transport: an HTTP endpoint accepts POSTed JSON-RPC messages and a separate GET stream delivers server events back to the client. ASP.NET Core can implement both routes with correct cache and connection headers. Prefer Streamable HTTP for new builds unless you must support legacy SSE clients. ### Why is MCP SSE considered legacy? The MCP specification moved toward Streamable HTTP as the standard remote transport, simplifying proxies, auth, and connection management. SSE MCP required dual endpoints and behaved poorly behind some load balancers. Maintain SSE only for existing integrations; greenfield work should use Streamable HTTP. ### What ASP.NET Core settings matter for SSE MCP endpoints? Disable response buffering for the event stream, set Cache-Control: no-cache, and keep connections alive through reverse proxies with appropriate timeout configuration. Proxies that buffer entire responses break real-time delivery. Test through the same nginx or Cloudflare path production uses. ### Should I deploy SSE MCP in Docker? Docker works for SSE MCP the same as any ASP.NET Core app—ensure health checks do not kill long-lived SSE connections and configure proxy timeouts externally. For new deployments, containerized Streamable HTTP is simpler to operate and monitor. ## Internal Links - [What is the MCP Protocol?](/learn/ai/what-is-mcp-server/) - [Server-Sent Events (SSE) and EventSource](/learn/ai/server-sent-events-sse-eventsource/) - [Build MCP Server with Streamable HTTP in .NET](/learn/ai/build-mcp-server-streamable-http-dotnet/) - [Run MCP Server in Docker](/learn/ai/run-mcp-server-in-docker/) - [Building MCP Server Using .NET](/learn/ai/build-mcp-server-stdio-dotnet/) ```json {"@context":"https://schema.org","@graph":[{"@type":"BlogPosting","headline":"Build MCP Server with SSE Transport in .NET","description":"Build a Model Context Protocol (MCP) server with legacy SSE transport in .NET and ASP.NET Core—HTTP streaming, client setup, and Claude Desktop integration.","datePublished":"2025-08-04","dateModified":"2026-07-11","url":"https://wavepillars.com/learn/ai/build-mcp-server-sse-dotnet/","author":{"@type":"Person","name":"Kiryl Bahdanovich"},"publisher":{"@type":"Organization","name":"WAVEPILLARS","url":"https://wavepillars.com/"},"image":"https://wavepillars.com/learn/mcp-og.webp","timeRequired":"PT18M"},{"@type":"FAQPage","mainEntity":[{"@type":"Question","name":"How do I build an MCP server with SSE transport in .NET?","acceptedAnswer":{"@type":"Answer","text":"Configure the MCP .NET SDK for SSE transport: an HTTP endpoint accepts POSTed JSON-RPC messages and a separate GET stream delivers server events back to the client. ASP.NET Core can implement both routes with correct cache and connection headers. Prefer Streamable HTTP for new builds unless you must support legacy SSE clients."}},{"@type":"Question","name":"Why is MCP SSE considered legacy?","acceptedAnswer":{"@type":"Answer","text":"The MCP specification moved toward Streamable HTTP as the standard remote transport, simplifying proxies, auth, and connection management. SSE MCP required dual endpoints and behaved poorly behind some load balancers. Maintain SSE only for existing integrations; greenfield work should use Streamable HTTP."}},{"@type":"Question","name":"What ASP.NET Core settings matter for SSE MCP endpoints?","acceptedAnswer":{"@type":"Answer","text":"Disable response buffering for the event stream, set Cache-Control: no-cache, and keep connections alive through reverse proxies with appropriate timeout configuration. Proxies that buffer entire responses break real-time delivery. Test through the same nginx or Cloudflare path production uses."}},{"@type":"Question","name":"Should I deploy SSE MCP in Docker?","acceptedAnswer":{"@type":"Answer","text":"Docker works for SSE MCP the same as any ASP.NET Core app—ensure health checks do not kill long-lived SSE connections and configure proxy timeouts externally. For new deployments, containerized Streamable HTTP is simpler to operate and monitor."}}]}]} ```