# three.ws Signals (npm · @three-ws/signals-mcp)

Discover signal feeds ranked by proven edge, rank publishers, and subscribe + track results.

- Trust score: 63/100 (medium)
- Change this week: +21
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `@three-ws/signals-mcp`: 63/100 (this document), [markdown](https://verifymcp.io/servers/nirholas-signals-mcp/three-ws-signals-mcp.md), [page](https://verifymcp.io/servers/nirholas-signals-mcp/three-ws-signals-mcp)

## Channel facts

- Registry: `npm`
- Package: `@three-ws/signals-mcp`
- Version: `0.1.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (Apache-2.0).
  - Actively maintained (last published 29 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 63/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1590 tokens (~318/item across 5 items; 5 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add nirholas-signals-mcp -- npx -y @three-ws/signals-mcp
```

### Codex

```bash
codex mcp add nirholas-signals-mcp -- npx -y @three-ws/signals-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "nirholas-signals-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@three-ws/signals-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add nirholas-signals-mcp --command npx --arg -y --arg @three-ws/signals-mcp
```

### Hermes

```yaml
mcp_servers:
  nirholas-signals-mcp:
    command: "npx"
    args: ["-y", "@three-ws/signals-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "nirholas-signals-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/signals-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 63, +31)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional] Licence: Apache-2.0

### 2026-08-02 (score 32, +10)

- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet.
- [functional regression] Capabilities: pass → unverified

### 2026-08-01 (score 22, +5)

- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] MCP protocol: unverified → pass

### 2026-07-31 (score 17, −7)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 24, −18)

- [security regression] Malware scan: pass → unverified

### 2026-07-27 (score 42)

First indexed and scored.

## MCP tools (5)

### `list_signal_feeds` (~261 tokens)

Browse the signal-feed marketplace

Discover copy-trade signal feeds on three.ws. Returns the public directory of active feeds, each ranked by its PROVEN realized edge (hit-rate × realized ROI, confidence-regressed toward the publisher's verified track-record score until enough signals have closed — a thin feed riding one lucky call can never top a deep, consistent one). For each feed you get its numeric `id` (pass this to subscribe_signal), `slug`, title, the publisher (name, verified badge, track-record score, realized SOL P&L), pricing (per-signal and per-epoch USDC), and proven stats (closed signals, hit-rate, average realized %, active subscribers, executed fills, avg emit→fill latency, avg follower ROI). Sort by `edge` (default), `roi`, `hitrate`, `subscribers`, or `newest`. Public, read-only live data — no key required.

Input parameters:

- `limit` (integer): Maximum feeds to return (1–100, default 60).
- `network` (string): Solana network the feeds publish on (default mainnet).
- `sort` (string): Ranking key: edge (proven realized edge, default), roi (avg realized %), hitrate, subscribers, or newest.

### `get_mirror_leaderboard` (~241 tokens)

Rank signal publishers by realized performance

Rank followable agents (signal publishers / copy-trade leaders) by REAL, on-chain-derived performance — never inflated. Every number traces to a real signature: realized P&L and win-rate come from closed sniper round-trips, volume from the discretionary custody ledger, and losers are included. Each leader returns rank, agent_id, name, avatar, settled trades, wins, win_rate, realized pnl_sol, roi_pct, trade count, volume_sol, follower counts, last trade time, and a composite score (realized ROI weighted by sample size so a one-trade fluke cannot top a consistent trader). Sort by `score` (default), `pnl`, `followers`, `volume`, or `winrate`. Use this to find a leader before subscribing to their feed. Public, read-only live data — no key required.

Input parameters:

- `limit` (integer): Maximum leaders to return (1–50, default 25).
- `network` (string): Solana network to rank on (default mainnet).
- `sort` (string): Ranking key: score (default), pnl, followers, volume, or winrate.

### `get_subscriptions` (~167 tokens)

List your signal subscriptions + delivery history

List every signal subscription owned by the authenticated account — the follower's tracking surface. Each subscription returns its numeric `id` (pass this to set_subscription_status), the subscriber agent, the feed it follows (slug, title, publisher, pricing), the copy-trade config (mode simulate/live, billing, base_sol, size_scaling, max_per_trade_sol, slippage_bps, firewall_level, copy_exits), live status (status, killed flag, epoch_paid_until, last delivered emission), and the realized delivery stats: `stats.executed` (mirror fills that executed on-chain), `stats.paid_count` (paid deliveries), and `stats.usdc_spent` (total USDC paid to the publisher). Requires THREE_WS_API_KEY. Read-only live data.

### `subscribe_signal` (~513 tokens)

Subscribe an agent to a signal feed

Subscribe one of YOUR agents to a signal feed so it copy-trades the publisher. Idempotent: a feed is keyed by (subscriber agent, feed) — re-calling updates the existing subscription instead of creating a duplicate. A new subscription starts at the current emission head, so it is never charged for or made to mirror signals emitted before it subscribed.

PAYMENT & RISK: `mode:"simulate"` (default) mirrors WITHOUT paying or trading — it sizes and labels the orders for trust-building, spends nothing. `mode:"live"` BOTH pays the publisher in USDC (x402, per-signal or per-epoch per the feed pricing) AND auto-mirrors real on-chain trades from the subscriber agent's custodial wallet, within its spend policy. Money moves at delivery time (when the publisher emits a signal), not at the moment you call this tool. Use set_subscription_status with killed:true to halt all further pay/trade instantly. Requires THREE_WS_API_KEY; the agent must be owned by that account.

Input parameters:

- `agent_id` (string, required): ID of the subscriber agent (must be owned by the authenticated account). This agent pays and mirrors.
- `base_sol` (number): Base order size in SOL before the per-signal size multiple/scaling (0.001–10, default 0.05).
- `billing` (string): How live mode is charged: per_signal (each entry) or per_epoch (a flat fee per epoch window).
- `copy_exits` (boolean): Mirror the publisher's exits too (sell when they sell). Default true.
- `feed_id` (integer, required): Numeric feed id to follow (from list_signal_feeds — the `id` field). The feed must be active.
- `firewall_level` (string): Risk firewall on mirrored buys: block (refuse risky trades, default) or warn (allow with a flag).
- `max_per_trade_sol` (number): Hard cap on any single mirrored order in SOL (0.001–50, default 0.25).
- `mode` (string): simulate = no pay, no trade (default, safe). live = pays USDC AND auto-mirrors real trades.
- `size_scaling` (number): Multiplier applied on top of the base size (0.01–20, default 1).
- `slippage_bps` (integer): Max slippage in basis points for mirrored trades (0–5000, default 300 = 3%).

### `set_subscription_status` (~206 tokens)

Resume, pause, stop, or kill a subscription

Control an existing signal subscription owned by the authenticated account.
  • active  — (re)activate it; this also CLEARS any kill flag so it resumes paying/mirroring.
  • paused  — stop delivering for now; the kill flag (if set) is left untouched.
  • stopped — stop the subscription (soft — its delivery history is kept).
  • killed  — INSTANT kill switch: halts everything immediately; the kill is honoured before any payment or trade can fire. Use this to stop a live subscription from spending or trading right now.
Idempotent — setting the same state again is a no-op. Get the subscription `id` from get_subscriptions. Requires THREE_WS_API_KEY.

Input parameters:

- `state` (string, required): Target state: active (resume + clear kill), paused, stopped, or killed (instant halt of all pay/trade).
- `subscription_id` (integer, required): Numeric subscription id (the `id` from get_subscriptions).

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/nirholas-signals-mcp/three-ws-signals-mcp#diagnostics

## Score history

- 2026-08-03: 63
- 2026-08-02: 32
- 2026-08-01: 22
- 2026-07-31: 17
- 2026-07-30: 24
- 2026-07-28: 42
- 2026-07-27: 42

## Links

- npm package: https://www.npmjs.com/package/@three-ws/signals-mcp
- Socket report: https://socket.dev/npm/package/@three-ws/signals-mcp
- Repository: https://github.com/nirholas/three.ws
- Website: https://three.ws/
- Changelog RSS feed: https://verifymcp.io/servers/nirholas-signals-mcp/three-ws-signals-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/nirholas-signals-mcp/three-ws-signals-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/nirholas-signals-mcp/three-ws-signals-mcp