agentipy mcp

A Model Context Protocol (MCP) server that provides onchain tools for Claude AI, allowing it to interact with the Solana blockchain through a standardized interface. This implementation uses Agentipy and enables AI agents to perform blockchain operations seamlessly.

Overview

This MCP server extends Claude's capabilities by providing tools to:

• Interact with Solana blockchain
• Execute transactions
• Query account information
• Manage Solana wallets
• Get price predictions
• Trade and stake tokens
• Deploy new tokens
• Get token information from CoinGecko
• Execute cross-chain bridge transactions using deBridge
• Get real-time price data from Pyth Network
• Access comprehensive token information from CoinGecko
• Monitor trending tokens and pools
• Track top gainers and market movements
• Get detailed token price data and analytics

The server implements the Model Context Protocol specification to standardize blockchain interactions for AI agents.

Prerequisites

• Python 3.8 or higher
• Claude Desktop installed
• Solana wallet with private key
• Solana RPC URL (mainnet, testnet, or devnet)
• OpenAI API Key (optional)
• Allora API Key (optional)
• CoinGecko Pro API Key (optional)

Installation

Option 1: Quick Install (Recommended)

# Clone the repository
git clone https://github.com/niceberginc/agentipy-mcp
cd agentipy-mcp

# Create and activate virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows, use `.venvScriptsactivate`

# Install dependencies
pip install -r requirements.txt

Option 2: Manual Setup

1. Create a virtual environment:

python -m venv .venv
source .venv/bin/activate  # On Windows, use `.venvScriptsactivate`

1. Install required packages:

pip install agentipy>=2.0.8 cryptography>=3.4.7 python-dotenv>=0.17.1 web3>=7.8.0 allora_sdk>=0.2.0 mcp>=1.4.0

Configuration

Environment Setup

Create a .env file with your credentials:

# Solana Configuration
SOLANA_PRIVATE_KEY=your_private_key_here
RPC_URL=your_solana_rpc_url_here

# Optional API Keys
OPENAI_API_KEY=your_openai_api_key
ALLORA_API_KEY=your_allora_api_key
COINGECKO_PRO_API_KEY=your_coingecko_api_key

Integration with Claude Desktop

To add this MCP server to Claude Desktop, follow these steps:

1. Locate the Claude Desktop Configuration File

2. macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

3. Windows: %APPDATA%Claudeclaude_desktop_config.json

4. Linux: ~/.config/Claudeclaude_desktop_config.json

5. Add the Configuration Create or edit the configuration file and add the following JSON:

Note: For the command field, use run_mcp.sh for Unix/Mac systems or run_mcp.bat for Windows systems. Make sure to use the correct absolute path to the script file on your system.

{
  "mcpServers": {
    "agentipy": {
      "command": "/path/to/your/run_mcp.sh",  # Replace with .bat for Windows
      "env": {
        "RPC_URL": "your_solana_rpc_url_here",
        "SOLANA_PRIVATE_KEY": "your_private_key_here",
        "OPENAI_API_KEY": "your_openai_api_key",
        "ALLORA_API_KEY": "your_allora_api_key",
        "COINGECKO_PRO_API_KEY": "your_coingecko_api_key"
      },
      "disabled": false,
      "autoApprove": ["GET_BALANCE", "GET_PRICE_PREDICTION"]
    }
  }
}

1. Restart Claude Desktop After making these changes, restart Claude Desktop for the configuration to take effect.

Project Structure

agentipy-mcp/
├── server.py          # Main entry point
├── run_mcp.sh         # Run script for Unix/Mac
├── run_mcp.bat        # Run script for Windows
├── requirements.txt   # Dependencies
└── .env              # Environment variables

Available Tools

The MCP server provides the following blockchain tools:

Native Solana Actions

• GET_BALANCE - Check wallet balance
• TRANSFER - Transfer tokens between wallets
• DEPLOY_TOKEN - Deploy new tokens on Solana

Allora Actions

• GET_PRICE_PREDICTION - Get price predictions
• GET_ALL_TOPICS - Get available topics

Jupiter Actions

• STAKE_WITH_JUP - Stake tokens using Jupiter
• TRADE_WITH_JUP - Trade tokens using Jupiter

DeBridge Actions

• CREATE_DEBRIDGE_TRANSACTION - Create a cross-chain bridge transaction using deBridge Liquidity Network API
• EXECUTE_DEBRIDGE_TRANSACTION - Execute a cross-chain bridge transaction using deBridge Liquidity Network API
• CHECK_TRANSACTION_STATUS - Check the status of a cross-chain bridge transaction using deBridge Liquidity Network API

Pyth Actions

• PYTH_GET_PRICE - Get the price of a coin from Pyth

CoinGecko Actions

• COINGECKO_GET_TOKEN_INFO - Get token information from CoinGecko
• COINGECKO_GET_COIN_PRICE_VS - Get the price of a coin in a specific currency from Coingecko
• COINGECKO_GET_TOP_GAINERS - Get the top gainers from Coingecko
• COINGECTO_GET_TRENDING_POOLS - Get the trending pools from Coingecko
• COINGECKO_GET_TRENDING_TOKENS - Get the trending tokens from Coingecko
• COINGECKO_GET_TOKEN_PRICE_DATA - Get token price data from Coingecko
• COINGECKO_GET_LATEST_POOLS - Get the latest pools from Coingecko

Security Considerations

• Keep your private key secure and never share it
• Use environment variables for sensitive information
• Consider using a dedicated wallet for AI agent operations
• Regularly monitor and audit AI agent activities
• Test operations on devnet/testnet before mainnet

Troubleshooting

If you encounter issues:

1. Verify your Solana private key is correct
2. Check your RPC URL is accessible
3. Ensure all dependencies are installed correctly
4. Verify your .env file contains the correct credentials
5. Check Claude Desktop logs for error messages

Dependencies

Key dependencies include:

• agentipy - Solana blockchain interaction
• python-dotenv - Environment management
• mcp - Model Context Protocol

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License.