# kese_online_mcp

https://kese.online — WhatsApp ve Telegram üzerinden fiş/fatura fotoğrafı göndererek harcamalarınızı otomatik takip eden kişisel finans asistanı.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add trasmouss/kese_online_mcp

# Browse available tools
npx -y @smithery/cli@latest tool list trasmouss/kese_online_mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get trasmouss/kese_online_mcp add_expense

# Call a tool
npx -y @smithery/cli@latest tool call trasmouss/kese_online_mcp add_expense '{}'
```

## Direct MCP Connection

Endpoint: `https://kese_online_mcp--trasmouss.run.tools`

**Required config:**
- `api_key` (query) — https://kese.online panelinden aldığınız kullanıcı MCP Api Anahtarı

## Tools (22)

- `add_expense` — Manuel olarak yeni bir harcama/fiş kaydı ekler. AI kullanılmaz, token kesmez.
- `add_income` — Manuel gelir kaydı ekler.
- `add_payment` — Yeni ödeme planı oluşturur (kira, fatura, taksit vb.). Token kesmez.
- `add_receivable` — Yeni alacak kaydı ekler. Token kesmez.
- `delete_expense` — Bir harcama kaydını siler.
- `delete_payment` — Ödeme planını siler.
- `delete_receivable` — Alacak kaydını siler.
- `get_balance_and_tokens` — Kullanıcının token (kontör) bakiyesini ve mevcut paket bilgisini döndürür.
- `get_credits_history` — Token satın alma ve kullanım geçmişini döndürür.
- `get_expense` — Tek bir harcamanın detaylarını getirir (fiş kalemleri dahil).
- `get_stats_categories` — Cari ay için kategoriye göre harcama dağılımını döndürür.
- `get_stats_comparison` — Son 6 ay için gelir vs harcama karşılaştırmasını döndürür.
- `get_stats_daily` — Son N günlük günlük harcama toplamlarını döndürür.
- `get_stats_monthly` — Son 6 aylık harcama özetini döndürür (fişler + ödemeler dahil).
- `list_expenses` — Kullanıcının harcama/fiş kayıtlarını listeler. Sayfalama ve filtre destekli.
- `list_incomes` — Kullanıcının gelir kayıtlarını listeler.
- `list_payments` — Ödeme planlarını listeler (bekleyen ve ödenenler dahil).
- `list_receivables` — Alacak kayıtlarını listeler.
- `mark_payment_paid` — Bir ödemeyi ödendi olarak işaretler.
- `mark_receivable_received` — Bir alacağı tahsil edildi olarak işaretler.
- `update_expense` — Mevcut bir harcama kaydını günceller.
- `update_payment` — Ödeme planını günceller.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get trasmouss/kese_online_mcp <tool-name>
```