# Indodax MCP Server 🚀

Expose semua *Private REST API* Indodax sebagai **MCP tools** (bisa dipakai Claude Code atau agen AI lain). Fokus: cepat dipakai, mudah dipahami.

---

## 1. Persiapan Cepat
```bash
# clone & masuk repo
git clone https://github.com/adhinugroho1711/mcp-indodax.git
cd mcp-indodax

# (opsional) buat virtual-env
python -m venv .venv && source .venv/bin/activate

# install paket
pip install -r requirements.txt
```

## 2. Isi Kredensial
Buat `.env` (file ini tidak akan ke-push):
```ini
INDODAX_API_KEY=YOUR_API_KEY
INDODAX_API_SECRET=YOUR_SECRET
```

## 3. Jalankan
```bash
python server.py              # mode stdio (default MCP)
# atau HTTP:
uvicorn server:mcp.app --reload
```

## 4. Contoh Pakai Tool
```python
from server import get_info, trade
import asyncio, json

async def demo():
    print(json.dumps(await get_info(), indent=2))
    # order beli BTC 50k IDR
    # await trade("btc_idr", "buy", price=500000000, idr=50000)
asyncio.run(demo())
```

## 5. Integrasi Editor (Claude Code)
- **VS Code**: letakkan `mcp_servers.json` di root ➜ *Command Palette* ➜ `Claude: Start MCP Server`.
- **JetBrains**: taruh `mcp_servers.json` di root atau `.claude/` ➜ Tools ➜ Claude ➜ *Start MCP Server*.
- **Neovim**: simpan `mcp_servers.json` di `~/.config/claude/` ➜ `:ClaudeStartServer indodax`.

Contoh `mcp_servers.json`:
```json
{
  "mcpServers": {
    "indodax": {
      "command": "uv",
      "args": ["--directory", "/ABSOLUTE/PATH/TO/mcp-indodax", "run", "server.py"]
    }
  }
}
```

---
### Struktur Singkat
```
server.py          # semua MCP tools
requirements.txt   # dependensi
mcp_servers.json   # config runner (contoh)
```


## Integrasi Editor / Claude Code

Berikut cara mendaftarkan *MCP server* di beberapa editor / plugin umum. Pastikan `mcp_servers.json` Anda sudah berisi path absolut proyek.

### VS Code (Claude Code Extension)
1. Install extension "Claude Code".
2. Letakkan `mcp_servers.json` di root proyek, contoh:
   ```json
   {
     "mcpServers": {
       "indodax": {
         "command": "uv",
         "args": [
           "--directory",
           "/ABSOLUTE/PATH/TO/mcp-indodax",
           "run",
           "server.py"
         ]
       }
     }
   }
   ```
3. Buka Command Palette → `Claude: Start MCP Server…` → pilih `indodax`.

### JetBrains IDE (IntelliJ / PyCharm) + Plugin Claude Code
1. Taruh `mcp_servers.json` di direktori `.claude/` atau root proyek.
2. Tools → Claude → **Start MCP Server** → pilih `indodax`.

### Neovim (`claude.nvim`)
1. Simpan `mcp_servers.json` di `$HOME/.config/claude/`.
2. Jalankan `:ClaudeStartServer indodax`.

### CLI Langsung
```bash
uv --directory /ABSOLUTE/PATH/TO/mcp-indodax run server.py   # atau python server.py
```

---

## Contoh Pemanggilan Alat

### 1. Mengecek Harga Kripto
```python
import asyncio
from server import ticker, ticker_all

async def check_prices():
    # Dapatkan semua ticker yang tersedia
    all_tickers = await ticker_all()
    
    # Dapatkan harga BTC/IDR
    btc_price = await ticker("btcidr")
    print(f"Harga BTC/IDR: {int(btc_price['last']):,}")
    
    # Dapatkan harga XRP/IDR
    xrp_price = await ticker("xrpidr")
    print(f"Harga XRP/IDR: {int(xrp_price['last']):,}")

asyncio.run(check_prices())
```

### 2. Mengecek Saldo dan Membuat Order
```python
import asyncio, json
from server import get_info, trade

async def main():
    # Dapatkan info akun
    info = await get_info()
    print("Saldo IDR:", info['return']['balance']['idr'])
    
    # Contoh order beli BTC senilai 50.000 IDR
    # res = await trade("btc_idr", "buy", price=500000000, idr=50000)
    # print(json.dumps(res, indent=2))

asyncio.run(main())
```

## Cara Melakukan Trading

### Daftar Perintah Trading

| Perintah | Deskripsi | Contoh Penggunaan |
|----------|-----------|-------------------|
| `ticker("btcidr")` | Melihat harga BTC/IDR terkini | ```python\nfrom server import ticker\nimport asyncio\n\nasync def main():\n    price = await ticker("btcidr")\n    print(f"Harga BTC: {int(price['last']):,} IDR")\n\nasyncio.run(main())\n``` |
| `trade("btcidr", "buy", idr=50000, price=500000000)` | Membeli kripto dengan IDR | ```python\nfrom server import trade\n\nasync def beli_btc():\n    await trade("btcidr", "buy", idr=50000, price=500000000)\n``` |
| `trade("xrpidr", "sell", xrp=100, price=40000)` | Menjual kripto | ```python\nfrom server import trade\n\nasync def jual_xrp():\n    await trade("xrpidr", "sell", xrp=100, price=40000)\n``` |
| `open_orders()` | Melihat daftar order aktif | ```python\nfrom server import open_orders\n\nasync def cek_order():\n    orders = await open_orders()\n    print(orders)\n``` |
| `cancel_order(order_id=12345)` | Membatalkan order | ```python\nfrom server import cancel_order\n\nasync def batal_order():\n    await cancel_order(order_id=12345)\n``` |

### 1. Membuat Order Beli/Jual

```python
import asyncio
from server import trade, get_info

async def place_order():
    # Dapatkan info akun terlebih dahulu
    info = await get_info()
    print("Saldo IDR:", info['return']['balance']['idr'])
    
    # Contoh order beli BTC senilai 50.000 IDR
    buy_order = await trade(
        pair="btcidr",       # pair yang akan ditradingkan
        type="buy",          # 'buy' atau 'sell'
        price=500000000,     # harga per unit (dalam satuan terkecil)
        idr=50000,          # jumlah IDR yang akan dibelanjakan
        # atau gunakan parameter crypto untuk menentukan jumlah koin
        # btc=0.001         # jumlah koin yang akan dibeli/dijual
    )
    print("Order Response:", buy_order)

asyncio.run(place_order())
```

### 2. Membatalkan Order

```python
import asyncio
from server import cancel_order, open_orders

async def cancel_existing_order():
    # Dapatkan daftar order terbuka
    orders = await open_orders()
    
    if 'btc_idr' in orders and orders['btc_idr']:
        # Batalkan order pertama yang ditemukan
        order_id = orders['btc_idr'][0]['order_id']
        result = await cancel_order(order_id=order_id)
        print(f"Order {order_id} dibatalkan:", result)

asyncio.run(cancel_existing_order())
```

### 2. Contoh Lengkap Trading

```python
import asyncio
from server import ticker, trade, open_orders, cancel_order

async def trading_bot():
    # 1. Cek harga BTC/IDR
    btc = await ticker("btcidr")
    print(f"Harga BTC: {int(btc['last']):,} IDR")
    
    # 2. Buat order beli jika harga di bawah 500 juta
    if btc['last'] < 500000000:
        print("Harga menarik, membeli...")
        order = await trade(
            pair="btcidr",
            type="buy",
            price=btc['last'],
            idr=100000  # Beli senilai 100 ribu IDR
        )
        print("Order berhasil:", order)
    
    # 3. Cek order aktif
    print("\nOrder aktif:")
    orders = await open_orders()
    for pair, order_list in orders.items():
        for order in order_list:
            print(f"- {pair}: {order['type']} {order['order_btc']} BTC @ {int(order['price']):,}")

# Jalankan bot
try:
    asyncio.run(trading_bot())
except Exception as e:
    print("Error:", e)
```

### 3. Memeriksa Order yang Aktif

```python
import asyncio
from server import open_orders

async def check_orders():
    orders = await open_orders()
    for pair, order_list in orders.items():
        if order_list:
            print(f"\nOrder aktif untuk {pair}:")
            for order in order_list:
                print(f"- ID: {order['order_id']}")
                print(f"  Tipe: {order['type']}")
                print(f"  Harga: {int(order['price']):,} IDR")
                print(f"  Jumlah: {order.get('order_btc', order.get('order_eth', 'N/A'))}")

asyncio.run(check_orders())
```

## Daftar Lengkap MCP Tools

> Gunakan nama fungsi berikut saat memanggil dari kode atau editor (Claude Code, dsb).

### Public (tanpa autentikasi)
- `server_time()` – waktu server bursa
- `pairs()` – daftar pair tersedia
- `price_increments()` – kelipatan harga tiap pair
- `summaries()` – ringkasan market seluruh pair
- `ticker(pair_id="btcidr")` – harga terkini satu pair
- `ticker_all()` – harga seluruh pair
- `trades(pair_id="btcidr")` – transaksi terakhir

### Private (butuh API key)
- `get_info()` – info akun & saldo
- `trans_history(start=None, end=None)` – histori transaksi
- `trade(pair, type, price, idr=None, crypto=None)` – buat order beli/jual
- `withdraw_coin(currency, amount, address, network=None, memo=None)` – tarik kripto
- `withdraw_fee(currency, amount, address, network=None)` – estimasi fee tarik
- `open_orders(pair=None)` – lihat order aktif
- `cancel_order(order_id)` – batalkan order (ID numerik)
- `cancel_by_client_order_id(client_order_id)` – batalkan order (client ID)
- `order_history(pair=None, count=100, from_id=None, end_id=None, order="desc")` – histori order
- `get_order(order_id)` – detail order berdasarkan ID
- `get_order_by_client_order_id(client_order_id)` – detail order berdasarkan client ID
- `price_increments()` – kelipatan harga (public tapi juga berguna)
- `list_downline()` – daftar referral (partner)
- `check_downline(username)` – cek apakah user downline
- `create_voucher(amount, description=None)` – buat voucher (partner)

---

## Daftar Pair ID yang Tersedia

Berikut adalah beberapa contoh pair ID yang bisa digunakan:
- `btcidr` - Bitcoin (BTC) ke Rupiah
- `ethidr` - Ethereum (ETH) ke Rupiah
- `xrpidr` - XRP ke Rupiah
- `adaidr` - Cardano (ADA) ke Rupiah
- `bnbidr` - Binance Coin (BNB) ke Rupiah
- `dogeidr` - Dogecoin (DOGE) ke Rupiah

## Struktur Proyek

```
├── server.py          # Implementasi MCP tools
├── requirements.txt   # Dependensi Python
├── mcp_servers.json   # Contoh konfigurasi runner MCP
├── .gitignore         # Mengabaikan file sensitif & artefak
└── README.md          # Dokumentasi ini
```

## Lisensi

MIT © 2025 Prihanantho Adhi Nugroho