@wealthville/mcp-server

Wealthville MCP Server

Gives AI assistants (Claude, Cursor, or anything that speaks MCP) live access to Wealthville pool scores — Enter/Hold/Exit verdicts and the composite Wealthville Score (0–100) for Solana + EVM liquidity pools, plus the public, miss-inclusive track record.

Ask your assistant things like:

"Is this Meteora pool safe to LP into?" · "What are the top 10 Solana pools right now?" · "How has Wealthville's ENTER signal performed lately?"

Tools

Tool	What it does
get_pool_score	Verdict + 4 scores for one pool (Solana base58, EVM 0x, or DefiLlama UUID)
get_top_pools	Pools ranked by Wealthville Score (limit, chain)
get_track_record	Live hit rates + IL-adjusted PnL, misses included (days)
get_signals_feed	Latest published ENTER/EXIT signals (limit)

Every response includes the methodology link and the "not financial advice" note, so assistants relay them.

Install

Claude Code:

claude mcp add wealthville -- npx -y @wealthville/mcp-server

Claude Desktop / other MCP clients — add to the MCP config:

{
  "mcpServers": {
    "wealthville": {
      "command": "npx",
      "args": ["-y", "@wealthville/mcp-server"]
    }
  }
}

From source: npm install && npm run build, then point your MCP config at node dist/index.js.

Hosted / remote (HTTP)

For platforms that need an HTTPS endpoint (e.g. Smithery's "MCP Server URL"), the same server also runs over Streamable HTTP at POST /mcp — stateless, so it scales horizontally. Build the image and host it anywhere:

docker build -f Dockerfile.http -t wealthville-mcp-http .
docker run -p 8080:8080 wealthville-mcp-http
# health:  curl -s localhost:8080/health
# then expose it over HTTPS and use  https://<your-host>/mcp

Or without Docker: npm run build && npm run start:http (listens on $PORT, default 8080). Per-request config is accepted via ?config=<base64 JSON>, ?wealthvilleApiKey=…, or an x-api-key header; otherwise the WEALTHVILLE_* env vars below apply.

Configuration (optional)

Env var	Purpose
WEALTHVILLE_API_KEY	Partner key → higher rate limit (get one at wealthville.net/developers)
WEALTHVILLE_API_URL	Override the API base URL (default https://wealthville.net)

No key is required — anonymous access is 60 req/min per IP.

Notes

• Read-only: this server only calls public GET endpoints; it never touches wallets or signs anything.
• Data is a product of Wealthville; it is not financial advice.