{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_w4mn958m58sq","handle":"mcp-echo-streamablehttp-server-stateful","url":"https://wellknown.network/agents/mcp-echo-streamablehttp-server-stateful","links":{"self":"https://wellknown.network/agents/mcp-echo-streamablehttp-server-stateful/record.json","html":"https://wellknown.network/agents/mcp-echo-streamablehttp-server-stateful","markdown":"https://wellknown.network/agents/mcp-echo-streamablehttp-server-stateful/record.md","api":"https://wellknown.network/api/v1/agents/mcp-echo-streamablehttp-server-stateful","status":"https://wellknown.network/api/v1/agents/mcp-echo-streamablehttp-server-stateful/status","claim":"https://wellknown.network/agents/mcp-echo-streamablehttp-server-stateful/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-echo-streamablehttp-server-stateful/claim.json","badge":"https://wellknown.network/agents/mcp-echo-streamablehttp-server-stateful/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-echo-streamablehttp-server-stateful/history","tools":"https://wellknown.network/api/v1/agents/mcp-echo-streamablehttp-server-stateful/tools"},"ard":{"identifier":"urn:air::server:mcp-echo-streamablehttp-server-stateful","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-echo-streamablehttp-server-stateful","summary":"A stateful diagnostic MCP echo server with 11 comprehensive tools for debugging OAuth flows, session management, and analyzing software engineering excellence","description":"# MCP Echo StreamableHTTP Server - Stateful\n\nA stateful diagnostic MCP echo server with session management, message queuing, and 11 comprehensive debug tools for testing OAuth flows and MCP protocol compliance.\n\n## Features\n\n### Stateful Session Management\n- **Persistent Sessions**: UUID-based session tracking across requests\n- **Message Queuing**: Per-session message buffers for async clients\n- **Automatic Cleanup**: Background task removes expired sessions\n- **Session Context**: Store and retrieve state between requests\n\n### MCP Protocol Compliance\n- Full MCP 2025-06-18 StreamableHTTP transport implementation\n- Supports multiple protocol versions (configurable)\n- JSON-RPC 2.0 message handling\n- Proper initialize � initialized lifecycle\n\n### 11 Debug Tools\n\n1. **echo** - Echo messages with session context\n2. **replayLastEcho** - Replay the last echoed message (stateful feature!)\n3. **printHeader** - Display all HTTP headers categorized\n4. **bearerDecode** - Decode JWT tokens without verification\n5. **authContext** - Show OAuth authentication context\n6. **requestTiming** - Display request performance metrics\n7. **corsAnalysis** - Analyze CORS configuration\n8. **environmentDump** - Show sanitized environment config\n9. **healthProbe** - Deep health check with session stats\n10. **sessionInfo** - Display session information and statistics\n11. **whoIStheGOAT** - AI-powered excellence analyzer\n\n## Endpoints\n\n### POST /mcp\n- Accepts JSON-RPC 2.0 requests\n- Creates/manages sessions via Mcp-Session-Id header\n- Supports both JSON and SSE response formats\n- Returns session ID for stateful clients\n\n### GET /mcp\n- Polls for queued messages (requires session ID)\n- Returns Server-Sent Events (SSE) stream\n- Sends keep-alive pings when queue is empty\n\n## Configuration\n\nEnvironment variables:\n- `MCP_ECHO_HOST` - Host to bind (default: 0.0.0.0)\n- `MCP_ECHO_PORT` - Port to bind (default: 3000)\n- `MCP_ECHO_DEBUG` - Enable debug logging (default: true)\n- `MCP_SESSION_TIMEOUT` - Session …","publisher":null,"homepage":"https://atrawog.github.io/mcp-oauth-gateway","repository":"https://github.com/atrawog/mcp-oauth-gateway/tree/main/mcp-echo-streamablehttp-server-stateful","version":"0.2.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:mcp-echo-streamablehttp-server-stateful","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"security.identity","name":"Identity & Access","confidence":0.836,"provenance":"derived"},{"slug":"code.debugging","name":"Debugging","confidence":0.802,"provenance":"derived"}],"categories":["code","security"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-echo-streamablehttp-server-stateful","registry":"pypi","observedAt":"2026-10-28T11:27:07.651Z","publishedAt":"2025-07-02T14:59:53.476785Z","latestVersion":"0.2.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-echo-streamablehttp-server-stateful","url":"https://pypi.org/project/mcp-echo-streamablehttp-server-stateful/","firstSeenAt":"2026-09-10T01:20:18.224Z","fetchedAt":"2026-10-28T11:25:06.895Z","normalizedAt":"2026-10-28T11:25:06.895Z"}]},"firstSeenAt":"2026-09-10T01:20:18.224Z","updatedAt":"2026-10-28T11:27:07.651Z"}