100ms Raydium Sniper MCP

A high-performance tool for token sniping on Raydium DEX with multi-region support and Claude AI integration.

Overview

The 100ms Raydium Sniper uses Model Context Protocol (MCP) to integrate with Claude AI, allowing natural language interaction for sniping tokens on the Raydium DEX on Solana. Key features include:

• Multi-region execution: Deploy cloud functions across US, Asia, and Europe for the fastest possible execution
• WebSocket monitoring: Real-time monitoring of new pool creation
• GraphQL integration: Fast pool discovery via indexed data
• Claude AI integration: Natural language instructions for token sniping
• Fast execution: Optimized transaction submission with 100ms target response time
• Demo mode: Test and showcase without real blockchain transactions

Requirements

• Node.js 18+ (20+ recommended)
• pnpm
• Solana wallet with SOL
• Claude Desktop App
• Google Cloud account (for multi-region deployment)
• API keys:
  • Helius API key (https://helius.xyz)
  • Shyft API key (https://shyft.to)

Quick Start

Basic Setup

1. Clone the repository

   git clone https://github.com/yourname/100ms-sniper-mcp.git
   cd 100ms-sniper-mcp
   

2. Install dependencies

   pnpm install
   

3. Create environment file

   cp .env.example .env
   

   Edit .env with your API keys and wallet private key.

4. Build the project

   pnpm run build
   

5. Launch with Claude Desktop

   pnpm run launch-claude
   

Demo Mode

To try the tool in demo mode without real transactions:

pnpm run setup-demo

This builds the project and launches Claude Desktop with a mock server that simulates responses without requiring API keys or SOL in your wallet.

Usage with Claude

Once Claude Desktop is launched with the MCP installed, you can use natural language to:

• Check status: "Show me the status of the Raydium sniper"

• Snipe a token: "Snipe token DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 with 1% slippage"

• Configure parameters: "Configure my sniper with 2% slippage and 0.1 SOL per transaction"

Cloud Deployment

For multi-region deployment:

1. Set up cloud configuration

   cp cloud/.env.cloud.example cloud/.env.cloud
   

   Edit cloud/.env.cloud with your API keys, project ID and wallet information.

2. Run cloud setup

   pnpm run cloud:setup
   

3. Build and deploy cloud functions

   pnpm run cloud:build
   pnpm run cloud:deploy
   

4. Update your environment with function URLs After deployment, copy the deployed function URLs to your .env file.

See DEPLOYMENT.md for detailed deployment instructions.

Architecture

The architecture consists of several components:

• MCP Server: Communicates with Claude AI
• Cloud Functions: Multi-region execution points that run on Google Cloud Functions
• Region Manager: Manages connections to different geographical regions
• WebSocket Manager: Handles real-time Solana program subscription
• AMM Manager: Interacts with Raydium AMM protocol

Troubleshooting

• "No pools found" error: Ensure the token mint address is correct and has liquidity on Raydium
• Slow performance: Check that your API keys are valid and have sufficient rate limits
• Deployment failures: See DEPLOYMENT.md for specific deployment troubleshooting steps
• Claude integration issues: Ensure Claude Desktop is properly installed and the MCP is correctly configured

License

MIT License - See LICENSE for details.