Rug Check MCP

1# Rug-Check-MCP
2 
3An MCP server that detects potential risks in Solana meme tokens, helping AI agents avoid rug pulls and unsafe projects.
4 
5![License](https://img.shields.io/github/license/kukapay/rug-check-mcp)
6![Python Version](https://img.shields.io/badge/python-3.10%2B-blue)
7[![smithery badge](https://smithery.ai/badge/@kukapay/rug-check-mcp)](https://smithery.ai/server/@kukapay/rug-check-mcp)
8 
9## Features
10 
11- **Token Analysis Tool**: The `analysis_token` tool retrieves and processes Solana token data from the Solsniffer API.
12- **Structured Output**: Returns detailed token information including name, symbol, Snif score, market cap, price, supply, risks, and audit status.
13 
14## Prerequisites
15 
16- Python 3.10 or higher
17- A Solsniffer API key (sign up at [Solsniffer](https://solsniffer.com) to obtain one)
18 
19## Installation
20 
21### Installing via Smithery
22 
23To install Rug Check for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@kukapay/rug-check-mcp):
24 
25```bash
26npx -y @smithery/cli install @kukapay/rug-check-mcp --client claude
27```
28 
29### Manual Installation
301. **Clone the Repository**:
31   ```bash
32   git clone https://github.com/kukapay/rug-check-mcp.git
33   cd rug-check-mcp
34   ```
35 
362. **Install Dependencies**:
37   Ensure you have `pip` installed, then run:
38   ```bash
39   pip install mcp[cli] requests python-dotenv
40   ```
41 
423. **Client Configuration**:
43 
44    ```
45    "mcpServers": { 
46      "rug-check-mcp": { 
47        "command": "python", 
48        "args": ["path/to/rug-check-mcp/main.py"], 
49        "env": { 
50          "SOLSNIFFER_API_KEY": "your_solsniffer_api_key_here" 
51        } 
52      } 
53    }
54    ```
55 
56## Tool: `analysis_token`
57 
58- **Description**: Analyzes a Solana token based on its address.
59- **Input**: `token_address` (string) - The Solana token address to analyze.
60- **Output**: A dictionary containing:
61  - `token_address`: Token address
62  - `token_name`: Token name
63  - `token_symbol`: Token symbol
64  - `snif_score`: Solsniffer risk score (0-100)
65  - `market_cap`: Market capitalization in USD
66  - `price`: Token price in USD
67  - `supply_amount`: Total supply of the token
68  - `risks`: High, moderate, and low risk details with counts and descriptions
69  - `audit_risk`: Audit status (mint/freeze disabled, LP burned, top 10 holders)
70 
71  
72### Example Output
73For token address `9VxExA1iRPbuLLdSJ2rB3nyBxsyLReT4aqzZBMaBaY1p`:
74```json
75{
76  'token_address': '9VxExA1iRPbuLLdSJ2rB3nyBxsyLReT4aqzZBMaBaY1p',
77  'token_name': 'REVSHARE',
78  'token_symbol': 'REVS',
79  'snif_score': 55,
80  'market_cap': 271893.9423965262,
81  'price': 0.000280011574,
82  'supply_amount': 971009656.8955618,
83  'risks': {
84    'high': {
85      'count': 3,
86      'details': {
87        'Mintable risks found': True,
88        'Freeze risks found': True,
89        'A private wallet owns a significant share of the supply': False,
90        'Tokens auto-freeze risks found': True,
91        'Significant ownership by top 10 wallets': False,
92        'Significant ownership by top 20 wallets': False,
93        'Permanent control risks found': True,
94        'Presence of token metadata': True,
95        'High locked supply risks found': None,
96        'Sufficient liquidity detected': None,
97        'Very low liquidity': None
98      }
99    },
100    'moderate': {
101      'count': 3,
102      'details': {
103        'Token metadata are immutable': False,
104        'Token operates without custom fees': False,
105        'Token has recent user activity': True,
106        'Unknown liquidity pools': False,
107        'Low count of LP providers': True
108      }
109    },
110    'low': {
111      'count': 1,
112      'details': {
113        'Contract was not recently deployed': False
114      }
115    }
116  },
117  'audit_risk': {
118    'mint_disabled': True,
119    'freeze_disabled': True,
120    'lp_burned': False,
121    'top_10_holders_significant': False
122  }
123}
124```
125 
126### Prompt Examples
127 
128Below 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.
129 
130**Prompt**: 
131 
132> "Can you analyze the Solana token at address `9VxExA1iRPbuLLdSJ2rB3nyBxsyLReT4aqzZBMaBaY1p`?"
133   
134**Response**:
135```plaintext
136I've analyzed the token at address 9VxExA1iRPbuLLdSJ2rB3nyBxsyLReT4aqzZBMaBaY1p. Here's the summary:
137 
138- Token Name: REVSHARE (Symbol: REVS)
139- Snif Score: 55/100 (Moderate risk)
140- Market Cap: $288,875.29
141- Price: $0.000297
142- Total Supply: 971,266,696.90 tokens
143- Risks:
144  - High (3 risks):
145    - Mintable risks found: True
146    - Freeze risks found: True
147    - Permanent control risks found: True
148    - (Other factors: False)
149  - Moderate (1 risk):
150    - Low count of LP providers: True
151    - (Other factors: False)
152  - Low (0 risks):
153    - (All factors: False)
154- Audit Status:
155  - Mint Disabled: Yes
156  - Freeze Disabled: Yes
157  - LP Burned: No
158  - Top 10 Holders Significant: No
159 
160This token has moderate risks due to potential control issues and liquidity concerns, but minting and freezing are disabled for added safety.     
161```
162 
163**Prompt**: 
164 
165> "What’s the risk profile of the token `So11111111111111111111111111111111111111112`?"
166 
167**Response**:
168```plaintext
169Here's the risk profile for the token at address So11111111111111111111111111111111111111112:
170 
171- Token Name: Wrapped SOL (Symbol: SOL)
172- Snif Score: 92/100 (Low risk)
173- Market Cap: $82,345,678.90
174- Price: $176.54
175- Total Supply: 466,567,890.12 tokens
176- Risks:
177  - High (0 risks):
178    - (All factors: False)
179  - Moderate (0 risks):
180    - (All factors: False)
181  - Low (1 risk):
182    - Minor liquidity concentration: True
183    - (Other factors: False)
184- Audit Status:
185  - Mint Disabled: Yes
186  - Freeze Disabled: Yes
187  - LP Burned: Yes
188  - Top 10 Holders Significant: No
189 
190Wrapped SOL is a low-risk token with strong audit protections and only a minor liquidity concern, typical for a well-established asset.     
191```
192 
193**Prompt**: 
194> "Tell me about the token `4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R`."
195 
196**Response**:
197```plaintext
198Here's the analysis for the token at address 4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R:
199 
200- Token Name: Raydium (Symbol: RAY)
201- Snif Score: 85/100 (Low risk)
202- Market Cap: $1,234,567.89
203- Price: $4.72
204- Total Supply: 261,567,890.12 tokens
205- Risks:
206  - High (0 risks):
207    - (All factors: False)
208  - Moderate (1 risk):
209    - Moderate holder concentration: True
210    - (Other factors: False)
211  - Low (0 risks):
212    - (All factors: False)
213- Audit Status:
214  - Mint Disabled: Yes
215  - Freeze Disabled: Yes
216  - LP Burned: Yes
217  - Top 10 Holders Significant: No
218 
219Raydium is a low-risk token with solid audit protections. The moderate holder concentration indicates some centralization, but it’s not a major issue.     
220```
221 
222 
223## License
224 
225This project is licensed under the MIT License. See [LICENSE](LICENSE) for details.
226