MCP server
HTTP and Streamable HTTP
Endpoints you can rely on
| Method | Path | Use |
|---|---|---|
| POST | /mcp | Streamable HTTP JSON-RPC |
| GET | /mcp | SSE stream. Resume with Last-Event-ID |
| GET | /health | Health |
| POST | /v4/tick | Remote heartbeat for an orchestrator |
| POST | /v4/thin-prompt | Thin prompt without a blind MCP call |
Modes
- STDIO —
npx puax-mcp-server --stdio - HTTP —
npx puax-mcp-server --port 2333
CORS on /v4/* is limited to loopback origins. POST /v4/doctor/fix is POST-only. A stale global install can hide the version you just built. Check npx puax-mcp-server --version.
Quiz
What is the default HTTP port?