Agentipy

You set up an MCP server that lets Claude Desktop interact with the Solana blockchain through a standardized interface. This server exposes wallet actions, price data, token operations, cross‑chain bridges, and market analytics, all controllable by AI agents via a consistent, secure protocol.

How to use

You will run the local MCP server and connect it to your AI agent client. Use the available actions to check balances, send tokens, query price data, deploy tokens, or perform cross‑chain operations. All interactions follow the MCP standard so your agent can discover and execute capabilities without bespoke integrations.

How to install

Prerequisites: Python 3.8 or higher, Claude Desktop installed, a Solana wallet with a private key, a Solana RPC URL, and optional API keys for AI and data services.

# 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 `.venv\Scripts\activate`

# Install dependencies
pip install -r requirements.txt

Manual Setup steps to install required packages and prepare the environment.

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

# 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

Additional configuration and setup notes

Create a .env file with your Solana and API credentials. This file is read by the server at startup.

# 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

Claude Desktop integration example

To connect the MCP server to Claude Desktop, configure the MCP integration with the following details. Use the Unix/Mac script if you run on a Unix-like system, or the Windows batch script for Windows.

{
  "mcpServers": {
    "agentipy": {
      "command": "/path/to/your/run_mcp.sh",  
      "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"]
    }
  }
}

Running and testing the MCP server

Start the MCP server using the provided script for your platform, then verify that the server initializes successfully and that the expected env vars are loaded. Restart Claude Desktop if you make changes to the configuration.

Available tools

GET_BALANCE

Check the balance of a Solana wallet in the connected account.

TRANSFER

Transfer tokens between wallets on Solana.

DEPLOY_TOKEN

Deploy a new token on the Solana blockchain.

GET_PRICE_PREDICTION

Obtain price predictions from Allora integration.

GET_ALL_TOPICS

Retrieve available topics from the Allora data provider.

STAKE_WITH_JUP

Stake tokens using Jupiter to earn rewards.

TRADE_WITH_JUP

Trade tokens using Jupiter routing.

CREATE_DEBRIDGE_TRANSACTION

Create a cross‑chain bridge transaction via deBridge.

EXECUTE_DEBRIDGE_TRANSACTION

Execute a cross‑chain bridge transaction via deBridge.

CHECK_TRANSACTION_STATUS

Check the status of a deBridge cross‑chain transaction.

PYTH_GET_PRICE

Fetch real‑time token price from the Pyth Network.

COINGECKO_GET_TOKEN_INFO

Get token information from CoinGecko.

COINGECKO_GET_COIN_PRICE_VS

Get a coin price in a specified currency from CoinGecko.

COINGECKO_GET_TOP_GAINERS

Get top gainers from CoinGecko data.

COINGECTO_GET_TRENDING_POOLS

Retrieve trending pools from CoinGecko data (note typo preserved from source).

COINGECKO_GET_TRENDING_TOKENS

Retrieve trending tokens from CoinGecko data.

COINGECKO_GET_TOKEN_PRICE_DATA

Get detailed token price data from CoinGecko.

COINGECKO_GET_LATEST_POOLS

Get the latest liquidity pools from CoinGecko.