kontist-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| KONTIST_CLIENT_ID | Yes | OAuth client ID from the Kontist developer app. | |
| KONTIST_CLIENT_SECRET | Yes | OAuth client secret from the Kontist developer app. | |
| KONTIST_REFRESH_TOKEN | Yes | Long-lived refresh token obtained via the one-time OAuth setup. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| kontist_whoamiA | Verify Kontist auth is working and return basic identity. Run this first to confirm credentials before any other call. |
| kontist_get_balanceA | Return the current Kontist business account balance, IBAN, and available balance (in EUR). |
| kontist_list_transactionsB | List recent Kontist transactions with optional filters. Default returns last 50. Amounts are in EUR (positive = inflow, negative = outflow). |
| kontist_get_transactionA | Fetch a single Kontist transaction by its ID. |
| kontist_get_tax_reservesA | Get current balances of the Kontist VAT and income tax reserve sub-accounts. Returns null fields if not enabled or if Kleinunternehmer (no VAT). |
| kontist_annotate_transactionA | Add a note/annotation to a transaction. Useful for tagging Stripe payouts with the originating customer or invoice. |
| kontist_summarizeA | High-level financial summary for a date range: inflows, outflows, net, top counterparties, category breakdown. Default = last 30 days. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool targets a distinct concern: identity, balance, transaction listing, single transaction lookup, tax reserves, annotation, and summary. Even the two balance tools are clearly separated by account type, and list/get transaction follow a standard collection/detail split.
All tools share the kontist_ prefix and use snake_case, with a consistent verb_noun structure for most tools (get_balance, list_transactions, get_transaction, get_tax_reserves, annotate_transaction, summarize). The only outlier is kontist_whoami, which uses a command-style name rather than a verb_noun pattern.
Seven tools is an appropriate size for a banking/finance-focused MCP server. Each tool provides a meaningful capability without redundancy or padding, and the count is neither too thin nor overwhelming.
The toolset covers the core Kontist workflow: auth verification, balance, transaction browsing and detail lookup, tax reserve visibility, annotation, and period summaries. There are no obvious dead ends for the stated scope of reading and annotating account data.