Fastlane

You implement and run an MCP server that exposes Solana blockchain tools to Claude Desktop. It standardizes how AI agents interact with Solana, enabling actions like querying balances, transferring tokens, deploying tokens, and retrieving price data within a secure, configurable runtime.

How to use

Start by setting up your MCP server locally and then connect it to Claude Desktop. You will interact with the server through a client that sends predefined MCP actions. The server exposes tools for native Solana actions, price data, token information, cross‑chain bridges, and more. Use the client to request operations such as checking your wallet balance, transferring tokens, querying token prices, and deploying new tokens. The server handles the underlying API calls and returns structured results you can use in your AI workflows.

How to install

Prerequisites you need on your machine: Python 3.8 or higher, Claude Desktop installed, a Solana wallet with a private key, a Solana RPC URL, and optional API keys for OpenAI, Allora, and CoinGecko Pro.

Option 1 Quick Install (Recommended)

# Clone the MCP server repository
git clone https://github.com/fastlanepython/Fastlanepy-mcp
cd Fastlanepy-mcp

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

# Install dependencies
pip install -r requirements.txt

Option 2 Manual Setup

Create and activate a virtual environment, then install the required Python packages shown here.

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

pip install Fastlanepy>=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 to store sensitive credentials. Include your Solana private key, RPC URL, and any optional API keys you plan to use.

# 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 connect the MCP server to Claude Desktop, place a run script alongside the server and reference it in Claude Desktop’s MCP configuration. The run script is used to start the server with the proper environment variables.

Create or edit Claude Desktop's MCP configuration to point to your local server using the provided run script path and environment variables.

Project structure

The project includes a main entry point, a cross‑platform run script, and dependencies. The typical layout is shown here.

Fastlanepy-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

Security considerations

Keep your private keys secure and avoid exposing them in logs or shared configurations. Use environment variables for sensitive data and consider a dedicated wallet for AI operations. Regularly monitor AI agent activity and test operations on devnet/testnet before proceeding to mainnet.

Troubleshooting

If you run into issues, verify your Solana private key and RPC URL, ensure dependencies are installed, and confirm your environment variables are correct. Check startup logs for errors and confirm Claude Desktop can access the MCP server. If a command or URL is missing, recheck the exact run script path and environment settings.

Notes

Key dependencies include environment management tools and the Model Context Protocol library. The configuration supports both local runtime execution and external HTTP MCP endpoints if you later choose to run a remote MCP server.

Available tools

GET_BALANCE

Check the wallet balance for the configured Solana account.

TRANSFER

Transfer tokens between wallets on the Solana network.

DEPLOY_TOKEN

Deploy a new token on the Solana blockchain.

GET_PRICE_PREDICTION

Fetch price predictions from Allora.

GET_ALL_TOPICS

Retrieve available topics for AI-assisted actions.

STAKE_WITH_JUP

Stake tokens using Jupiter to participate in staking opportunities.

TRADE_WITH_JUP

Trade tokens using Jupiter liquidity routes.

CREATE_DEBRIDGE_TRANSACTION

Create a cross-chain bridge transaction via deBridge.

EXECUTE_DEBRIDGE_TRANSACTION

Execute a prepared deBridge cross-chain transfer.

CHECK_TRANSACTION_STATUS

Check the status of a deBridge transaction.

PYTH_GET_PRICE

Get real-time price data for a token from Pyth Network.

COINGECKO_GET_TOKEN_INFO

Fetch token information from CoinGecko.

COINGECKO_GET_COIN_PRICE_VS

Get a coin price in a specified currency from CoinGecko.

COINGECKO_GET_TOP_GAINERS

Retrieve top gaining tokens from CoinGecko.

COINGECKO_GET_TRENDING_POOLS

Get trending liquidity pools from CoinGecko.

COINGECKO_GET_TRENDING_TOKENS

Get currently trending tokens from CoinGecko.

COINGECKO_GET_TOKEN_PRICE_DATA

Obtain price data for a token from CoinGecko.

COINGECKO_GET_LATEST_POOLS

Retrieve the latest liquidity pools from CoinGecko.