# kontist-mcp

MCP server for Kontist banking API (balance, transactions, transfers).

Source: [`github.com/tobiasendres-dev/kontist-mcp`](https://github.com/tobiasendres-dev/kontist-mcp)

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `KONTIST_CLIENT_ID` | Yes | Client ID from kontist.dev |
| `KONTIST_CLIENT_SECRET` | Yes | Client secret from kontist.dev |

## Usage

This MCP requires OAuth tokens. Run the OAuth flow once on the host:

```bash
# Clone, install, run auth
git clone https://github.com/tobiasendres-dev/kontist-mcp.git
cd kontist-mcp
npm install
KONTIST_CLIENT_ID=xxx KONTIST_CLIENT_SECRET=xxx npm run auth
```

Then mount the tokens file into the container:

```bash
docker run -d \
  --name kontist-mcp \
  -p 8111:8111 \
  -v ~/.config/kontist:/root/.config/kontist \
  -e KONTIST_CLIENT_ID=your_client_id \
  -e KONTIST_CLIENT_SECRET=your_client_secret \
  forgejo.corentic.eu/corentic/mcp-fleet-kontist:latest
```

## Tools

- `get_balance` — Current balance + available balance
- `get_account` — Account details (IBAN, holder)
- `list_transactions` — Recent transactions
- `create_transfer` — Create a transfer (requires TAN)
- `confirm_transfer` — Confirm with TAN
- `list_cards` — List all cards

Tokens expire after ~1 hour. Re-run `npm run auth` to refresh.