Rug-Check-MCP

Rug-Check-MCP

Detect risks in Solana meme tokens to prevent rug pulls

15
Stars
8
Forks
15
Watchers
3
Issues
Rug-Check-MCP is an MCP server designed to analyze Solana meme tokens for potential risks, leveraging data from the Solsniffer API. It provides comprehensive token analysis through the 'analysis_token' tool, delivering structured information on risk scores, market data, and security factors. The solution aids AI agents and clients in identifying high-risk or unsafe projects, helping protect users from fraudulent tokens. Installation is streamlined for Smithery and manual Python environments.

Key Features

Analyzes Solana token addresses for potential risks
Integrates with the Solsniffer API for real-time token data
Structured output detailing token risk factors and market indicators
Identifies high, moderate, and low risk parameters
Reports on audit risks including mint/freeze status and liquidity analysis
Easy installation via Smithery or manual Python setup
CLI tool compatible with MCP clients
Supports environment variables for secure API key handling
Provides output in standardized dictionary format for AI consumption
Designed to help AI agents avoid unsafe or fraudulent Solana projects

Use Cases

Detecting potential rug pulls in Solana meme tokens
Automated risk analysis for AI-driven investment tools
Integrating token security checks into blockchain wallets
Providing due diligence for Solana token listing platforms
Assisting compliance and auditing in decentralized finance (DeFi)
Alerting users or bots to high-risk Solana assets
Enabling safe token discovery for crypto trading applications
Enhancing portfolio management with security-focused analysis
Supporting regulators and analysts with risk intelligence
Supplying MCP-compatible clients with token vulnerability data

README

Rug-Check-MCP

An MCP server that detects potential risks in Solana meme tokens, helping AI agents avoid rug pulls and unsafe projects.

License Python Version smithery badge

Features

  • Token Analysis Tool: The analysis_token tool retrieves and processes Solana token data from the Solsniffer API.
  • Structured Output: Returns detailed token information including name, symbol, Snif score, market cap, price, supply, risks, and audit status.

Prerequisites

  • Python 3.10 or higher
  • A Solsniffer API key (sign up at Solsniffer to obtain one)

Installation

Installing via Smithery

To install Rug Check for Claude Desktop automatically via Smithery:

bash
npx -y @smithery/cli install @kukapay/rug-check-mcp --client claude

Manual Installation

  1. Clone the Repository:

    bash
    git clone https://github.com/kukapay/rug-check-mcp.git
    cd rug-check-mcp
    
  2. Install Dependencies: Ensure you have pip installed, then run:

    bash
    pip install mcp[cli] requests python-dotenv
    
  3. Client Configuration:

    "mcpServers": { 
      "rug-check-mcp": { 
        "command": "python", 
        "args": ["path/to/rug-check-mcp/main.py"], 
        "env": { 
          "SOLSNIFFER_API_KEY": "your_solsniffer_api_key_here" 
        } 
      } 
    }
    

Tool: analysis_token

  • Description: Analyzes a Solana token based on its address.
  • Input: token_address (string) - The Solana token address to analyze.
  • Output: A dictionary containing:
    • token_address: Token address
    • token_name: Token name
    • token_symbol: Token symbol
    • snif_score: Solsniffer risk score (0-100)
    • market_cap: Market capitalization in USD
    • price: Token price in USD
    • supply_amount: Total supply of the token
    • risks: High, moderate, and low risk details with counts and descriptions
    • audit_risk: Audit status (mint/freeze disabled, LP burned, top 10 holders)

Example Output

For token address 9VxExA1iRPbuLLdSJ2rB3nyBxsyLReT4aqzZBMaBaY1p:

