three.ws Alerts — Claude Code MCP server: pump.fun alerts
An MCP server that lets your agent define pump.fun alert rules and read back what fired, across three delivery channels.
claude mcp add --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --env THREE_WS_SESSION=<THREE_WS_SESSION> --transport stdio alerts-mcp -- npx -y @three-ws/alerts-mcpWhat three.ws Alerts does
Your agent gets five tools: list, create, update and delete rules, plus alert history. Rules watch pump.fun events such as token graduations, market-cap thresholds, large buys and new mints. Evaluation runs on the three.ws cron, so a rule fires with no dashboard open.
Delivery goes in-app, to an HTTPS webhook, or to Telegram. Each rule with a webhook gets its own secret, used to sign a request header so you can verify the call on your end. Repeated fires are throttled by cooldown_seconds.
Node.js 20 or newer is required, along with the __Host-sid cookie from a signed-in three.ws session, passed as THREE_WS_SESSION. That value grants account access — store it like a password. Without a live session the server has nothing to write to, since every call is account-scoped. create_alert_rule adds a new rule on each call, so a retry after a timeout can hit the rule cap; pause with update_alert_rule and enabled:false instead of using delete, which wipes the history too.
What it helps with
- watch token graduations and get a Telegram message
- catch large SOL buys on a specific mint
- review fired alerts with per-channel delivery health
- pause a rule without losing its delivery history
- spot a market anomaly by processor and severity level
Example prompts for the agent
- List my alert rules and their delivery health
- Create a graduation rule for agent
8a1c…-uuidwith a webhook and Telegram - Show the last two alerts that fired
How to install three.ws Alerts
Platform CLI
claude mcp add --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --env THREE_WS_SESSION=<THREE_WS_SESSION> --transport stdio alerts-mcp -- npx -y @three-ws/alerts-mcpReplace <…> with your own values
Platform CLI
codex mcp add alerts-mcp --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --env THREE_WS_SESSION=<THREE_WS_SESSION> -- npx -y @three-ws/alerts-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"alerts-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/alerts-mcp"
],
"env": {
"THREE_WS_BASE": "<THREE_WS_BASE>",
"THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>",
"THREE_WS_SESSION": "<THREE_WS_SESSION>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"alerts-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/alerts-mcp"
],
"env": {
"THREE_WS_BASE": "<THREE_WS_BASE>",
"THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>",
"THREE_WS_SESSION": "<THREE_WS_SESSION>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e THREE_WS_BASE=<THREE_WS_BASE> -e THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> -e THREE_WS_SESSION=<THREE_WS_SESSION> alerts-mcp npx -y @three-ws/alerts-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about three.ws Alerts
How do I install three.ws Alerts in Claude Code?
Run claude mcp add alerts-mcp -e THREE_WS_SESSION=<THREE_WS_SESSION> -- npx -y @three-ws/alerts-mcp. To also set THREE_WS_BASE and THREE_WS_TIMEOUT_MS, use the explicit transport form: `claude mcp add --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --env THREE_WS_SESSION=<THREE_WS_SESSION> --transport stdio alerts-mcp -- npx -y @three-ws/alerts-mcp`.
What does three.ws Alerts do?
It manages pump.fun alert rules and returns the history of fired alerts. Rules belong to your three.ws account, and the three.ws cron does the checking.
Where does THREE_WS_SESSION come from?
It is the value of the __Host-sid cookie in a browser signed in to three.ws: DevTools → Application → Cookies → __Host-sid. No Solana key or signer is involved.
