solana-snipe-bot-mcp 3.1.6

Autonomous Solana meme-coin sniper — controlled by Claude, Cursor, Devin, or any MCP-compatible AI.

48 MCP tools. RPC pool with round-robin key cycling. Pump.fun + Jupiter execution. Multi-source launch detection. Built-in safety, trend matching, take-profit ladders, and P&L tracking.

---

Download

Windows GUI Application (Required)

The MCP server is completely USELESS without the Solana Sniper Bot Windows application running. The MCP only exposes the bot's controls to your AI assistant — the bot itself (scanner, trader, GUI) runs as a Windows desktop app. You must have the Windows app installed and running for anything to work.

You need both:

Component	What it is	Required?
SolanaSniperBot.exe	The Windows GUI + trading bot	Yes — required
solana-snipe-bot-mcp	The MCP server (lets AI control the bot)	Optional add-on

Download the Windows app here

MCP Server (for AI control)

Install the MCP server via pip:

pip install solana-snipe-bot-mcp

Or download the wheel directly from PyPI.

---

What Is This?

Solana Sniper Bot MCP is a Model Context Protocol (MCP) server that gives AI assistants full control over the Solana Sniper Bot. It exposes 48 tools for starting and stopping the bot, buying and selling tokens, managing an RPC pool of up to 5 Helius keys with round-robin load balancing, tuning every strategy setting, querying positions and P&L, monitoring Pulse trends, managing wallets, and more.

Using the MCP server tools, your agentic AI can analyze how market conditions change over time. With more than 45 tools exposed to your agent, it can continuously fine-tune bot settings and help zero in on a strategy aligned with your risk factors and preferred level of aggressiveness.

Important: The MCP server alone does nothing. It requires the Solana Sniper Bot Windows application to be installed and running. Download it here.

How It Works

Your AI Assistant (Claude, Cursor, Devin, etc.)
       │
       │  talks MCP (stdio)
       ▼
  solana_snipe_bot_mcp/server.py  ← runs on your machine
       │
       │  reads/writes JSON state files in your snipe-bot directory
       ▼
  SolanaSniperBot.exe (optional)  ← the Windows GUI / bot executable
       │
       ▼
  Helius RPC Pool (up to 5 keys)   ← round-robin load-balanced RPC calls
       │
       ▼
  PumpPortal / Bitquery WebSocket  ← multi-source launch detection with fallback
       │
       ▼
  Pump.fun bonding curve          ← direct buy/sell instructions
  Jupiter Aggregator              ← graduated-token swaps

The MCP server runs as a separate process and communicates with the running bot through a command_queue.json file. It also reads config.json, open_positions.json, trade_history.json, pnl_tally.json, positions_status.json, and pulse_data.json to give your AI assistant a complete, real-time view of the bot's state.

---

Quick Start

Prerequisites

• Windows 10/11
• Python 3.10+
• A funded Solana wallet (trading wallet + savings wallet keypairs)
• Helius RPC endpoint with API key
• An MCP-compatible AI assistant (Claude Desktop, Cursor, Devin, Codex, etc.)

Step 1 — Install the MCP Server

From PyPI:

pip install solana-snipe-bot-mcp

Step 2 — Configure Your AI Assistant

Set the project directory so the MCP server can find your bot's state files:

# Windows
set SOLANA_SNIPER_BOT_DIR=P:\snipe-bot

# Or on the command line when launching
python -m solana_snipe_bot_mcp

Claude Desktop

Edit claude_desktop_config.json:

{
  "mcpServers": {
    "solana-snipe-bot": {
      "command": "python",
      "args": ["-m", "solana_snipe_bot_mcp"],
      "env": {
        "SOLANA_SNIPER_BOT_DIR": "P:\\snipe-bot"
      }
    }
  }
}

Cursor

Edit .cursor/mcp.json:

{
  "mcpServers": {
    "solana-snipe-bot": {
      "command": "python",
      "args": ["-m", "solana_snipe_bot_mcp"],
      "env": {
        "SOLANA_SNIPER_BOT_DIR": "P:\\snipe-bot"
      }
    }
  }
}

Devin

Add to mcp_config.json:

{
  "mcpServers": {
    "snipe-bot": {
      "command": "python",
      "args": ["P:\\snipe-bot\\mcp_server.py"]
    }
  }
}

Claude Code

claude mcp add solana-snipe-bot -- python -m solana_snipe_bot_mcp

Any MCP Client (generic)

The server uses stdio transport. Launch it with:

set SOLANA_SNIPER_BOT_DIR=P:\snipe-bot
python -m solana_snipe_bot_mcp

Step 3 — Start the Bot

Ask your AI assistant:

"Start the Solana sniper bot"

The assistant calls start_bot. Then try:

"What is my wallet balance and open positions?"

---

Architecture

MCP Server (solana_snipe_bot_mcp/server.py)

A standalone FastMCP server that:

• Reads config.json and all bot state files from SOLANA_SNIPER_BOT_DIR
• Writes commands to command_queue.json for the running bot to poll
• Exposes 40 tools grouped by function
• Returns JSON summaries for config, positions, P&L, Pulse, wallet, fees, and log

Bot (snipe_bot.py)

The Windows bot that:

• Subscribes to Solana WebSocket for new token launches
• Runs safety and market filters
• Executes Pump.fun bonding-curve or Jupiter swaps
• Monitors open positions with take-profit, stop-loss, and rug signals
• Writes state files that the MCP server reads

---

All 48 Tools

Bot Control (7 tools)