json
{
  'token_address': '9VxExA1iRPbuLLdSJ2rB3nyBxsyLReT4aqzZBMaBaY1p',
  'token_name': 'REVSHARE',
  'token_symbol': 'REVS',
  'snif_score': 55,
  'market_cap': 271893.9423965262,
  'price': 0.000280011574,
  'supply_amount': 971009656.8955618,
  'risks': {
    'high': {
      'count': 3,
      'details': {
        'Mintable risks found': True,
        'Freeze risks found': True,
        'A private wallet owns a significant share of the supply': False,
        'Tokens auto-freeze risks found': True,
        'Significant ownership by top 10 wallets': False,
        'Significant ownership by top 20 wallets': False,
        'Permanent control risks found': True,
        'Presence of token metadata': True,
        'High locked supply risks found': None,
        'Sufficient liquidity detected': None,
        'Very low liquidity': None
      }
    },
    'moderate': {
      'count': 3,
      'details': {
        'Token metadata are immutable': False,
        'Token operates without custom fees': False,
        'Token has recent user activity': True,
        'Unknown liquidity pools': False,
        'Low count of LP providers': True
      }
    },
    'low': {
      'count': 1,
      'details': {
        'Contract was not recently deployed': False
      }
    }
  },
  'audit_risk': {
    'mint_disabled': True,
    'freeze_disabled': True,
    'lp_burned': False,
    'top_10_holders_significant': False
  }
}

Prompt Examples

Below are examples of prompts you might use in an MCP-compatible client (e.g., Claude Desktop) and the expected responses after the analysis_token tool is invoked.

Prompt:

"Can you analyze the Solana token at address 9VxExA1iRPbuLLdSJ2rB3nyBxsyLReT4aqzZBMaBaY1p?"

Response:

plaintext
I've analyzed the token at address 9VxExA1iRPbuLLdSJ2rB3nyBxsyLReT4aqzZBMaBaY1p. Here's the summary:

- Token Name: REVSHARE (Symbol: REVS)
- Snif Score: 55/100 (Moderate risk)
- Market Cap: $288,875.29
- Price: $0.000297
- Total Supply: 971,266,696.90 tokens
- Risks:
  - High (3 risks):
    - Mintable risks found: True
    - Freeze risks found: True
    - Permanent control risks found: True
    - (Other factors: False)
  - Moderate (1 risk):
    - Low count of LP providers: True
    - (Other factors: False)
  - Low (0 risks):
    - (All factors: False)
- Audit Status:
  - Mint Disabled: Yes
  - Freeze Disabled: Yes
  - LP Burned: No
  - Top 10 Holders Significant: No

This token has moderate risks due to potential control issues and liquidity concerns, but minting and freezing are disabled for added safety.     

Prompt:

"What’s the risk profile of the token So11111111111111111111111111111111111111112?"

Response:

plaintext
Here's the risk profile for the token at address So11111111111111111111111111111111111111112:

- Token Name: Wrapped SOL (Symbol: SOL)
- Snif Score: 92/100 (Low risk)
- Market Cap: $82,345,678.90
- Price: $176.54
- Total Supply: 466,567,890.12 tokens
- Risks:
  - High (0 risks):
    - (All factors: False)
  - Moderate (0 risks):
    - (All factors: False)
  - Low (1 risk):
    - Minor liquidity concentration: True
    - (Other factors: False)
- Audit Status:
  - Mint Disabled: Yes
  - Freeze Disabled: Yes
  - LP Burned: Yes
  - Top 10 Holders Significant: No

Wrapped SOL is a low-risk token with strong audit protections and only a minor liquidity concern, typical for a well-established asset.     

Prompt:

"Tell me about the token 4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R."

Response:

plaintext
Here's the analysis for the token at address 4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R:

- Token Name: Raydium (Symbol: RAY)
- Snif Score: 85/100 (Low risk)
- Market Cap: $1,234,567.89
- Price: $4.72
- Total Supply: 261,567,890.12 tokens
- Risks:
  - High (0 risks):
    - (All factors: False)
  - Moderate (1 risk):
    - Moderate holder concentration: True
    - (Other factors: False)
  - Low (0 risks):
    - (All factors: False)
- Audit Status:
  - Mint Disabled: Yes
  - Freeze Disabled: Yes
  - LP Burned: Yes
  - Top 10 Holders Significant: No

