HTTP Deployment

HTTP Deployment

The server supports:

• Streamable HTTP
• Stateful HTTP/SSE

Streamable HTTP

Start:

set HTTP_STREAMABLE_SERVER=true
set HOST=localhost
set PORT=3000
set OUTSCRAPER_API_KEY=YOUR_API_KEY
npx -y outscraper-mcp

Endpoints:

• http://localhost:3000/mcp
• http://localhost:3000/health

Stateful HTTP/SSE

Start:

set SSE_LOCAL=true
set HOST=localhost
set PORT=3000
set OUTSCRAPER_API_KEY=YOUR_API_KEY
npx -y outscraper-mcp

Session endpoints:

• POST /mcp
• GET /mcp
• DELETE /mcp

The server tracks session state via the mcp-session-id header.

Health Check

Use:

GET /health

Expected result:

ok

When to Use Which Mode

• stdio: desktop and IDE MCP clients
• Streamable HTTP: simple hosted HTTP endpoint
• Stateful HTTP/SSE: session-based HTTP usage