RugCheck AI

by mrwizardlyloaf

Not rated
GitHub

About

On-chain Solana token safety: screens a token for rug pulls, honeypots and mint/freeze authority traps before an agent trades.

Details

Author
mrwizardlyloaf
Categories
Finance, Other, Security

Setup

Install RugCheck AI in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/mrwizardlyloaf/rugcheck-ai

Follow the installation instructions in the repository README, then restart your MCP client.

πŸ›‘οΈ RugCheck AI β€” On-chain Token Safety for Solana AI Agents

A lightweight MCP server that reads a Solana token's mintdirectly from the chainto screen for the common rug & honeypot trapsbeforeyour agent trades β€” active mint/freeze authority and dangerous Token-2022 extensions (permanent delegate, transfer hooks, non-transferable, pausable) β€” then, for tokens that pass, builds the buy as anunsignedJupiter transaction carrying a small Jito tip for faster inclusion. You sign it; the server never holds keys.

No install, no API key. Point your agent at the remote endpoint:

https://web-production-58d585.up.railway.app/mcp
scan_token("DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263") # BONK β†’ { verdict: "SAFE", safety_score: 100, sellable: true, risks: ["no red flags found"] }

SAFE→ clear.CAUTION→ read the risks.DANGER→ don't buy. That's the whole loop.

Three real mainnet tokens, onescan_tokencall each (scanned 2026-06-17 β€” re-run to verify, live state changes):

The honeypot is the one that matters: you could buy it and never sell. RugCheck AI flags itbeforeyour agent spends a cent β€” even though the token is too new to be indexed anywhere else. Even USDC comes backCAUTION, notSAFE, because the issuer can still freeze your balance β€” the verdict tells you the truth, not a marketing label.

- scan_tokenβ€” full safety report in one call: authority, Token-2022 traps, honeypot, liquidity & holder concentration β†’ SAFE/CAUTION/DANGER + a 0–100 score
- is_safeβ€” quick yes/no gate: one boolean before you trade
- verify_token_safetyβ€” on-chain audit: mint/freeze authority + Token-2022 traps + live market
- check_authoritiesβ€” mint / freeze authority and extension detection
- simulate_sellβ€” can the token actually be sold? (honeypot check)
- simulate_tradeβ€” full round-trip (buy then sell back): real entry/exit cost & round-trip loss %
- check_liquidityβ€” DEX liquidity, 24h volume, age, buys/sells
- holders_breakdownβ€” top-holder concentration (dump risk)
- token_ageβ€” freshness + real trading activity
- rug_forecastβ€” heuristic rug ETA: probability + urgency window + factors
- scammer_dnaβ€” intent score (0–100): how much the token's structure looks like a deliberate scam
- check_deployerβ€” the wallets that hold power over the token
- compare_tokensβ€” rank a basket of tokens safest-first
- batch_scanβ€” scan up to 10 tokens at once, one report each

- execute_safe_swapβ€” re-screens the mint, then builds a Jito-tipped Jupiter swap (unsigned); refuses tokens that scan DANGER

Remote (Streamable HTTP)β€” no install, point your agent at:

https://web-production-58d585.up.railway.app/mcp

Listed on theofficial MCP Registryasio.github.MrWizardlyLoaf/rugcheck-ai.

pip install -r requirements.txt SOLANA_RPC=<your-rpc-url> python server.py

Cline / Claude Dev (VS Code)β€” incline_mcp_settings.json:

{ "mcpServers": { "rugcheck-ai": { "url": "https://web-production-58d585.up.railway.app/mcp" } } }

Claude Desktopβ€” inclaude_desktop_config.json:

{ "mcpServers": { "rugcheck-ai": { "command": "npx", "args": ["-y", "mcp-remote", "https://web-production-58d585.up.railway.app/mcp"] } } }

Cursorβ€” Settings β†’ MCP β†’ Add β†’ Streamable HTTP, then paste the endpoint URL.

Any MCP clientβ€” it's a standard Streamable HTTP MCP server; point your client at the/mcpendpoint and the 15 tools appear.

