Repository navigation
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.