AI Plugin Index
three.ws Herald
CommunityMCP server by nirholas · updated · ★ 241
Tell your human in person: a 3D character walks onto their open browser tab and says it out loud. three.ws Herald is a community project by nirholas, not verified by a company domain.
Last commit 3 days ago
Apache-2.0: permissive, fine for commercial use
Clear description, published package or server URL, 241 stars, original repository
Runs a script automatically when the package is installed
What you need
| Setting | Needed | What it is |
|---|---|---|
THREE_WS_API_KEYEnvironment variable, secret | Required | A 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. Alias |
THREE_WS_BASEEnvironment variable | Optional | Base URL of the three.ws API. Override only when self-hosting or targeting a preview deployment. Default: https://three.ws |
THREE_WS_TIMEOUT_MSEnvironment variable | Optional | Per-request timeout in milliseconds for the announce call. Default: 20000 |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Install three.ws Herald
Built from the published package, never by AIclaude mcp add three-ws-herald -e THREE_WS_API_KEY=YOUR_THREE_WS_API_KEY -- npx -y @three-ws/herald-mcpRun in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"three-ws-herald": {
"command": "npx",
"args": [
"-y",
"@three-ws/herald-mcp"
],
"env": {
"THREE_WS_API_KEY": "YOUR_THREE_WS_API_KEY"
}
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"three-ws-herald": {
"command": "npx",
"args": [
"-y",
"@three-ws/herald-mcp"
],
"env": {
"THREE_WS_API_KEY": "YOUR_THREE_WS_API_KEY"
}
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"three-ws-herald": {
"command": "npx",
"args": [
"-y",
"@three-ws/herald-mcp"
],
"env": {
"THREE_WS_API_KEY": "YOUR_THREE_WS_API_KEY"
}
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add three-ws-herald --env THREE_WS_API_KEY=YOUR_THREE_WS_API_KEY -- npx -y @three-ws/herald-mcp{
"mcpServers": {
"three-ws-herald": {
"command": "npx",
"args": [
"-y",
"@three-ws/herald-mcp"
],
"env": {
"THREE_WS_API_KEY": "YOUR_THREE_WS_API_KEY"
}
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
gemini mcp add three-ws-herald npx -y @three-ws/herald-mcpGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the three-ws-herald block.
Security check
B- Runs a script automatically when the package is installedIn
package.json:"postinstall":
Checked automatically: README.md, package.json. This looks for known risky patterns and is not a full audit. How grades work
Alternatives to three.ws Herald
All alternatives →
Browser agents and stealth cloud browsers for AI: run web tasks, fill forms, extract data.
Let your AI agent operate any website through a real, logged-in browser session.
Dark web OSINT over Tor: search onion engines, scrape pages, report with your own model.
Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.
draw.io diagrams your AI agent draws on a live browser canvas that you can also edit by hand
AI browser agent: browses, clicks, types, and reads real web pages from plain-English instructions.
three.ws Herald: common questions
How do I install three.ws Herald?
In Claude Code run claude mcp add three-ws-herald -e THREE_WS_API_KEY=YOUR_THREE_WS_API_KEY -- npx -y @three-ws/herald-mcp. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is three.ws Herald the official server?
three.ws Herald is a community project by nirholas, not verified by a company domain.
Is three.ws Herald free?
The code is published under the Apache-2.0 licence. The service it connects to may have its own pricing.
Is three.ws Herald safe to use?
It scores 82 of 100. Grades: maintenance A, licence A, quality B. Security check: grade B (runs a script automatically when the package is installed). Review the code before you install. How grades work.
What are alternatives to three.ws Herald?
Similar MCP servers: browser-use, Actionbook, Robin: AI-Powered Dark Web OSINT, Scrapling MCP Server.
Does three.ws Herald work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.