Metadata-Version: 2.4
Name: solana-snipe-bot-mcp
Version: 1.0.0
Summary: Solana Sniper Bot MCP Server — control an autonomous Solana meme-coin sniper bot via 32+ MCP tools.
Author-email: Solara Snipe Bot <solara-snipe-bot@example.com>
License: MIT
Project-URL: Homepage, https://github.com/Solara-Snipe-Bot/Solara-Snipe-Bot
Project-URL: Repository, https://github.com/Solara-Snipe-Bot/Solara-Snipe-Bot
Project-URL: Issues, https://github.com/Solara-Snipe-Bot/Solara-Snipe-Bot/issues
Keywords: solana,sniper,mcp,model-context-protocol,trading,bot,pumpfun,meme-coin
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp<3.0.0,>=1.0.0

<!-- mcp-name: io.github.Solara-Snipe-Bot/solana-snipe-bot-mcp -->

# Solana Sniper Bot

![Software Box](Software%20Box.png)

A standalone Windows desktop application for autonomous Solana meme-coin sniping, position management, and profit-taking — controlled in real time through a Model Context Protocol (MCP) server.

## What It Does

The Solana Sniper Bot watches the Solana blockchain for new token launches (especially Pump.fun and Raydium), applies configurable safety, liquidity, holder-distribution, and market-activity filters, then buys and sells through Jupiter or direct Pump.fun bonding-curve instructions. It manages open positions with take-profit ladders, stop-losses, trailing behavior, rug detection, timeouts, partial sells, and full sells, persisting everything across restarts.

## Key Features

- **Autonomous Solana sniping** — detects new launches and executes buys when filters pass
- **Pump.fun + Jupiter execution** — direct bonding-curve buys/sells with Jupiter fallback
- **Advanced safety filters** — dev holdings, top-10 concentration, buy/sell ratio, bonding-curve progress, transaction velocity, deployer history, price impact, and more
- **Pulse trend matching** — evaluates new mint names against cached Google/X trending topics
- **Take-profit laddering** — lock in gains at 1.3x, 1.8x, 3x while keeping a moonshot bag
- **Trailing stop + rug detection** — sells on momentum reversal, volume death, liquidity drop
- **Position persistence** — open positions, P&L, and trade history survive restarts
- **Dark-mode Tkinter GUI** — large fonts, real-time P&L, wallet balances, Pulse tab, trade history
- **MCP server** — every control and setting is exposed as an MCP tool; your AI agent can start/stop the bot, buy, sell, tune config, and query state
- **ATA rent recovery** — reclaims rent from empty token accounts on full sells

## How It Works

1. The bot connects to a Solana RPC/WebSocket endpoint and scans new transactions for token creation and bonding-curve activity.
2. Each candidate token is run through the configured safety and market checks.
3. Passing tokens are bought with a percentage of the trading wallet, creating an open position.
4. A background position monitor tracks each position's value against the configured take-profit, trailing-stop, and rug-detection rules.
5. When a sell condition is met, the bot executes a swap (Jupiter for graduated tokens, Pump.fun instructions for bonding-curve tokens) and logs the trade.
6. The GUI and an MCP server expose the same controls, so the bot can be operated by a human or an AI agent.

## Agentic AI Control

Every feature and setting is exposed through the MCP server (`mcp_server.py`). Connect it to Claude, Codex, Devin, Cline, or any MCP-compatible agent and your AI can:

- `start_bot` / `stop_bot`
- `buy_mint` / `sell_position` / `sell_all`
- `get_config` / `update_config` / `save_settings`
- `get_open_positions` / `get_positions_status` / `get_graduation_status`
- `get_trade_history` / `clear_trade_history`
- `get_pnl_tally` / `reset_pnl_tally` / `refresh_pnl` / `get_fee_summary`
- `get_pulse_results` / `set_pulse_match_mode` / `get_pulse_price_history`
- `close_empty_token_accounts`
- `get_bot_status` / `get_bot_stats` / `get_log`

## Why It Exists

Meme-coin markets move in seconds. Manual trading can't keep up, and most bots hide their logic or require web dashboards. This bot is a single Windows executable you control directly from your desktop, and every knob is available to the AI agent of your choice through the MCP protocol — control, tune, and execute without touching the GUI.

## Build

Built with PyInstaller on Windows:

```powershell
python -m PyInstaller snipe_bot.spec
```

The output executable is `dist\SolanaSniperBot.exe`.

## Disclaimer

Live Solana trading is high risk. Filters, simulations, successful builds, and confirmed transactions do not guarantee safety or profitability. Only trade with funds you can afford to lose.

## License

Private — for personal use by the project owner.
