What is Rug Check Mcp

rug-check-mcp is an MCP server designed to detect potential risks associated with Solana meme tokens, assisting AI agents in avoiding rug pulls and unsafe projects.

Use cases

Use cases for rug-check-mcp include evaluating the safety of new meme tokens before investment, providing insights for developers on potential risks, and assisting traders in making informed decisions based on risk analysis.

How to use

To use rug-check-mcp, clone the repository, install the necessary dependencies, and configure the client with your Solsniffer API key. You can then utilize the ‘analysis_token’ tool to analyze specific Solana tokens by providing their addresses.

Key features

Key features include a token analysis tool that retrieves and processes token data from the Solsniffer API, and structured output that provides detailed information such as token name, symbol, Snif score, market cap, price, supply, risks, and audit status.

Where to use

rug-check-mcp can be used in the cryptocurrency and blockchain sectors, particularly for projects involving Solana meme tokens where risk assessment is crucial.

Rug-Check-MCP

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

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:

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

Manual Installation

1. Clone the Repository:

   git clone https://github.com/kukapay/rug-check-mcp.git
   cd rug-check-mcp
   

2. Install Dependencies:
   Ensure you have pip installed, then run:

   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:

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:

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:

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:

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.