Raydium is a low-risk token with solid audit protections. The moderate holder concentration indicates some centralization, but it’s not a major issue.     

License

This project is licensed under the MIT License. See LICENSE for details.

Star History

Star History Chart

Repository Owner

kukapay
kukapay

User

Repository Details

Language Python
Default Branch main
Size 20 KB
Contributors 2
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

Python
89.71%
Dockerfile
10.29%

Tags

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • solscan-mcp

    solscan-mcp

    A Rust-based MCP server for querying Solscan Pro API on Solana blockchain data.

    solscan-mcp provides a Model Context Protocol (MCP) server that interfaces with the Solscan Pro API to deliver blockchain data from the Solana network. Built in Rust, it allows querying of token information, account activities, and transactions, and is designed for easy integration with language models. The tool supports context-driven investigations by leveraging AI to analyze and report on blockchain wallet behaviors using customized context inputs.

    • 32
    • MCP
    • wowinter13/solscan-mcp
  • SafeDep VET

    SafeDep VET

    Enterprise-grade open source software supply chain security with MCP capabilities.

    SafeDep VET is an open source tool that provides supply chain security for open source software, featuring advanced software composition analysis and policy-as-code driven security enforcement. It supports multiple package ecosystems and integrates with CI/CD pipelines. Notably, it offers an MCP (Model Context Protocol) server mode to vet open source packages arising from AI-suggested code, and includes agent-based querying and scan result analysis powered by AI. The tool enables real-time malicious package detection through cloud integration and prioritizes actionable insights by analyzing actual code usage.

    • 829
    • MCP
    • safedep/vet
  • Wallet Inspector MCP

    Wallet Inspector MCP

    Empowering AI agents to inspect wallet balances and onchain activity across multiple blockchains.

    Wallet Inspector MCP is an MCP server that enables AI agents to query wallet balances and view onchain activity on major EVM chains as well as the Solana blockchain. It supports flexible output formats, multi-chain querying, and is designed for integration with MCP-compatible clients such as Claude Desktop CLI. The tool facilitates secure, natural language interactions to check balances, activities, and transaction histories for any supported wallet address.

    • 7
    • MCP
    • kukapay/wallet-inspector-mcp
  • solvitor-mcp

    solvitor-mcp

    A Rust-based MCP server for extracting Solana smart contract IDL via the Solvitor API.

    solvitor-mcp is a Model Context Protocol (MCP) server built in Rust for seamless interaction with the Solvitor API. It allows users to extract Interface Definition Language (IDL) files from closed-source Solana smart contracts using reverse engineering techniques. By exposing a 'decode' tool, it simplifies access to program metadata and supports both 'anchor' and 'native' Solana programs. Integration is straightforward and can be customized with user API keys for secure access.

    • 2
    • MCP
    • Adeptus-Innovatio/solvitor-mcp
  • Aiwen MCP Server for IP Geolocation

    Aiwen MCP Server for IP Geolocation

    High-precision IP geolocation and risk analysis via MCP-compatible API server.

    Provides an MCP (Model Context Protocol) server interface for Aiwen Technology’s high-precision IP location services, offering a range of geolocation, network, risk, and identity APIs compatible with AI context standards. Supports detailed IP information retrieval, including geolocation to city, district, or street level, network characteristics, industry classification, risk profiling, and user authenticity analysis. Enables seamless AI model integration and context-aware processing by following the MCP protocol.

    • 4
    • MCP
    • ipfred/aiwen-mcp-server-geoip
  • Token Minter MCP

    Token Minter MCP

    MCP server enabling AI agents to mint and manage ERC-20 tokens on 21 blockchains.

    Token Minter MCP is an MCP server that empowers AI agents to deploy and manage ERC-20 tokens across 21 blockchains. It provides tools to create tokens, query metadata, initiate token transfers, and retrieve transaction details. The server also offers interactive prompts to guide token deployment and exposes token metadata via standardized URIs. Built on Node.js, it integrates with EVM networks using Infura and private keys for transaction signing.

    • 17
    • MCP
    • kukapay/token-minter-mcp
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results