three.ws Herald MCP Server

Let your agent tell you something in person. An MCP server with one idea behind it: when an agent finishes something that mattered, or gets stuck, it should not add a line to a log you will never scroll back to. It should walk up to you and say so. Its 3 documented tools cluster into announce, check.

People who work with announce and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.

One of 41 MCP servers published from nirholas/three.ws. Stars and repository activity are shared across all of them. See all 41 →

VERIFIED ACTIVE

LAST COMMIT 2026-09-30 · VERIFIED 2026-09-30

Apache-2.0 · JavaScript servers · how we verify → /methodology

01 · Install three.ws Herald

before you install - you'll need

THREE_WS_API_KEY

Environment variables documented in the project's README - it lists which are required and which have defaults.

Claude Code

claude mcp add nirholas-three.ws-packages-herald-mcp -- npx -y @three-ws/herald-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "nirholas-three.ws-packages-herald-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/herald-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license Apache-2.0 - declared in the repository

npm package @three-ws/herald-mcp - the @three-ws scope differs from the repo owner (nirholas); confirm it's the project's official package

registry namespace io.github.nirholas is GitHub-verified and matches the repo owner

03 · What three.ws Herald can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

An agent gets 3 documented tools across announce, check, including announce, announce_result, check_rail.

The 3 tools it gives your agent

Extracted from the project's README - what three.ws Herald lets an agent do.

announce: - Say one line, with importance (0-100), tone, a gesture, and an optional link.
announce_result: - Report a finished task. The urgency is chosen from the outcome, so a failure cuts through quiet hours and a success does not.
check_rail: - Prove the key and the rail work, without interrupting anybody (queues at importance 0, which every client drops).

Latest releases

v1.5.2 · 2026-09-30

Everything three.ws shipped from 2026-08-29 to 2026-09-30, taken from the public changelog. 175 user-facing changes. · Try it at three.ws, read the docs, follow the full changelog (RSS), or connect your assistant to…

v1.0.0 · 2026-08-28

!three.ws · three.ws is an Android app. Install it and the platform opens full-screen, with no browser chrome around it, and every signature is routed to the wallet on your phone. · Install · 1. Open…

04 · Who maintains three.ws Herald

three.ws Herald is maintained by nirholas. We track 71 MCP servers from nirholas - 70 actively maintained, 7,910 combined GitHub stars, oldest repo from Feb 2024. Full record: all servers from nirholas.

05 · Facts

repository: github.com/nirholas/three.ws
website: https://three.ws/herald
category: AI & ML - actively maintained as of 2026-09-30.
registry: io.github.nirholas/herald-mcp (active, first published 2026-09-30)
packages: npm:@three-ws/herald-mcp

06 · three.ws Herald FAQ

Is three.ws Herald still maintained?

Yes - as of 2026-09-30, its last commit was 2026-09-30. We re-verify nightly.

What can three.ws Herald do?

An agent gets 3 documented tools across announce, check, including announce, announce_result, check_rail.

How do I install three.ws Herald?

Run `npx -y @three-ws/herald-mcp`. The README documents one environment variable (THREE_WS_API_KEY) to set first. You can also paste the ready-made client config above.

Does three.ws Herald run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to three.ws Herald

Alternatives to three.ws Herald

Maintained AI & ML servers if three.ws Herald isn't the fit.

Pairs well with

Servers that cover what three.ws Herald doesn't - only shown when the pairing reason fits the companion.

More AI & ML MCP servers · three.ws Home · IBM watsonx.ai Granite · three.ws Intel · three.ws Knock · three.ws KOL