Skip to content
MCP server

three.ws Herald

Tell your human in person: a 3D character walks onto their open browser tab and says it…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.0
Listing updated
6 days ago

About three.ws Herald

three.ws Herald is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Tell your human in person: a 3D character walks onto their open browser tab and says it out loud.

Install

Run in a terminal

claude mcp add herald-mcp --env THREE_WS_API_KEY='<THREE_WS_API_KEY>' -- npx -y @three-ws/herald-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "herald-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/herald-mcp"
      ],
      "env": {
        "THREE_WS_API_KEY": "<THREE_WS_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "herald-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/herald-mcp"
      ],
      "env": {
        "THREE_WS_API_KEY": "<THREE_WS_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "herald-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/herald-mcp"
      ],
      "env": {
        "THREE_WS_API_KEY": "<THREE_WS_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "herald-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/herald-mcp"
      ],
      "env": {
        "THREE_WS_API_KEY": "<THREE_WS_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "herald-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/herald-mcp"
      ],
      "env": {
        "THREE_WS_API_KEY": "<THREE_WS_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • THREE_WS_API_KEYA three.ws API key (sk_live_… / sk_test_…) with the herald:announce scope, or an OAuth access token for the same account, carried as Authorization: Bearer. Required: an announcement is always delivered to the key owner's own sessions. Aliases: THREE_WS_TOKEN, THREE_WS_BEARER. Treat like a password.Required
  • THREE_WS_BASEBase URL of the three.ws API. Override only when self-hosting or targeting a preview deployment.
  • THREE_WS_TIMEOUT_MSPer-request timeout in milliseconds for the announce call.

Pricing

Open source

Prices change. Check three.ws before you buy.

three.ws Herald FAQ

Is three.ws Herald free?

Yes. three.ws Herald is open source, so you can use and self-host it for free.

How do I add three.ws Herald to Claude Code?

Run this command in your terminal: claude mcp add herald-mcp --env THREE_WS_API_KEY='<THREE_WS_API_KEY>' -- npx -y @three-ws/herald-mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers