comdirect MCP Server

by mad4msio.github.mad4ms/comdirect-mcpv0.6.1

Read-only access to comdirect accounts, transactions, depots, orders and postbox documents.

3Pythonstdioofficial registry

context tax

pending

security

pending

cold start

pending

freshness

pending

Our reading of comdirect, from the data

comdirect is a e-commerce MCP server from mad4ms, listed in the official MCP Registry.

We haven't measured its tool list yet, so its token cost is unknown.

With 3 GitHub stars it ranks #106 of 936 e-commerce servers we index.

It runs locally on your machine over stdio and needs 4 secrets (COMDIRECT_CLIENT_ID, COMDIRECT_CLIENT_SECRET, COMDIRECT_USERNAME, …); use a scoped, least-privilege key.

Install comdirect MCP server

claude mcp add comdirect -e COMDIRECT_CLIENT_ID='<comdirect-client-id>' -e COMDIRECT_CLIENT_SECRET='<comdirect-client-secret>' -e COMDIRECT_USERNAME='<comdirect-username>' -e COMDIRECT_PASSWORD='<comdirect-password>' -- uvx comdirect-mcp

{
  "mcpServers": {
    "comdirect": {
      "command": "uvx",
      "args": [
        "comdirect-mcp"
      ],
      "env": {
        "COMDIRECT_CLIENT_ID": "<comdirect-client-id>",
        "COMDIRECT_CLIENT_SECRET": "<comdirect-client-secret>",
        "COMDIRECT_USERNAME": "<comdirect-username>",
        "COMDIRECT_PASSWORD": "<comdirect-password>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "comdirect": {
      "command": "uvx",
      "args": [
        "comdirect-mcp"
      ],
      "env": {
        "COMDIRECT_CLIENT_ID": "<comdirect-client-id>",
        "COMDIRECT_CLIENT_SECRET": "<comdirect-client-secret>",
        "COMDIRECT_USERNAME": "<comdirect-username>",
        "COMDIRECT_PASSWORD": "<comdirect-password>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "comdirect": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "comdirect-mcp"
      ],
      "env": {
        "COMDIRECT_CLIENT_ID": "<comdirect-client-id>",
        "COMDIRECT_CLIENT_SECRET": "<comdirect-client-secret>",
        "COMDIRECT_USERNAME": "<comdirect-username>",
        "COMDIRECT_PASSWORD": "<comdirect-password>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "comdirect": {
      "command": "uvx",
      "args": [
        "comdirect-mcp"
      ],
      "env": {
        "COMDIRECT_CLIENT_ID": "<comdirect-client-id>",
        "COMDIRECT_CLIENT_SECRET": "<comdirect-client-secret>",
        "COMDIRECT_USERNAME": "<comdirect-username>",
        "COMDIRECT_PASSWORD": "<comdirect-password>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
COMDIRECT_CLIENT_ID	—	yes	comdirect API client id (or stored in the OS keychain via `comdirect-mcp configure`)
COMDIRECT_CLIENT_SECRET	—	yes	comdirect API client secret (or stored in the OS keychain via `comdirect-mcp configure`)
COMDIRECT_USERNAME	—	yes	comdirect Zugangsnummer (or stored in the OS keychain via `comdirect-mcp configure`)
COMDIRECT_PASSWORD	—	yes	comdirect PIN (or stored in the OS keychain via `comdirect-mcp configure`)
COMDIRECT_MCP_PUSH_TAN_WAIT	—	—	Seconds to wait for the push TAN approval if the client cannot show a confirmation dialog
COMDIRECT_MCP_UNMASK_IBANS	—	—	Set to true to return counterparty IBANs unmasked
COMDIRECT_MCP_MASK_NAMES	—	—	Set to true to replace counterparty names with stable pseudonyms
COMDIRECT_ENV_FILE	—	—	Path to a dotenv file with the credentials (opt-in; prefer the OS keychain)
COMDIRECT_MCP_CACHE_TTL	—	—	Seconds the server keeps bank results within a session; 0 disables the cache
COMDIRECT_MCP_MAX_DOCUMENT_BYTES	—	—	Size limit for postbox documents in bytes
COMDIRECT_MCP_CATEGORIES	—	—	Path of the category rules file (default ~/.config/comdirect-mcp/categories.toml)
COMDIRECT_MCP_SKIP_ELICITATION	—	—	Set to 1 to skip the login confirmation dialog and wait for the push TAN approval instead
COMDIRECT_MCP_LOG_FILE	—	—	File the server appends its log to (default stderr)
COMDIRECT_MCP_LOG_LEVEL	—	—	Log level of the server

Freshness

Not enough public signals yet to judge maintenance.

Last commit (default branch)
2026-10-14 · 4d ago · GitHub
Latest release
2026-10-13 · 5d ago · GitHub · v0.6.1
Package published
no data · npm/PyPI
Registry entry updated
2026-10-13 · 5d ago · official registry · v0.6.1

How it compares in E-commerce

Against the most-starred e-commerce servers we index. Token cost is per model turn, measured from each server's live tool list.

Server	Stars	Tools	Tokens / turn	Freshness	Runs
comdirect (this)	3	—	not measured	—	local
Actors	11,906	—	not measured	Active	—
Agent Toolkit	1,960	—	not measured	Active	hosted
Sessy — Amazon SES observability	941	—	not measured	Active	hosted
Amazon	273	—	not measured	Active	local
Bling	273	—	not measured	Active	local

All e-commerce MCP servers

FAQ

›How do I install the comdirect MCP server in Claude Code?

Run: claude mcp add comdirect -e COMDIRECT_CLIENT_ID='<comdirect-client-id>' -e COMDIRECT_CLIENT_SECRET='<comdirect-client-secret>' -e COMDIRECT_USERNAME='<comdirect-username>' -e COMDIRECT_PASSWORD='<comdirect-password>' -- uvx comdirect-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does comdirect require an API key?

Yes. It expects COMDIRECT_CLIENT_ID, COMDIRECT_CLIENT_SECRET, COMDIRECT_USERNAME, COMDIRECT_PASSWORD, of which 4 are secrets.

›Can I use comdirect as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is comdirect in the official MCP registry?

Yes, as io.github.mad4ms/comdirect-mcp.

Sources and method

Official MCP Registry entry: updated 2026-10-13
GitHub repository: fetched 2026-10-19
Package registry (npm / PyPI): listed
Last checked against all sources: 2026-10-19

The description, packages and links come from the maintainer's own published metadata. Token cost, security signals, freshness and the reading above are MCPSkillHub's own measurements; see the methodology. Spot an error? Request a correction or claim the listing.