three.ws Coin Clash — Claude Code MCP server: how to install
Connects agents to the three.ws Coin Clash token war: monitors active battles, validates Solana coin ownership, and submits battle taps for your chosen side.
claude mcp add --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --env SOLANA_SECRET_KEY=<SOLANA_SECRET_KEY> --transport stdio clash-mcp -- npx -y @three-ws/clash-mcpWhat three.ws Coin Clash does
This server connects AI assistants to the community token battlefield over stdio. It exposes four tools: get_clash_state checks current matchups and round timers, get_clash_leaderboard fetches win-loss records, enlist_faction verifies token holdings, and rally_faction converts taps into faction battle score.
Public queries require no authentication. They pull live statistics directly from the backend endpoint at https://three.ws. Submitting power or joining a side requires a base58 Solana private key provided in SOLANA_SECRET_KEY or through tool arguments. The system checks on-chain balances without moving funds or executing transfers.
Running the package requires Node.js 20 or higher. Without the target token present in the signer wallet, faction enlistment fails with a not_a_holder response.
What it helps with
- monitor live battle arena matchups and remaining round time
- check all-time community records and leaderboards
- verify Solana token holdings with cryptographic proof
- contribute battle taps to boost faction momentum
Example prompts for the agent
- Check the current Coin Clash arena board and show who is leading
- Enlist my Solana wallet for the faction token to get a war pass
- Spend 50 taps to support our team via rally_faction
How to install three.ws Coin Clash
Platform CLI
claude mcp add --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --env SOLANA_SECRET_KEY=<SOLANA_SECRET_KEY> --transport stdio clash-mcp -- npx -y @three-ws/clash-mcpReplace <…> with your own values
Platform CLI
codex mcp add clash-mcp --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --env SOLANA_SECRET_KEY=<SOLANA_SECRET_KEY> -- npx -y @three-ws/clash-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"clash-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/clash-mcp"
],
"env": {
"THREE_WS_BASE": "<THREE_WS_BASE>",
"THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>",
"SOLANA_SECRET_KEY": "<SOLANA_SECRET_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"clash-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/clash-mcp"
],
"env": {
"THREE_WS_BASE": "<THREE_WS_BASE>",
"THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>",
"SOLANA_SECRET_KEY": "<SOLANA_SECRET_KEY>"
}
}
}
}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 SOLANA_SECRET_KEY=<SOLANA_SECRET_KEY> clash-mcp npx -y @three-ws/clash-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 Coin Clash
How to install three.ws Coin Clash in Claude Code?
Run claude mcp add clash-mcp -e SOLANA_SECRET_KEY=<SOLANA_SECRET_KEY> -- npx -y @three-ws/clash-mcp. The Solana key is only required if you plan to enlist or rally.
What does three.ws Coin Clash do?
It links your AI assistant to the Coin Clash token battlefield, allowing you to track matchups, prove token ownership, and add power to your community.
Does enlisting or rallying spend crypto funds?
No funds are spent. The tool signs a cryptographic challenge to verify that your wallet holds the required token, issuing a pass without creating a token transfer.