Most agents trade Solana tokens blind. RugCheck AI callsgetAccountInfoon the mint and reads the authorities and Token-2022 extensions itself, so you get a real verdict on a fresh launch instead ofunknownβ€” and a live mint or freeze authority is flagged before you buy, not after.

Your agent needs to answer, before it spends a cent:

- Is this Solana token safe to buy β€” or is it a rug pull?
- Is this a honeypot β€” will I actually be able to sell after I buy?
- Does the mint have an active freeze / mint authority that can trap or dilute me?
- Is there a hidden Token-2022 trap (permanent delegate, transfer hook) that can drain me?
- Pre-trade screening / token due-diligence for an autonomous trading agent.

Built for AI trading agents, snipers and bots that buy SPL / Token-2022 tokens and need a fast on-chain rug check before entering β€” then a screened Jupiter route once a token clears.

How do I check if a Solana token is safe to buy?Callscan_token(mint)β€” one call returns a SAFE / CAUTION / DANGER verdict covering mint/freeze authority, Token-2022 traps, honeypot (sellability), liquidity and holder concentration, plus a 0–100 safety score.

How do I detect a honeypot before buying?simulate_sell(mint)checks whether a live sell route exists β€” a token with no route is effectively a honeypot even when nothing on-chain formally blocks selling.

How do I check holder concentration / whale dump risk?holders_breakdown(mint)reports the largest wallets and what share of supply they control β€” high concentration means one holder can crash the price on you.

How do I know if a token is a rug pull?rug_forecast(mint)gives a heuristic rug probability and urgency window from real signals (authority, Token-2022 traps, concentration, sell pressure, age).check_authoritiesandcheck_deployershow exactly who holds power over the token.

Does it work on fresh / newly launched tokens?Yes β€” it reads the mint directly on-chain (getAccountInfo), so you get a real verdict on a token too new to be indexed elsewhere.token_ageshows freshness and real trading activity.

Does it touch my wallet or sign anything?No. Screening is read-only;execute_safe_swaponly builds an UNSIGNED transaction for you to sign β€” the server never holds keys, never signs, never sends.

Is it free? Do I need an API key?Remote server, no install, no API key. Point your agent at the endpoint and call the tools.

v1.2.0 β€” working, actively developed, CI-tested. Open source, auditable β€” the screening tools are read-only (getAccountInfo);execute_safe_swaponly builds an unsigned transaction for you to sign.

MIT licensed. Self-hostable. Built for Solana trading agents.

Crypto data & trading MCP with 42+ tools: prices, DeFi, NFTs, Solana swaps

MCP server for Fuse Network: balances, tokens, staking, DeFi data, swaps and on-chain transactions.

MCP server for the Ophis intent-based DEX aggregator: quotes and gasless, MEV-protected swap orders across 11 chains.

Interact with the Borrow Automated Market Maker (BAMM) protocol on the Fraxtal blockchain.

On-chain automated trading strategies (DEX) for AI agents. Create limit orders, range orders, recurring buy-low-sell-high strategies, and concentrated liquidity positions across Ethereum, Sei, Celo, TAC, and COTI. Unlike traditional AMMs and liquidity pools, Carbon lets you set asymmetric price ranges - your buy and sell orders are independent, not mirrored. Backtest any strategy against historical prices before going on-chain, explore market liquidity, find discount entry points, and swap tokens against Carbon DeFi's maker liquidity. 25 tools. Returns unsigned transactions β€” agents never hold funds or private keys. Zero gas on fills.

Pool data, swap rates, and liquidity info on Curve Finance.

Official deBridge protocol MCP Server. Finds optimal cross-chain swap routes, checks fees and conditions, initiates trades across major blockchain networks

AI-powered Solana token rug pull detection with ML ensemble scoring, honeypot detection, and temporal rug stage prediction.

Interact with the Futarchy protocol on the Solana blockchain.

A server for interacting with the Futarchy protocol on the Solana blockchain.

No reviews yet β€” be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.