three.ws Herald
Tell your human in person: a 3D character walks onto their open browser tab and says it…
- 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-mcpAdd 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.RequiredTHREE_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.