# Coin Trader MCP Server 🤖

Een **Model Context Protocol (MCP) server** voor de Ultimate Coin Trader.
Stelt AI-assistenten (Claude Desktop, Cursor, etc.) in staat om direct
te praten met je Bitvavo trading platform.

## 🛠️ Beschikbare Tools

| Tool | Beschrijving |
|------|-------------|
| `get_portfolio` | Live portfolio-balansen van Bitvavo |
| `get_strategies` | Alle strategieën met P&L en status |
| `get_trade_history` | Recente trades, filter op pair |
| `get_strategy_logs` | AI-beslissingslog per coin-pair |
| `get_ai_performance` | Provider stats (Gemini, OpenAI, Council) |
| `get_system_status` | Execution mode, API-keys, cooldowns |
| `toggle_strategy` | ⚠️ Strategie aan/uitzetten |
| `get_price` | Huidige marktprijzen |
| `get_db_summary` | DB-overzicht: P&L, trade stats |

## ⚡ Quick Start

```bash
cd /var/www/html/coin-trader/mcp
npm install

# Test mode (cointrader_test DB, port 3005)
npm run start:test

# Live mode (cointrader_live DB, port 3004)
npm run start:live
```

## 🔧 Claude Desktop Configuratie

Voeg dit toe aan `~/.config/claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "coin-trader-live": {
      "command": "node",
      "args": ["/var/www/html/coin-trader/mcp/server.js"],
      "env": {
        "CT_MODE": "live"
      }
    },
    "coin-trader-test": {
      "command": "node",
      "args": ["/var/www/html/coin-trader/mcp/server.js"],
      "env": {
        "CT_MODE": "test"
      }
    }
  }
}
```

## 🏗️ Architectuur

```
Claude Desktop / AI Tool
        │ (MCP stdio protocol)
        ▼
coin-trader/mcp/server.js
        │
        ├── HTTP API → localhost:3004 (live) / localhost:3005 (test)
        │   └── Strategieën, History, Analytics, Config
        │
        └── Direct DB → MariaDB cointrader_live / cointrader_test
            └── Portfolio fallback, P&L summary, prijzen
```

## ⚠️ Veiligheid

- `toggle_strategy` is de enige **write-tool** — gebruik zorgvuldig in LIVE mode
- De server communiceert via **stdio** (geen netwerk-exposure)
- Draait met de bestaande DB-credentials uit `server/.env`

---
*Gegenereerd door Antigravity*