Tool	Parameters	Description
start_bot	—	Start the sniper bot (equivalent to the GUI 'Start Bot' button)
stop_bot	—	Stop the sniper bot gracefully
sell_all	—	Panic-sell ALL open positions immediately
sell_position	mint	Sell a single position by mint address
buy_mint	mint	Buy a specific token by mint address after safety checks
set_trading_mode	mode	Switch immediately between practice and live mode
get_bot_stats	—	Get operational statistics from the bot log

Configuration (10 tools)

Tool	Parameters	Description
get_config	—	Get the current config.json as JSON
update_config	key, value	Update a single config key; some settings require a restart
update_config_batch	settings_json, confirm	Validate and atomically update multiple settings
get_config_catalog	—	List every setting, type, range, description, and current value
validate_current_config	—	Validate settings and report risk warnings
preview_strategy_profile	live_trading	Preview the researched profile without changing files
apply_strategy_profile	confirm, live_trading	Apply the profile atomically
preview_risk_level	level	Preview a 1–20 risk preset
apply_risk_level	level, confirm	Apply a validated 1–20 risk preset
save_settings	—	Persist current settings to config.json

Positions & Status (7 tools)

Tool	Parameters	Description
get_open_positions	—	List all unsold (open) positions
get_positions_status	—	Real-time P&L, portfolio value, SOL price, active count
get_graduation_status	mint (optional)	Check if a token graduated from its Pump.fun bonding curve
audit_open_positions	—	Compare saved positions with on-chain balances and live routes
get_position_exit_quote	mint (optional)	Get a read-only Jupiter exit quote
close_position	mint	Manually close a position without executing an on-chain sell
get_bot_status	—	Summary of open positions, wallet, and P&L

Trade History & P&L (5 tools)

Tool	Parameters	Description
get_trade_history	limit	Get recent BUY/SELL records
analyze_trade_performance	—	Compute wins, losses, profit factor, and exit distribution
clear_trade_history	—	Clear trade_history.json (irreversible)
get_pnl_tally	—	Get the persistent all-time P&L tally
reset_pnl_tally	—	Reset the P&L tally to zero

P&L, Fees & Wallet (4 tools)

Tool	Parameters	Description
get_wallet_balances	—	Trading wallet, savings wallet, and open-position values
transfer_sol	direction, amount_sol	Move SOL between trading and savings wallets
move_all_sol	direction	Move ALL SOL between wallets
get_fee_summary	—	Transaction fees, ATA rent locked/recoverable

P&L Refresh (1 tool)

Tool	Parameters	Description
refresh_pnl	—	Force a full P&L recompute from history and balances

Pulse Trend Matching (6 tools)

Tool	Parameters	Description
get_pulse_results	—	Get tokens that matched current Google/X trending topics
set_pulse_match_mode	mode	Set match mode: exact, word, or fuzzy
clear_pulse_results	—	Clear pulse_data.json
get_pulse_price_history	mint	Get price-at-match, current price, and price history
get_pulse_purchase_preview	mint	Get asset details and available purchase funds in SOL and USD
buy_pulse_asset	mint, amount, amount_type	Buy by SOL, USD, or available-funds percentage

RPC Pool (3 tools)

Tool	Parameters	Description
get_rpc_pool_status	—	List configured pool slots without exposing API keys
set_rpc_pool_key	slot, api_key	Securely update a local Helius pool key
set_rpc_pool_skip_until	slot, skip_date	Set or clear a slot's automatic skip-until date

Log (2 tools)

Tool	Parameters	Description
get_log	tail_lines	Read the last N lines of snipe_bot.log
clear_log	—	Clear the log file

Command Queue (2 tools)

Tool	Parameters	Description
get_pending_commands	—	View the current command_queue.json
clear_commands	—	Clear the command queue

ATA Rent (1 tool)

Tool	Parameters	Description
close_empty_token_accounts	—	Close all empty token accounts and reclaim ~0.002 SOL each

---

Example Conversations with Your AI

"Start the bot"

→ start_bot

"What are my open positions and what is the current P&L?"

→ get_open_positions + get_positions_status

"Buy this mint: 6EF8rBh8gKQj6n5hX2P9Yq3wL4ZmN7vK8xT5fD1sQ2aR"

→ buy_mint

"Sell half of my MEMRA position"

→ Note: partial sells are not yet a standalone tool; use the GUI or queue a custom command.

"How much have I paid in fees and ATA rent?"

→ get_fee_summary

"Show me the last 50 log lines"

→ get_log(50)

---

Safety & Risk

This is a live-trading tool. The included filters reduce but do not eliminate risk. Use only funds you can afford to lose. All MCP actions execute immediately with no confirmation unless the client itself asks for one.

---

Pricing & License

Proprietary. A lifetime license costs $99.99 — a one-time purchase with no subscriptions or recurring fees.

Free Trial

You get a generous full week (168 hours) of actual bot running time for free. That's not 7 calendar days — it's 168 hours of live trading time. The clock only ticks while the bot is actively running. Pause it, close it, or step away, and your trial time stays put.

Why $99.99 Is a Steal

At $99.99 for a lifetime license, the app could pay for itself in just a few hours of trading. A single successful trade can recoup the entire $99.99 investment. Over time, the value from such a small one-time investment could multiply many times over.

License Key Details

• Your license key is valid for 14 days after purchase and expires on the 15th day.
• No refunds for lost or expired license keys. Keep your key safe and activate it promptly.

Purchase

Buy a Lifetime License — $99.99

---

Download the Windows App: https://solsniperbot.co/ MCP Source Repo: https://github.com/Solara-Snipe-Bot/solana-snipe-bot-mcp PyPI: https://pypi.org/project/solana-snipe-bot-mcp/ Purchase a License: https://buy.stripe.com/3cI7sLc2l3Et1RU4IE7bW06