three.ws Alerts
three.ws Alerts is an MCP server that adds finance tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Create, update, and delete pump.fun alert rules and read fired-alert history across channels. It has 282 GitHub stars, is released under the Apache-2.0 license and runs locally with npx -y @three-ws/alerts-mcp.
github.com/nirholas/three.ws (opens in a new tab)
Data as of from the GitHub API and the official MCP registry; description from the project's repository. Report an error
Install three.ws Alerts
Generated from the server's MCP registry entry. Replace your-value with your own values.
Claude Desktop
{
"mcpServers": {
"three-ws-alerts": {
"command": "npx",
"args": [
"-y",
"@three-ws/alerts-mcp"
],
"env": {
"THREE_WS_SESSION": "your-value"
}
}
}
}Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.
Claude Code
claude mcp add --env THREE_WS_SESSION=your-value --transport stdio three-ws-alerts -- npx -y @three-ws/alerts-mcpCursor
{
"mcpServers": {
"three-ws-alerts": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/alerts-mcp"
],
"env": {
"THREE_WS_SESSION": "your-value"
}
}
}
}Project file; use ~/.cursor/mcp.json to enable it in every project.
VS Code
{
"inputs": [
{
"type": "promptString",
"id": "three_ws_session",
"description": "THREE_WS_SESSION",
"password": true
}
],
"servers": {
"three-ws-alerts": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/alerts-mcp"
],
"env": {
"THREE_WS_SESSION": "${input:three_ws_session}"
}
}
}
}Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).
Environment variables
Variables the server reads at startup.
| Name | Required | Description |
|---|---|---|
THREE_WS_BASE | No | Base URL of the three.ws API that serves the alert-rules and notifications endpoints. Override only when self-hosting or targeting a preview deployment. |
THREE_WS_TIMEOUT_MS | No | Per-request timeout in milliseconds for the live three.ws API reads and writes. |
THREE_WS_SESSIONsecret | Yes | Your three.ws session token (the value of the Host-sid cookie from a signed-in browser). Required by every tool — all rules and alerts are scoped to YOUR… |
Tools (12)
Parsed from the Tools section of the README; check the repository for the current list.
list_alert_rulesread-only
create_alert_rulewrite (appends)
update_alert_rulewrite (idempotent)
delete_alert_rulewrite (destructive)
get_alert_historyread-only
kindTarget
graduationglobal, or targetmint / targetagent
price_abovetargetmint (required)
price_belowtargetmint (required)
whale_buytargetmint (required)
new_minttargetagent (required)
market_anomalynone (whole market); optional filters: processors (price, tvl, stablecoinsupply, stablecoinpeg, funding,…
About three.ws Alerts
Run your own pump.fun monitoring from any AI agent — define alert rules, deliver them in-app / by signed webhook / to Telegram, and read the fired-alert history.
- avatar
- ai-agents
- mcp-server
- solana
- text-to-3d
- threejs
- x402
- claude-code-plugin
Similar MCP servers
More finance MCP servers
Tapetide - Indian Stock Market MCP
Tapetide-hq/nse-bse-indian-stock-market-data-mcp
48 tools for ~8,000 NSE & BSE stocks: quotes, screener, financials, filings, FII/DII, options.
Maintained · last commit Nov 13, 2026
OfficialFinanceTypeScriptCodespar Adyen
codespar/mcp-dev-latam
MCP server for Adyen Checkout API v71 — enterprise payments (iFood, Uber, Spotify in LatAm).
Maintained · last commit Sep 27, 2026
FinanceTypeScriptFullbleed PDF Engine
fullbleed-engine/fullbleed-official
Create, preview, inspect, verify, and compile deterministic PDF documents with Fullbleed.
Active · last commit Nov 7, 2026
FinanceRustFinancial Modeling Prep MCP Server
imbenrabi/Financial-Modeling-Prep-MCP-Server
MCP server for Financial Modeling Prep API with 250+ financial data tools.
Active · last commit Nov 5, 2026
FinanceTypeScriptYolfi Payments MCP
yolfinance/yolfi-agent
Let AI agents add Yolfi crypto checkout, paylinks, webhooks, and status checks.
Active · last commit Oct 27, 2026
FinanceJavaScriptOctagon MCP Server
OctagonAI/octagon-mcp-server
An MCP server for public & prediction markets research.
Maintained · last commit Nov 15, 2026
OfficialFinanceTypeScript
How do I install the three.ws Alerts MCP server?
Add the command npx -y @three-ws/alerts-mcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.
Is three.ws Alerts free?
The server is open source under the Apache-2.0 license, so running it is free. It needs credentials (THREE_WS_SESSION) for the service it connects to, which may require a paid account.
Is three.ws Alerts actively maintained?
The most recent commit was on Nov 15, 2026. The latest release is v2026.11.09, published Nov 9, 2026. appsgit only lists MCP servers with a commit in the last six months.