What it does
Stateful WebSocket session registry with per-connection Shannon entropy delta tracking for schema di
- Connects Runs in the cloud
- Account or key No key needed
- Category Developer tools
Use together with
Skills that teach the AI this kind of work; they work alongside this one
andrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
Why it ranks here
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 0/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 7/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 7/100 |
Quality: Passed 2/4 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Install
Pick the AI app you use, then copy the settings.
Passed 2/4 checks · Runs on your computer
We hid some of the commands
Connect by URL: the server address did not answer when we checked
No install path has passed yet. See the maker’s instructions or pick another server in this category · Maker’s install instructions · Others in this category
First: which AI do you use?
Pick your app and the steps appear below.
Claude cannot connect Npm Package Ws Has 241560546 Weekly Downloads But Sdk yet
No install path has passed yet. See the maker’s instructions or pick another server in this category
ChatGPT cannot connect Npm Package Ws Has 241560546 Weekly Downloads But Sdk yet
No install path has passed yet. See the maker’s instructions or pick another server in this category
What you can do instead
B · Others in Developer tools that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
- Sentry✓ ChatGPT
- Compiler Explorer✓ ChatGPT
- GitDiagram✓ ChatGPT
Claude Code cannot connect Npm Package Ws Has 241560546 Weekly Downloads But Sdk yet
No install path has passed yet. See the maker’s instructions or pick another server in this category
Cursor cannot connect Npm Package Ws Has 241560546 Weekly Downloads But Sdk yet
No install path has passed yet. See the maker’s instructions or pick another server in this category
VS Code cannot connect Npm Package Ws Has 241560546 Weekly Downloads But Sdk yet
No install path has passed yet. See the maker’s instructions or pick another server in this category
No install path has passed yet. See the maker’s instructions or pick another server in this category
At a glance
Which apps can use it
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Connect over the internet in
GooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
Related guides
What it can do
The server did not answer when we last checked, so we could not read its tools.
Basic checksi
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 21, 2026
- ✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account nexus-mcp-infra, which owns the repo
- ✓ Pass
Still maintained
Code last changed 3 months ago
- ✕ Fail
Has a licence
No licence file found in the repo
- ✕ Fail
Endpoint responds
Did not respond within 6 seconds when we checked
- – Not applicable
Sign-in with OAuth
Did not respond within 6 seconds when we checked
- … Not checked yet
No hidden instructions in tool descriptions
Not checked yet; we read the tool list when we check the endpoint
Makers: ask for a re-check or report wrong info
For makers: add a badge to your README
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/nexus-mcp-infra-npm-package-ws-has-241560546-weekly-downloads-but-sdk)Discussion
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
User reviews
No reviews yet
Compared with others in Developer toolsi
- More stars than 0% of the other 6702 servers in this category
- Published to the registry more recently than 20% of the other 6702 servers in this category
- Basic checks equal to or better than 8% of the other 6702 servers in this category
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
Common questions
Is Npm Package Ws Has 241560546 Weekly Downloads But Sdk safe?
It passed 2 of 4 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
What keys or codes does it need?
The registry does not list a required key, though some servers ask you to sign in on first use.
Does it run on my computer or in the cloud?
It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.
Is it still maintained?
The GitHub repo last changed 3 months ago, and the latest version (1.0.0) reached the registry 4 months ago.
Which apps can use it?
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).
What can I use instead?
In the same category: GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
Similar alternatives
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
GitDiagram
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Appllama
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Cloudflare MCP
Cloudflare MCP servers
Omnara
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Repowise
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| This one Npm Package Ws Has 241560546 Weekly Downloads But Sdk | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| Runs where | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Cloud or install on your computer |
| Needs a key | No | No | No | No | No | No |
| Add with + in Claude | No | No | No | Yes | No | No |
| Basic checks | 2/4 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| License | – | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-3.0 |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
README from the maker
Open the README
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
ws-mcp
WebSocket session management as MCP tools — with per-frame Shannon entropy tracking.
ws has 241,560,546 weekly downloads. There are zero MCP servers that expose WebSocket primitives. This is that server.
The problem
AI agents cannot interact with live WebSocket streams without custom glue code per integration. There is no standardized way for an LLM to open a persistent connection, send a typed frame, and receive structured events as tool call responses. Debugging message flows requires external tooling (Wireshark, browser devtools) that is incompatible with agentic workflows.
ws-mcp exposes five atomic operations over HTTP: open a session, send a frame, drain buffered frames, inspect telemetry, and close. Each frame — inbound or outbound — is scored with a Shannon entropy delta relative to the session's cumulative message distribution, so an agent can detect when a stream is diverging from its expected schema without any external monitoring.
Why the entropy delta is not optional
The server maintains a live token-frequency Counter per session_id inside the same process that holds the socket open. For each frame, it computes:
delta = H(t) - H(t-1)
where H(t) is the Shannon entropy of the cumulative byte distribution after frame t. A delta near zero means the frame is statistically consistent with the session's established message pattern. A large positive delta means the frame introduced new information — schema divergence, anomalous payload, or a new message type.
This requires coupling MCP tool state with a live socket registry and a probabilistic frame classifier in the same process. It cannot be replicated by wrapping ws.send() in a stateless proxy.
Base URL
https://npm-package-ws-has-241560546-w-production.up.railway.app
Authentication
None. There is no API key, header, or auth mechanism of any kind on this asset today — every request is served regardless of headers sent.
Pricing
- `POST /ws-sessions/open` requires an x402 payment:
$0.01USDC on Base Sepolia (testnet), schemeexact. A request without payment gets402 Payment Requiredwith the payment details in thepayment-requiredresponse header. - All other operations (
send-frame,drain-frames,telemetry,close) act on a session that was already paid for at open time and are not separately charged.
Endpoints
POST /ws-sessions/open
Establishes a persistent WebSocket connection to a target URL and registers it in the stateful session registry. Returns a session_id for all subsequent operations. Requires an x402 payment (see Pricing above).
Use when an agent needs to initiate a long-lived connection before sending or receiving frames. Do NOT use to reconnect an already-open session — call close first, or use the session_id of an existing session.
Request
{
"target_url": "wss://echo.websocket.org", "connect_timeout_seconds": 10.0, "extra_headers": { "X-Custom-Header": "value" } }
target_url must start with ws:// or wss:// (validated, not just a regex in the schema). connect_timeout_seconds defaults to 10.0, range 0.5–60.0. extra_headers is optional (HTTP headers sent on the upgrade request).
Response (201)
{
"session_id": "8662044208f54095b327ab4c29e1554c", "target_url": "wss://echo.websocket.org", "state": "OPEN", "opened_at_unix": 1785012145.03, "message": "Session '8662044208f54095b327ab4c29e1554c' is OPEN. Use session_id for all subsequent operations." }
session_id is a 32-character hex string (uuid.uuid4().hex, no dashes) — use it as-is in the paths below.
Errors: 422 if target_url doesn't start with ws:///wss://; 504 if the handshake doesn't complete within connect_timeout_seconds; 502 if the host is unreachable or refuses the connection; 503 if the server is already at NEXUS_WS_MAX_SESSIONS concurrent sessions.
POST /ws-sessions/{session_id}/send-frame
Sends a single text or binary frame over an open session and returns the frame's Shannon entropy delta relative to the session baseline.
Use for request-response patterns or publishing commands to a WebSocket server. Do NOT use to send a sequence of frames in bulk — call this endpoint once per frame. Fails if session_id does not exist or the connection is not in OPEN state.
Request
{
"payload": "{\"action\": \"subscribe\", \"channel\": \"trades\"}", "frame_type": "text" }
frame_type is "text" (default) or "binary" — if binary, payload must be a hex-encoded string.
Response (200)
{
"session_id": "8662044208f54095b327ab4c29e1554c", "frame_type": "text", "payload_bytes": 44, "entropy_after": 4.237441, "entropy_delta": 0.245712, "schema_valid": true, "sent_at_unix": 1785012151.68 }
Errors: 404 if session_id is not in the registry (session_id ' ' not found in registry); 409 if the session isn't in OPEN state; 422 if frame_type is "binary" and payload isn't valid hex; 502 if the underlying socket send fails.
POST /ws-sessions/{session_id}/drain-frames
Returns up to max_frames buffered inbound frames received since the last drain (or session open), each annotated with its Shannon entropy delta and schema validation result.
Use to poll for incoming messages without holding a blocking connection. Do NOT use as a real-time streaming mechanism — it returns only frames already buffered (buffer capped at 512 frames per session; oldest frames are dropped once full).
Request
{
"max_frames": 10 }
max_frames defaults to 32, range 1–256.
Response (200)
{
"session_id": "8662044208f54095b327ab4c29e1554c", "frames_returned": 2, "frames": [ { "payload": "{\"event\": \"trade\", \"price\": 42381.50}", "frame_type": "text", "entropy_after": 3.91, "entropy_delta": 0.12, "schema_valid": true, "received_at": 1785012155.203 }, { "payload": "{\"event\": \"liquidation\", \"size\": 180000, \"side\": \"long\"}", "frame_type": "text", "entropy_after": 5.38, "entropy_delta": 1.47, "schema_valid": false, "received_at": 1785012155.891 } ], "buffer_remaining": 0 }
The entropy_delta of 1.47 on the second frame combined with schema_valid: false indicates the stream introduced content statistically inconsistent with the session's established byte distribution — a signal an agent can use to decide whether to escalate or re-negotiate the subscription.
Errors: 404 if session_id is not in the registry.
POST /ws-sessions/{session_id}/telemetry
Returns real-time telemetry for a session: connection state, frame counts, cumulative and rolling Shannon entropy statistics, schema violation rate, and uptime. Takes no request body.
Use to diagnose whether a stream is diverging from its expected schema or to verify a session is still alive before sending. Do NOT use as the primary liveness check in a tight loop — it recomputes rolling statistics on every call.
Response (200)
{
"session_id": "8662044208f54095b327ab4c29e1554c", "target_url": "wss://echo.websocket.org", "state": "OPEN", "uptime_seconds": 108.77, "frames_sent": 1, "frames_received": 2, "current_entropy": 4.16695, "rolling_entropy_mean": 0.18, "rolling_entropy_std": 0.31, "rolling_entropy_max": 1.47, "cumulative_entropy_bits": 4.16695, "schema_violations": 1, "schema_violation_rate": 0.333333, "inbound_buffer_depth": 2 }
Errors: 404 if session_id is not in the registry.
POST /ws-sessions/{session_id}/close
Sends a WebSocket close frame with the specified status code, waits for the server close handshake, and removes the session from the registry. Returns a final telemetry snapshot. session_id is permanently deallocated after this call and cannot be reused.
Request (both fields optional)
{
"status_code": 1000, "reason": "agent task complete" }
status_code defaults to 1000, range 1000–4999 (RFC 6455). reason defaults to "", max 123 bytes.
Response (200)
{
"session_id": "8662044208f54095b327ab4c29e1554c", "target_url": "wss://echo.websocket.org", "final_state": "CLOSED", "frames_sent": 1, "frames_received": 2, "terminal_entropy": 4.16695, "schema_violations": 1, "uptime_seconds": 310.2, "message": "Session '8662044208f54095b327ab4c29e1554c' closed with status 1000. Total frames exchanged: 3. session_id is permanently deallocated." }
Errors: 404 if session_id is not in the registry.
End-to-end example: open a session, send a frame, drain, close
import httpx
BASE = "https://npm-package-ws-has-241560546-w-production.up.railway.app"
1. Open a session (requires x402 payment on this call — omitted here for brevity,
see https://docs.x402.org for how to attach a payment header)
r = httpx.post(f"{BASE}/ws-sessions/open", json={ "target_url": "wss://echo.websocket.org", "connect_timeout_seconds": 10.0, }) r.raise_for_status() session_id = r.json()["session_id"]
2. Send a frame (not billed)
httpx.post(f"{BASE}/ws-sessions/{session_id}/send-frame", json={ "payload": '{"action": "ping"}', "frame_type": "text", }).raise_for_status()
3. Drain buffered inbound frames, alert on entropy spikes
ENTROPY_ALERT_THRESHOLD = 1.0
drain = httpx.post(f"{BASE}/ws-sessions/{session_id}/drain-frames", json={ "max_frames": 20, }).json()
for frame in drain["frames"]: if frame["entropy_delta"] > ENTROPY_ALERT_THRESHOLD or not frame["schema_valid"]: print(f"[ALERT] delta={frame['entropy_delta']:.2f} schema_valid={frame['schema_valid']}") print(f" payload={frame'payload'}")
4. Inspect session health before deciding to continue
telemetry = httpx.post(f"{BASE}/ws-sessions/{session_id}/telemetry").json() print(f"schema_violation_rate={telemetry['schema_violation_rate']:.3f} " f"current_entropy={telemetry['current_entropy']:.2f}")
5. Close cleanly
httpx.post(f"{BASE}/ws-sessions/{session_id}/close", json={ "status_code": 1000, "reason": "task complete", }).raise_for_status()
curl example
# Open a session (requires x402 payment — this call alone will return 402
without a valid payment header; see https://docs.x402.org)
curl -X POST https://npm-package-ws-has-241560546-w-production.up.railway.app/ws-sessions/open \ -H "Content-Type: application/json" \ -d '{"target_url": "wss://echo.websocket.org"}'
Send a frame (replace SESSION_ID with the value returned above — not billed)
curl -X POST https://npm-package-ws-has-241560546-w-production.up.railway.app/ws-sessions/SESSION_ID/send-frame \ -H "Content-Type: application/json" \ -d '{"payload": "hello world", "frame_type": "text"}'
Drain buffered inbound frames
curl -X POST https://npm-package-ws-has-241560546-w-production.up.railway.app/ws-sessions/SESSION_ID/drain-frames \ -H "Content-Type: application/json" \ -d '{"max_frames": 5}'
MCP
Connect an MCP-compatible client to the streamable HTTP endpoint at:
https://npm-package-ws-has-241560546-w-production.up.railway.app/mcp
Exposes the same 5 operations as MCP tools (open_websocket_session, send_typed_ws_frame, drain_ws_frame_buffer, inspect_ws_session_telemetry, close_websocket_session), with the same parameters and payment requirement (open_websocket_session requires x402 payment; the other 4 do not).
SDKs
- `sdk_wrappers/sdk.js` — real HTTP client (
axios) against the base URL above. Published to npm as@nexus-mcp-infra/npm-package-ws-has-241560546-weekly-downloads-but-sdk. This is the one to use. - `mcp_wrapper/npm_package_ws_has_241560546_weekly_downloads_but_sdk.py` — do not use. It defaults to a placeholder d