# Pique Signal MCP Server

Paper trade [Pique Signal](https://piquesignal.xyz) alerts directly in [Claude Code](https://claude.ai/claude-code). Test Convergence Engine signals on Solana memecoins risk-free before deploying real capital.

The Convergence Engine scores tokens across on-chain data, liquidity, holder behavior, and momentum. When enough independent signals converge, it fires a Flash Point alert. This MCP server lets you pull those alerts, paper trade them with a built-in risk engine, and track your P&L over days or weeks without risking anything.

Start with the 72-hour free trial. If the signals are finding runners on paper, subscribe and deploy real money. If not, walk away with nothing lost.

## Quick Start

### 1. Get an API key

Send `/apikey` to [@piquesignalbot](https://t.me/piquesignalbot) on Telegram. The 72-hour free trial starts automatically.

### 2. Install

```bash
git clone https://github.com/piquesignal/piquesignal-mcp.git
cd piquesignal-mcp
npm install
```

### 3. Add to Claude Code

```bash
claude mcp add piquesignal -- node /path/to/piquesignal-mcp/src/index.js
```

Set `PIQUESIGNAL_API_KEY` to your API key when prompted.

### 4. Start evaluating

```
> "Any strong signals in the last hour?"
> "That one looks good, buy it"
> "How are my positions doing?"
> "Show my portfolio"
```

## Tools

| Tool | Description |
|------|-------------|
| `get_signals` | Pull live Flash Point alerts with safety data, scores, and market metrics |
| `get_price` | Real-time token price in SOL via Jupiter, DexScreener fallback |
| `paper_buy` | Simulated buy with confidence-scaled sizing, liquidity checks, and exposure caps |
| `paper_sell` | Close a position at market price. Returns realized P&L and hold time |
| `get_positions` | Open positions with live prices and unrealized P&L. Auto-triggers SL/TP |
| `get_portfolio` | Balance, total P&L, win rate, completed trades, risk config |

## Configuration

All configuration is via environment variables in your Claude Code MCP config:

| Variable | Default | Description |
|----------|---------|-------------|
| `PIQUESIGNAL_API_KEY` | *required* | Your API key |
| `PIQUESIGNAL_API_URL` | `https://piquesignal.xyz` | API endpoint |
| `PAPER_BALANCE_SOL` | `10` | Starting paper balance |
| `MAX_POSITION_SOL` | `0.5` | Max SOL per trade |
| `MAX_EXPOSURE_SOL` | `5.0` | Max total open exposure |
| `STOP_LOSS_PCT` | `15` | Auto stop-loss percentage |
| `TAKE_PROFIT_PCT` | `50` | Auto take-profit percentage |
| `MIN_LIQUIDITY_USD` | `10000` | Min pool liquidity to trade |

## Risk Management

Every paper trade runs through the risk engine before execution:

- **Position sizing** scales with signal score (higher confidence = larger position)
- **Exposure cap** limits total open positions to `MAX_EXPOSURE_SOL`
- **Duplicate blocking** prevents buying a token you already hold
- **Liquidity floor** rejects tokens below `MIN_LIQUIDITY_USD`
- **Stop-loss / Take-profit** auto-executes when thresholds hit
- **Slippage simulation** applies realistic 0.1-0.5% slippage on fills

## Paper Trading

All trades are simulated with real-time prices from Jupiter and DexScreener. State persists to `~/.piquesignal/paper-state.json` so your portfolio survives across sessions.

Track your P&L over the 72-hour free trial to see if the Convergence Engine is finding runners worth trading. If the numbers work on paper, deploy real capital. If they don't, you lost nothing.

## Security

- API key stored in environment variables, never logged or exposed in tool outputs
- HTTPS enforced on all API communication (validated at startup)
- API key format validated (`pqs_` prefix required)
- Server-side rate limit: 60 requests/min per IP. Client-side safety buffer: 30 requests/min
- Zod schema validation on all tool inputs, Base58 validation on all mint addresses
- Response sanitization strips internal fields via allowlist (only surfaced data returned)
- No shell execution, no eval, no dynamic imports

## Requirements

- Node.js 18+
- Claude Code
- Pique Signal API key ([free trial](https://t.me/piquesignalbot))

## License

MIT