# is-bankasi-mcp

MCP server for Isbank (Is Bankasi) developer API (Turkey). Access accounts, balances, transactions, exchange rates, transfers, and credit cards via OAuth 2.0 authentication.

## Tools (8)

| Tool | Description |
|---|---|
| `get_accounts` | List bank accounts |
| `get_account_balance` | Get account balance |
| `get_transactions` | Get account transactions |
| `get_exchange_rates` | Get current exchange rates |
| `initiate_transfer` | Initiate EFT/FAST/havale transfer |
| `get_transfer_status` | Check transfer status |
| `get_credit_cards` | List credit cards |
| `get_card_transactions` | Get credit card transactions |

## Quick Start

```json
{
  "mcpServers": {
    "isbank": {
      "command": "npx",
      "args": ["-y", "@theyahia/is-bankasi-mcp"],
      "env": {
        "ISBANK_CLIENT_ID": "<YOUR_CLIENT_ID>",
        "ISBANK_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}
```

## Environment Variables

| Variable | Required | Description |
|---|---|---|
| `ISBANK_CLIENT_ID` | Yes | OAuth client ID from Isbank developer portal |
| `ISBANK_CLIENT_SECRET` | Yes | OAuth client secret from Isbank developer portal |

## Demo Prompts

- "Show me all my Isbank accounts"
- "What is the balance of account ACC001?"
- "List transactions from March 2026 for my main account"
- "What is the current USD/TRY exchange rate?"
- "Transfer 5000 TRY to IBAN TR123456 via FAST"
- "Show my credit card transactions for this month"

## License

MIT