Skip to content

Releases

v0.6.1

Choose a tag to compare

@mad4ms mad4ms released this 13 Oct 17:38
2637132

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_document tool.

v0.6.0

Choose a tag to compare

@mad4ms mad4ms released this 13 Oct 16:44
147141e

Breaking

  • Fewer, consolidated tools (21 -> 17). read_document(format="text" | "cover" | "file") replaces
    extract_document_text, get_document_cover and download_document; format="file" returns a
    resource_link to the new resource comdirect://documents/{document_id} instead of embedding the PDF as base64
    in the model's context. get_account_balance is gone (list_accounts has every balance), get_depot_position
    is replaced by get_depot_positions(isin=...), get_order_dimensions by
    get_instrument(include_order_dimensions=true). The Python client keeps all methods.
  • All lists page the same way: limit/offset in, count, offset, truncated, next_offset out.
    list_documents takes limit/offset instead of paging_count/paging_first.
  • summarize_transactions returns account_ids instead of account_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_transactions and find_recurring_payments return history_starts when 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. The find_subscriptions prompt
    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 need purpose = "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_transactions marks them with internal,
    summarize_transactions reports them as internal_transfers (include_internal=true counts them as before).

  • summarize_transactions without account_id sums 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_orders lists the valid status and order_type values; parameter
    descriptions for all tools.

  • Prompts monthly_review, find_subscriptions and tax_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://categories shows 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=1 skips 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_subscriptions prompt covers at most 6 months (default 6) and monthly_review completes the current
    and the last six months, since the bank returns no older account transactions.
  • list_orders accepts any order_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_date instead 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_FILE and COMDIRECT_MCP_LOG_LEVEL set where and how much the server logs.

v0.5.1

Choose a tag to compare

@mad4ms mad4ms released this 10 Oct 11:11
379f33d

Fixed

  • MCP Registry metadata: the server.json description fits the registry's 100-character limit, so the release
    is listed in the MCP Registry again (0.5.0 was published to PyPI only).

v0.5.0

Choose a tag to compare

@mad4ms mad4ms released this 10 Oct 11:08
f39070e

Changed (breaking)

  • A .env file in the working directory is no longer read. Point COMDIRECT_ENV_FILE to 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_transactions returns date, amount, direction, counterparty, purpose and type; references only verbose.
    get_depot_positions returns compact positions; verbose=true restores 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_overview and get_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-only list_orders, get_order and get_order_dimensions, get_document_cover and
    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 counterparty and a direction; 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

  • purpose is cleaned up: SEPA line numbers removed, words split at the 35-character line boundary joined again,
    trailing reference block removed. Transaction.purpose_raw keeps the original.
  • quantity_unit resolves 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 login on 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/DEBIT values.
  • 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

Choose a tag to compare

@mad4ms mad4ms released this 10 Oct 08:14

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-mcp and the import package to comdirect_mcp.
  • The generated OpenAPI client is vendored as comdirect_mcp._openapi instead of a top-level
    openapi_client package, 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 login tool. 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.
  • mcp is a regular dependency, pillow moved to the phototan extra.
  • Missing values are None instead of 1970-01-01 or 0 (Transaction.booking_date,
    depot and position values, Transaction.type, Depot.display_id).
  • The repository root mcp_server.py is gone; start the server with comdirect-mcp or
    python -m comdirect_mcp.

Added

  • Credentials in the OS keychain: comdirect-mcp configure stores them (macOS Keychain, Windows Credential
    Manager, Secret Service); lookup order environment → keychain → .env. MCP client configs need no secrets.
  • comdirect-mcp command 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 (readOnlyHint etc.), structured output with output schemas, and proper
    isError results.
  • download_document returns an embedded resource; size limit via COMDIRECT_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_read in list_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.json for the official MCP Registry and automated registry publishing on release.
  • py.typed marker, 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_date is now the raw string.

  • download_document was annotated read-only although comdirect marks the document as read.

  • Push TAN confirmation no longer sends a x-once-authentication header (the CLI callback sent a dummy TAN).

  • Request ids are 9-digit HHmmssSSS numbers 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.

  • truncated was reported for transaction lists with exactly limit items.

  • 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-action v3 (v2 stopped working when GitHub removed Node 20).

Install: uvx comdirect-mcp@0.4.0 · Getting started · Full changelog

v0.3.1

Choose a tag to compare

@mad4ms mad4ms released this 25 Jan 09:19

Updated Docs: Readme and MCP_Usage.

v0.3

Choose a tag to compare

@mad4ms mad4ms released this 24 Jan 17:35
1ad3bfb

Added Comdirect MCP server implementation and related workflows

  • Introduced Comdirect MCP server in mcp_server.py with tools for account management, transactions, and document handling.
  • Added configuration for Comdirect credentials in .vscode/mcp.json.
  • Created MCP_USAGE.md for 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

Choose a tag to compare

@mad4ms mad4ms released this 18 Jan 15:24

What's Changed

  • Added patching of swagger file to accept more than 50 chars for docs by @mad4ms in #1

New Contributors

  • @mad4ms made their first contribution in #1

Full Changelog: v0.1...v0.2

v0.1

Choose a tag to compare

@mad4ms mad4ms released this 18 Jan 14:27