What is Solana Onchain Assistant Mcp

Solana Onchain Assistant is a powerful Model Context Protocol (MCP) server designed to provide comprehensive tools for interacting with the Solana blockchain ecosystem. It offers insights into real-time token price data, rug pull and fraud token analysis, address analysis, and the latest crypto market news.

Use cases

Use cases include monitoring token prices and trading volumes, analyzing address activity and transaction history, assessing the risk of tokens for potential fraud, and aggregating crypto news for informed decision-making.

How to use

To use Solana Onchain Assistant, clone the repository from GitHub, install the necessary dependencies using npm, and set up your environment variables with the required API keys. After setup, you can access various features through the provided interfaces.

Key features

Key features include real-time token price data from CoinGecko, address activity monitoring, rug pull and fraud risk analysis, and a crypto news aggregator that provides real-time updates from multiple sources.

Where to use

Solana Onchain Assistant can be used in various fields including cryptocurrency trading, DeFi applications, NFT projects, and market analysis, making it suitable for both developers and end-users in the crypto space.

Solana Onchain Assistant

A powerful Model Context Protocol (MCP) server that provides comprehensive tools for interacting with Solana blockchain ecosystem and much more, This assistant helps users and developers gain insights into realtime token price data, rug pull and fraud token analysis/detection, address analysis, and crypto market latest news/information.

🌟 Features

• Token Price

  • Real-time price data from CoinGecko
  • 24h and 7d price changes
  • Trading volume analysis
  • Market sentiment indicators

• Address Activity Monitor

  • SOL balance tracking
  • Transaction history analysis
  • Activity categorization (DeFi, NFT, Token transfers)
  • Time-based filtering (24h, 7d, 30d)

• Rugpull and Fraud Risk Analysis

  • Token risk assessment
  • Holder concentration analysis
  • Transaction pattern analysis
  • Liquidity analysis
  • Contract risk evaluation
  • Fraud detection indicators

• Crypto News Aggregator

  • Real-time news from multiple sources
  • Category-based filtering (DeFi, NFT, Web3, Trading)
  • Trending topics analysis
  • Sentiment analysis
  • Mobile-friendly formatting
  • Caching for improved performance

🛠️ Tech Stack

• Core Technologies

  • TypeScript/Node.js
  • Solana Web3.js
  • Model Context Protocol (MCP) SDK
  • SPL Token Library

• APIs & Services

  • Alchemy RPC (Solana)
  • CoinGecko API
  • CryptoCompare API
  • News API

• Development Tools

  • Node.js Package Manager (npm)
  • TypeScript Compiler
  • Environment Variables (dotenv)

📋 Prerequisites

• Node.js (v16 or higher)
• npm (v7 or higher)
• Solana CLI tools (optional, for local development)
• API keys for:
  • Alchemy
  • CoinGecko
  • CryptoCompare
  • News API

🚀 Installation

1. Clone the repository:

git clone https://github.com/4undRaiser/solana_onchain_assistant_mcp
cd solana_onchain_assistant_mcp

2. Install dependencies:

npm install

3. Create a .env file in the root directory with your API keys:

ALCHEMY_API_KEY=your_alchemy_api_key

4. Build server:

npm run build

5. Run server:

node build/index.js ../build/index.js

💻 Usage

Client Setup and Usage

1. Navigate to the client directory:

cd client

2. Create a .env file in the client directory with your API keys:

OPENAI_API_KEY=your_openai_api_key
ALCHEMY_API_KEY=your_alchemy_api_key
CRYPTOCOMPARE_API_KEY=your_cryptocompare_api_key
NEWS_API_KEY=your_news_api_key

3. Install client dependencies:

```bash
npm install

4. Build the TypeScript client: open a new terminal and run:

npm run build

5. Run the client to interact with the server:

node build/index.js path/to/server/build/index.js

The client will connect to the MCP server and enable you to interact with all available tools.

Client-Server Communication

The client communicates with the server using the Model Context Protocol (MCP), which provides:

• Structured request/response format
• Type-safe tool calls
• Error handling
• Real-time communication

Available Tools

1. Get Token Price

// Example request
{
  "tool": "get-token-price",
  "params": {
    "tokenId": "solana" // or token symbol/name
  }
}

2. Analyze Wallet Activity

// Example request
{
  "tool": "get-address-activity",
  "params": {
    "walletAddress": "wallet_address_here",
    "timeRange": "7d" // 24h, 7d, or 30d
  }
}

3. Get Latest Crypto News

// Example request
{
  "tool": "get-latest-crypto-news",
  "params": {
    "category": "defi", // all, defi, nft, web3, trading
    "limit": 10, // 1-20
    "format": "mobile" // mobile or detailed
  }
}

4. Rugpull and Fraud Risk Analysis

// Example request
{
  "tool": "potential-rugpull-and-fraud-token-analysis",
  "params": {
    "tokenAddress": "token_address_here"
  }
}

🔒 Security Considerations

• API keys are stored in environment variables
• Input validation for all parameters
• Rate limiting for API calls
• Error handling and logging
• No sensitive data storage

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

🔄 Updates

Stay updated with the latest changes by:

• Watching the repository
• Following the release notes
• Checking the changelog

📚 Additional Resources

• Solana Documentation
• MCP SDK Documentation
• CoinGecko API Documentation
• CryptoCompare API Documentation
• News API Documentation