47 lines
1.3 KiB
Markdown
47 lines
1.3 KiB
Markdown
|
# 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.
|