# Cabal-Hunter

> On-chain Solana token safety scanner. Tells you if you're the exit liquidity BEFORE you buy: it traces coordinated wallet funding, same-block Jito bundles, serial-rug deployers and live coordinated dumps, and returns one Exit-Liquidity Risk verdict (LOW | ELEVATED | HIGH).

Cabal-Hunter is built for both humans (a visual bubble map) and AI trading agents (an MCP server + REST API). It works on any Solana mint — pre-graduation on the pump.fun bonding curve or after, on PumpSwap/Raydium.

## What it detects
- Funding trace: top holders walked back to shared funding wallets (classic cabal signature), each with on-chain evidence transactions.
- Same-block bundle detection: wallets that bought in one Jito bundle (stealth launches).
- Coordinated dump detection: multiple holders selling a meaningful chunk in the exact same block — a cabal exiting in real time.
- Deployer track record: the creator wallet's full launch history (e.g. "launched 14 tokens, 13 dead" = SERIAL_RUGGER).
- CEX-noise filter: holders funded from a shared exchange are excluded so you don't get false positives.
- Exit-Liquidity Risk: the headline verdict synthesising all of the above.

## For AI agents (MCP)
- MCP endpoint: https://api.cabal-hunter.com/mcp
- Tool: check_cabal_risk(mintAddress) — call it before any Solana swap; abort if cabalScore >= 35 or isControlled is true.
- Works with Claude (Claude Code / Desktop), Cursor, and ElizaOS (x402 auto-payment).

## REST API
- POST https://api.cabal-hunter.com/api/scan-cabal {"mintAddress":"..."} — full analysis.
- GET https://api.cabal-hunter.com/map?mint=... — free visual bubble map.
- GET https://api.cabal-hunter.com/api/info — pricing, endpoints, response schema.

## Pricing
- Free: 100 queries/month per IP, no account, no API key.
- Then $0.02 USDC per query, paid natively on Solana (x402). No subscription.

## Links
- Site: https://api.cabal-hunter.com/
- X/Twitter: https://x.com/CabalhunterAPI
- Telegram (free live cabal alerts): https://t.me/CabalHunterAlerts
- GitHub template: https://github.com/paulf280-ui/solana-safe-sniper-mcp-template