Repository navigation
Releases
v0.6.1
Changed
- Shorter README; it no longer pins the previous version in its update note.
- Documentation: the getting-started tutorial and client guide mention clients that show no login dialog, the
categories guide explains when a rule for transfers is still needed, and the developer guide matches the 0.6.0
tools.
Fixed
- The PDF extraction timeout message pointed to the removed
download_documenttool.
v0.6.0
Breaking
- Fewer, consolidated tools (21 -> 17).
read_document(format="text" | "cover" | "file")replaces
extract_document_text,get_document_coveranddownload_document;format="file"returns a
resource_linkto the new resourcecomdirect://documents/{document_id}instead of embedding the PDF as base64
in the model's context.get_account_balanceis gone (list_accountshas every balance),get_depot_position
is replaced byget_depot_positions(isin=...),get_order_dimensionsby
get_instrument(include_order_dimensions=true). The Python client keeps all methods. - All lists page the same way:
limit/offsetin,count,offset,truncated,next_offsetout.
list_documentstakeslimit/offsetinstead ofpaging_count/paging_first. summarize_transactionsreturnsaccount_idsinstead ofaccount_id, and leaves transfers between your own
accounts out of income and expenses by default (see below).
Added
-
find_recurring_payments: subscriptions, contracts and standing orders with rhythm, current and previous amount,
projected yearly cost, next expected payment and whether a payment has ended. It covers the last 180 days, all
that comdirect returns. -
summarize_transactionsandfind_recurring_paymentsreturnhistory_startswhen the requested period starts
before the 180 days of account transactions that comdirect returns (seen live; not in the specification), so a
long-term total is not mistaken for a complete one. Thefind_subscriptionsprompt
uses it instead of having the assistant read individual bookings. -
Payments through PayPal show the merchant from the payment reference as counterparty and
via: "PayPal", so
grouping by counterparty, category rules and recurring payments see the shop instead of PayPal. Category rules
that matched PayPal as counterparty needpurpose = "PP."instead. -
summarize_transactions(group_by="category")lists the ten largest counterparties without a matching rule as
uncategorized, so the assistant can propose rules. -
Transfers between your own accounts are recognised by IBAN:
list_transactionsmarks them withinternal,
summarize_transactionsreports them asinternal_transfers(include_internal=truecounts them as before). -
summarize_transactionswithoutaccount_idsums all EUR accounts together, and reports progress while it reads. -
Bank results are cached for 60 seconds per session (
COMDIRECT_MCP_CACHE_TTL,ComdirectClient(cache_ttl=...)),
so continuing a list or a follow-up question no longer reloads every page. -
Human-readable titles for all tools;
list_orderslists the validstatusandorder_typevalues; parameter
descriptions for all tools. -
Prompts
monthly_review,find_subscriptionsandtax_documents: ready-made analyses that name the right
tools and pitfalls (internal transfers, documents marked as read). The client can complete their arguments. -
Local category rules (
~/.config/comdirect-mcp/categories.toml,COMDIRECT_MCP_CATEGORIES) and
summarize_transactions(group_by="category"). The rules are applied on the server; the resource
comdirect://categoriesshows their format and current content. -
A login dialog that the client declines or cancels within one second, without showing it (seen with Claude Code
2.1.296 on protocol 2026-07-28), falls back to the fixed approval window instead of failing.
COMDIRECT_MCP_SKIP_ELICITATION=1skips the dialog altogether.
Changed
- Smaller results: portfolio weights are rounded to two decimals, order dimensions leave out empty limit extension
and trading restriction lists, and a payment reference that only says "End-to-End-Ref.: nicht angegeben" is
left out. - The
find_subscriptionsprompt covers at most 6 months (default 6) andmonthly_reviewcompletes the current
and the last six months, since the bank returns no older account transactions. list_ordersaccepts anyorder_type: the live API uses types the specification does not name, e.g.
TRAILING_STOP_NATIVE_MARKET.- Paging through account transactions stops at the first bank page older than
min_booking_dateinstead of
reading the account's whole history; the comdirect API has no date filter for account transactions. - A login that is not approved now says whether the dialog was declined, cancelled or submitted without approval,
and tells the agent not to retry without asking, since each attempt counts towards comdirect's lock after 5. - The login logs the client's name, protocol version, elicitation capability and raw answer, and each challenge
step.COMDIRECT_MCP_LOG_FILEandCOMDIRECT_MCP_LOG_LEVELset where and how much the server logs.
v0.5.1
v0.5.0
Changed (breaking)
- A
.envfile in the working directory is no longer read. PointCOMDIRECT_ENV_FILEto a dotenv file if you
need one; the OS keychain is recommended. - Tool results are compact views: null fields are left out and details are behind
verbose: true.
list_transactionsreturns date, amount, direction, counterparty, purpose and type; references only verbose.
get_depot_positionsreturns compact positions;verbose=truerestores ids, purchase values and detailed
profit/loss. All data tools use compact views, including depots and documents.
Added
summarize_transactions: income, expenses, net and count per month, counterparty or type, computed on the
server, for cash flow questions without loading every transaction into the model's context.list_cards: card balances (e.g. Visa) from comdirect's balance report. The API has no card transactions.list_depot_transactions,get_wealth_overviewandget_instrument, with compact/verbose views, local date
checks and bank-supplied EUR totals. Instrument metadata optionally includes order dimensions and
bank-supplied underlying-price snapshots.get_account_balance,get_depot_position,summarize_portfolio(allocation per currency, no FX
conversion), read-onlylist_orders,get_orderandget_order_dimensions,get_document_coverand
isolated, bounded PDF text extraction (extract_document_text). Twenty-one tools in total.- Continuation for filtered transactions (
offset,next_offset) and documents (has_more,next_index).
Order lists follow bank pages and enforce filters locally; partial position lists cannot be aggregated. - Transactions have a resolved
counterpartyand adirection; comdirect's SEPA roles (remitter for direct
debits, creditor for transfers) no longer need interpreting. - Accounts have
type/type_name(e.g. Girokonto, Tagesgeld PLUS), account number, IBAN and credit limit. COMDIRECT_MCP_MASK_NAMES: optional pseudonyms for counterparty names.scripts/live_stdio_check.py: real-process review of all MCP tools, filters and aggregate consistency;
offline startup checks in both modes, one live login and optional token-expiry continuity check.- Offline subprocess tests exercise all twenty-one tools over stdio in both protocol modes, with fake banking
transport and authentication. - Documentation: using the server with Ollama through the ollmcp client (no login dialog, fallback window).
Changed
purposeis cleaned up: SEPA line numbers removed, words split at the 35-character line boundary joined again,
trailing reference block removed.Transaction.purpose_rawkeeps the original.quantity_unitresolves comdirect's special units (XXX→pieces, ...).- Own account numbers, IBANs and depot display numbers are masked like counterparty IBANs.
- Missing API amounts, currencies, identifiers and flags remain unknown instead of causing mapping/schema errors
or becoming invented defaults. Summaries reject missing amounts/currencies and validate the date range. - Authentication errors omit response bodies and arbitrary upstream descriptions.
- Regenerated the vendor client with the current generator after removing invented Boolean defaults.
- API coverage reference records missing read endpoints and intentionally excluded writes.
- Live checks suppress error details, return failure on login errors and download only already-read PDFs.
Fixed
- Repeated
loginon an active session is rejected before sending another push TAN or replacing its tokens. - Transaction direction filters translate MCP values to the banking API's
CREDIT/DEBITvalues. - Booking-date filters are enforced locally because the account API ignores them; summaries use the same
filtered transactions. Reversed ranges and date filters on pending transactions are rejected. - Depot movements follow bank pages using raw offsets instead of rejecting an initial partial response;
stalled/empty pages and changing match counts still fail explicitly. - Single depot-position reads accept direct object responses as well as the specification's envelope;
order-dimension lookups route ISIN/WKN/UUID identifiers to their correct filters. - An unnamed counterparty with an IBAN/BIC is retained for verbose output; whitespace-only names are omitted.
v0.4.0
The project is now published as comdirect-mcp (previously comdirect-api-wrapper) and
focuses on the MCP server, while keeping the typed Python client.
Changed (breaking)
- Renamed the PyPI distribution to
comdirect-mcpand the import package tocomdirect_mcp. - The generated OpenAPI client is vendored as
comdirect_mcp._openapiinstead of a top-level
openapi_clientpackage, so it cannot clash with other generated clients. - MCP server rebuilt on the MCP Python SDK v2 (
MCPServer), implementing the MCP specification
2026-07-28; older clients are supported through version negotiation. - Login is an explicit
logintool. The push TAN is confirmed through an MCP elicitation dialog
(multi round-trip request) instead of a fixed 10 s wait. Other tools no longer log in implicitly. mcpis a regular dependency,pillowmoved to thephototanextra.- Missing values are
Noneinstead of1970-01-01or0(Transaction.booking_date,
depot and position values,Transaction.type,Depot.display_id). - The repository root
mcp_server.pyis gone; start the server withcomdirect-mcpor
python -m comdirect_mcp.
Added
- Credentials in the OS keychain:
comdirect-mcp configurestores them (macOS Keychain, Windows Credential
Manager, Secret Service); lookup order environment → keychain →.env. MCP client configs need no secrets. comdirect-mcpcommand line:serve(default),configure [--delete],--version.- Automatic access token refresh (
ComdirectClient.refresh_token(), refresh before expiry). - Two-step login API:
ComdirectClient.start_login()/complete_login(). - MCP tool annotations (
readOnlyHintetc.), structured output with output schemas, and proper
isErrorresults. download_documentreturns an embedded resource; size limit viaCOMDIRECT_MCP_MAX_DOCUMENT_BYTES.- Counterparty IBANs are masked by default (
COMDIRECT_MCP_UNMASK_IBANS). DepotPosition.isin; instrument names are now actually returned (with-attr=instrument).Document.already_read/already_readinlist_documents.logout(and server shutdown) revokes the session at comdirect (DELETE /oauth/revoke): the refresh token is
rejected right away, so the session cannot be extended; the last access token stays valid until it expires
(at most 10 minutes; measured live, the API documentation claims immediate invalidation).- The MCP server refuses new logins after three unconfirmed TAN challenges; comdirect locks the online access
after five. - Logins request photoTAN Push explicitly (
ComdirectClient.start_login(tan_type=...)). server.jsonfor the official MCP Registry and automated registry publishing on release.py.typedmarker,python -m comdirect_mcp,scripts/live_check.py.- Documentation in
docs/following Diátaxis (tutorial, how-to guides, reference, explanation), including how
to get comdirect API access and how to use a local model. AGENTS.md,SECURITY.md,CONTRIBUTING.md,CODE_OF_CONDUCT.md, issue forms and a pull request template.
Fixed
Compared against comdirect's PDF documentation (REST API – Schnittstellenspezifikation, April 2020):
-
A non-existent valuta date such as
2019-02-30(documented by comdirect) made the whole transaction list fail;
Transaction.valuta_dateis now the raw string. -
download_documentwas annotated read-only although comdirect marks the document as read. -
Push TAN confirmation no longer sends a
x-once-authenticationheader (the CLI callback sent a dummy TAN). -
Request ids are 9-digit
HHmmssSSSnumbers and client session ids are hex, as specified. -
Depot balance mapping: the API nests the depot id (
aggregated.depot.depotId); found in a live test. -
Depot positions had no instrument names because instrument data was never requested.
-
truncatedwas reported for transaction lists with exactlylimititems. -
Lists no longer crash when the API omits
values.
Tooling
- uv_build backend, dependency groups, ruff (replaces flake8 and black), mypy in CI.
- CI on Python 3.12-3.14, actions pinned to commit SHAs, Dependabot, release tag/version check,
gitleaks-actionv3 (v2 stopped working when GitHub removed Node 20).
Install: uvx comdirect-mcp@0.4.0 · Getting started · Full changelog
v0.3.1
v0.3
Added Comdirect MCP server implementation and related workflows
- Introduced Comdirect MCP server in
mcp_server.pywith tools for account management, transactions, and document handling. - Added configuration for Comdirect credentials in
.vscode/mcp.json. - Created
MCP_USAGE.mdfor installation and usage instructions. - Implemented GitHub Actions workflows for secret scanning and testing.
- Added unit tests for Comdirect client functionality in
tests/test_client.py.
v0.2
v0.1
Full Changelog: https://github.com/mad4ms/comdirect-api-wrapper/commits/v0.1