Transport Modes

Transport Modes

The server supports multiple transport modes for different integration scenarios.

Stdio Mode (Default)

Standard input and output communication. This is the default mode used by most MCP clients, including Claude Desktop and Cursor.

All configuration samples above use Stdio mode by default and require no extra settings.

HTTP/SSE Mode

For advanced scenarios, run the server in HTTP mode to expose both HTTP stream and Server-Sent Events (SSE) endpoints.

Start server in HTTP mode:

# macOS/Linux
export LISTENHUB_API_KEY="your_api_key_here"
npx @marswave/listenhub-mcp-server --transport http --port 3000
# Windows
set LISTENHUB_API_KEY=your_api_key_here

npx @marswave/listenhub-mcp-server --transport http --port 3000

Available endpoints:

• HTTP stream: http://localhost:3000/mcp
• Server-Sent Events: http://localhost:3000/sse

Configure MCP client to use HTTP endpoint:

{
  "mcpServers": {
    "listenhub": {
      "url": "http://localhost:3000/mcp"
    }
  }
}