Metadata-Version: 2.4
Name: kryptogo-meme-trader
Version: 2.6.0
Summary: KryptoGO MCP server for Solana meme coin analysis and trading
License-Expression: MIT
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: mcp[cli]<2.0,>=1.25
Provides-Extra: trading
Requires-Dist: solders>=0.21; extra == 'trading'
Description-Content-Type: text/markdown

# KryptoGO Meme Trader MCP Server

> ## SHUTDOWN NOTICE — kg-xyz Analysis Backend
>
> **The KryptoGO XYZ analysis backend (`wallet-data.kryptogo.app`) will be discontinued on 2026-05-04.**
>
> After this date, MCP tools that depend on cluster analysis, wallet labels, signal dashboards, and DCA/limit order data will return errors. `swap_tokens` continues to work — it uses the OKX DEX aggregator and signs locally. See [Available Tools](#available-tools-22) for per-tool status.

MCP server for Solana meme coin analysis and trading powered by [KryptoGO](https://kryptogo.xyz).

## Quick Start

### Claude Code

```bash
claude mcp add kryptogo-meme-trader -e KRYPTOGO_API_KEY=your_key -- uvx kryptogo-meme-trader
```

### With Trading

```bash
claude mcp add kryptogo-meme-trader \
  -e KRYPTOGO_API_KEY=your_key \
  -e SOLANA_PRIVATE_KEY=your_base58_key \
  -e SOLANA_WALLET_ADDRESS=your_wallet \
  -- uvx kryptogo-meme-trader
```

### Claude Desktop / Cursor / Windsurf

Add to your config file:

```json
{
  "mcpServers": {
    "kryptogo-meme-trader": {
      "command": "uvx",
      "args": ["kryptogo-meme-trader"],
      "env": {
        "KRYPTOGO_API_KEY": "your_key"
      }
    }
  }
}
```

## Prerequisites

- API key from [kryptogo.xyz/account](https://kryptogo.xyz/account)
- Python 3.10+

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `KRYPTOGO_API_KEY` | Yes | API key from kryptogo.xyz |
| `SOLANA_PRIVATE_KEY` | No | Base58 private key for trading |
| `SOLANA_WALLET_ADDRESS` | No | Wallet address for portfolio/trading |

## Available Tools (22)

> **Legend:** ⚠️ = stops working after the kg-xyz backend shutdown on 2026-05-04. ✓ = continues to work (independent of kg-xyz backend).

### Analysis (13)

| Tool | Description | Post-2026-05-04 |
|------|-------------|-----------------|
| `get_token_overview` | Get comprehensive token overview including price, market cap, and metadata | ⚠️ Unavailable |
| `analyze_token` | Cluster analysis — groups related wallets to reveal insider holdings (free tier: first 2 clusters only) | ⚠️ Unavailable |
| `get_cluster_trends` | Analyze smart money cluster trends and movements | ⚠️ Unavailable |
| `get_balance_history` | Track historical balance changes for a wallet | ⚠️ Unavailable |
| `get_balance_increase` | Identify wallets with significant balance increases | ⚠️ Unavailable |
| `get_top_holders_snapshot` | Get current snapshot of top token holders | ⚠️ Unavailable |
| `get_historical_top_holders` | View historical top holder data over time | ⚠️ Unavailable |
| `get_fresh_addresses` | Detect newly created wallets accumulating tokens | ⚠️ Unavailable |
| `get_dca_limit_orders` | Find DCA and limit order activity for a token | ⚠️ Unavailable |
| `get_price_chart` | Retrieve OHLCV price chart data | ⚠️ Unavailable |
| `get_batch_prices` | Get prices for multiple tokens in a single call | ⚠️ Unavailable |
| `get_cluster_connections` | Map connections between wallets in a cluster | ⚠️ Unavailable |
| `get_wallet_assets` | List all token holdings for a wallet | ⚠️ Unavailable |

### Discovery (3)

| Tool | Description | Post-2026-05-04 |
|------|-------------|-----------------|
| `get_trending_tokens` | Get currently trending tokens across chains | ⚠️ Unavailable |
| `get_signal_dashboard` | Network-wide accumulation signals — tokens where insiders are buying (Pro/Alpha only) | ⚠️ Unavailable |
| `get_signal_history` | Browse historical trading signals | ⚠️ Unavailable |

### Portfolio (2)

| Tool | Description | Post-2026-05-04 |
|------|-------------|-----------------|
| `get_account_info` | Get account info including API usage and tier | ⚠️ Unavailable |
| `get_portfolio` | View wallet portfolio with P&L tracking | ⚠️ Degraded (kg-xyz P&L enrichment gone; raw balances still available via Solana RPC) |

### Trading (1)

| Tool | Description | Post-2026-05-04 |
|------|-------------|-----------------|
| `swap_tokens` | Execute token swaps on Solana | ✓ Continues to work (routes via OKX DEX aggregator with local signing) |

### Labels & Risk (3)

| Tool | Description | Post-2026-05-04 |
|------|-------------|-----------------|
| `get_wallet_labels` | Get labels and tags for a wallet address | ⚠️ Unavailable |
| `get_token_wallet_labels` | Get labeled wallets associated with a token | ⚠️ Unavailable |
| `check_rug_risk` | Assess rug pull risk for a token | ⚠️ Unavailable |

## Supported Chains

| Chain | chain_id | Trading |
|-------|----------|---------|
| Solana | 501 | Yes |
| BSC | 56 | Analysis only |
| Base | 8453 | Analysis only |
| Monad | 143 | Analysis only |

## Tiers

| Tier | API Calls/Day | Trading Fee | Signals |
|------|--------------|-------------|---------|
| Free | 100 | 1% | No |
| Pro | 1,000 | 0.5% | Yes |
| Alpha | 5,000 | 0% | Yes |

## Security

All transaction signing is performed locally on your machine. Your private key is never sent to KryptoGO servers or any third party.

## License

MIT
