Spree Commerce developer docs for AI agents
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
Description from the maker (original English)
Read-only access to comdirect accounts, transactions, depots, orders and postbox documents.
We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.
Pick the AI app you use, then copy the settings.
Passed 2/2 checks · Runs on your computer
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude, with some setup first
You need a comdirect key (sign up on the maker’s site, may cost money) · Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
One time only; it works for every server that needs Python (uv)
Open the maker’s site, sign up and create an API key for the next step. It may cost money.
SettingsDeveloperEdit Config
{
"mcpServers": {
"comdirect": {
"command": "uvx",
"args": [
"comdirect-mcp"
],
"env": {
"COMDIRECT_CLIENT_ID": "your-value",
"COMDIRECT_CLIENT_SECRET": "your-value",
"COMDIRECT_USERNAME": "your-value",
"COMDIRECT_PASSWORD": "your-value",
"COMDIRECT_MCP_PUSH_TAN_WAIT": "your-value",
"COMDIRECT_MCP_UNMASK_IBANS": "your-value",
"COMDIRECT_MCP_MASK_NAMES": "your-value",
"COMDIRECT_ENV_FILE": "your-value",
"COMDIRECT_MCP_CACHE_TTL": "your-value",
"COMDIRECT_MCP_MAX_DOCUMENT_BYTES": "your-value",
"COMDIRECT_MCP_CATEGORIES": "your-value",
"COMDIRECT_MCP_SKIP_ELICITATION": "your-value",
"COMDIRECT_MCP_LOG_FILE": "your-value",
"COMDIRECT_MCP_LOG_LEVEL": "your-value"
}
}
}
}Paste the key only into the app’s field, never into a chat or to anyone
Use comdirect and tell me what you can do for me, then show me one thing✓ If Claude says it is using comdirect or shows a comdirect tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect comdirect yet
comdirect runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect comdirect
B · Others in Online shops & payments that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
Works with Claude Code, with some setup first
You need a comdirect key (sign up on the maker’s site, may cost money) · Install Python (uv) on your computer first (one time)
One time only; it works for every server that needs Python (uv)
Open the maker’s site, sign up and create an API key for the next step. It may cost money.
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add comdirect --env COMDIRECT_CLIENT_ID=your-value --env COMDIRECT_CLIENT_SECRET=your-value --env COMDIRECT_USERNAME=your-value --env COMDIRECT_PASSWORD=your-value --env COMDIRECT_MCP_PUSH_TAN_WAIT=your-value --env COMDIRECT_MCP_UNMASK_IBANS=your-value --env COMDIRECT_MCP_MASK_NAMES=your-value --env COMDIRECT_ENV_FILE=your-value --env COMDIRECT_MCP_CACHE_TTL=your-value --env COMDIRECT_MCP_MAX_DOCUMENT_BYTES=your-value --env COMDIRECT_MCP_CATEGORIES=your-value --env COMDIRECT_MCP_SKIP_ELICITATION=your-value --env COMDIRECT_MCP_LOG_FILE=your-value --env COMDIRECT_MCP_LOG_LEVEL=your-value -- uvx comdirect-mcpReplace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
You should see comdirect listed as connected
Use comdirect and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using comdirect or shows a comdirect tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
You need a comdirect key (sign up on the maker’s site, may cost money) · Install Python (uv) on your computer first (one time)
One time only; it works for every server that needs Python (uv)
Open the maker’s site, sign up and create an API key for the next step. It may cost money.
In the comdirect settings, COMDIRECT_CLIENT_ID, COMDIRECT_CLIENT_SECRET, COMDIRECT_USERNAME, COMDIRECT_PASSWORD, COMDIRECT_MCP_PUSH_TAN_WAIT, COMDIRECT_MCP_UNMASK_IBANS, COMDIRECT_MCP_MASK_NAMES, COMDIRECT_ENV_FILE, COMDIRECT_MCP_CACHE_TTL, COMDIRECT_MCP_MAX_DOCUMENT_BYTES, COMDIRECT_MCP_CATEGORIES, COMDIRECT_MCP_SKIP_ELICITATION, COMDIRECT_MCP_LOG_FILE, COMDIRECT_MCP_LOG_LEVEL is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use comdirect and tell me what you can do for me, then show me one thing✓ If Cursor says it is using comdirect or shows a comdirect tool in the answer, you are connected
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
You need a comdirect key (sign up on the maker’s site, may cost money) · Install Python (uv) on your computer first (one time)
One time only; it works for every server that needs Python (uv)
Open the maker’s site, sign up and create an API key for the next step. It may cost money.
In the comdirect settings, COMDIRECT_CLIENT_ID, COMDIRECT_CLIENT_SECRET, COMDIRECT_USERNAME, COMDIRECT_PASSWORD, COMDIRECT_MCP_PUSH_TAN_WAIT, COMDIRECT_MCP_UNMASK_IBANS, COMDIRECT_MCP_MASK_NAMES, COMDIRECT_ENV_FILE, COMDIRECT_MCP_CACHE_TTL, COMDIRECT_MCP_MAX_DOCUMENT_BYTES, COMDIRECT_MCP_CATEGORIES, COMDIRECT_MCP_SKIP_ELICITATION, COMDIRECT_MCP_LOG_FILE, COMDIRECT_MCP_LOG_LEVEL is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use comdirect and tell me what you can do for me, then show me one thing✓ If VS Code says it is using comdirect or shows a comdirect tool in the answer, you are connected
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Claude Code
claude mcp add comdirect --env COMDIRECT_CLIENT_ID=your-value --env COMDIRECT_CLIENT_SECRET=your-value --env COMDIRECT_USERNAME=your-value --env COMDIRECT_PASSWORD=your-value --env COMDIRECT_MCP_PUSH_TAN_WAIT=your-value --env COMDIRECT_MCP_UNMASK_IBANS=your-value --env COMDIRECT_MCP_MASK_NAMES=your-value --env COMDIRECT_ENV_FILE=your-value --env COMDIRECT_MCP_CACHE_TTL=your-value --env COMDIRECT_MCP_MAX_DOCUMENT_BYTES=your-value --env COMDIRECT_MCP_CATEGORIES=your-value --env COMDIRECT_MCP_SKIP_ELICITATION=your-value --env COMDIRECT_MCP_LOG_FILE=your-value --env COMDIRECT_MCP_LOG_LEVEL=your-value -- uvx comdirect-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"comdirect": {
"command": "uvx",
"args": [
"comdirect-mcp"
],
"env": {
"COMDIRECT_CLIENT_ID": "your-value",
"COMDIRECT_CLIENT_SECRET": "your-value",
"COMDIRECT_USERNAME": "your-value",
"COMDIRECT_PASSWORD": "your-value",
"COMDIRECT_MCP_PUSH_TAN_WAIT": "your-value",
"COMDIRECT_MCP_UNMASK_IBANS": "your-value",
"COMDIRECT_MCP_MASK_NAMES": "your-value",
"COMDIRECT_ENV_FILE": "your-value",
"COMDIRECT_MCP_CACHE_TTL": "your-value",
"COMDIRECT_MCP_MAX_DOCUMENT_BYTES": "your-value",
"COMDIRECT_MCP_CATEGORIES": "your-value",
"COMDIRECT_MCP_SKIP_ELICITATION": "your-value",
"COMDIRECT_MCP_LOG_FILE": "your-value",
"COMDIRECT_MCP_LOG_LEVEL": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"comdirect": {
"command": "uvx",
"args": [
"comdirect-mcp"
],
"env": {
"COMDIRECT_CLIENT_ID": "your-value",
"COMDIRECT_CLIENT_SECRET": "your-value",
"COMDIRECT_USERNAME": "your-value",
"COMDIRECT_PASSWORD": "your-value",
"COMDIRECT_MCP_PUSH_TAN_WAIT": "your-value",
"COMDIRECT_MCP_UNMASK_IBANS": "your-value",
"COMDIRECT_MCP_MASK_NAMES": "your-value",
"COMDIRECT_ENV_FILE": "your-value",
"COMDIRECT_MCP_CACHE_TTL": "your-value",
"COMDIRECT_MCP_MAX_DOCUMENT_BYTES": "your-value",
"COMDIRECT_MCP_CATEGORIES": "your-value",
"COMDIRECT_MCP_SKIP_ELICITATION": "your-value",
"COMDIRECT_MCP_LOG_FILE": "your-value",
"COMDIRECT_MCP_LOG_LEVEL": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"comdirect": {
"type": "stdio",
"command": "uvx",
"args": [
"comdirect-mcp"
],
"env": {
"COMDIRECT_CLIENT_ID": "your-value",
"COMDIRECT_CLIENT_SECRET": "your-value",
"COMDIRECT_USERNAME": "your-value",
"COMDIRECT_PASSWORD": "your-value",
"COMDIRECT_MCP_PUSH_TAN_WAIT": "your-value",
"COMDIRECT_MCP_UNMASK_IBANS": "your-value",
"COMDIRECT_MCP_MASK_NAMES": "your-value",
"COMDIRECT_ENV_FILE": "your-value",
"COMDIRECT_MCP_CACHE_TTL": "your-value",
"COMDIRECT_MCP_MAX_DOCUMENT_BYTES": "your-value",
"COMDIRECT_MCP_CATEGORIES": "your-value",
"COMDIRECT_MCP_SKIP_ELICITATION": "your-value",
"COMDIRECT_MCP_LOG_FILE": "your-value",
"COMDIRECT_MCP_LOG_LEVEL": "your-value"
}
}
}
}COMDIRECT_CLIENT_ID secret envCOMDIRECT_CLIENT_SECRET secret envCOMDIRECT_USERNAME secret envCOMDIRECT_PASSWORD secret envCOMDIRECT_MCP_PUSH_TAN_WAIT envCOMDIRECT_MCP_UNMASK_IBANS envCOMDIRECT_MCP_MASK_NAMES envCOMDIRECT_ENV_FILE envCOMDIRECT_MCP_CACHE_TTL envCOMDIRECT_MCP_MAX_DOCUMENT_BYTES envCOMDIRECT_MCP_CATEGORIES envCOMDIRECT_MCP_SKIP_ELICITATION envCOMDIRECT_MCP_LOG_FILE envCOMDIRECT_MCP_LOG_LEVEL envThese settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
pypi: comdirect-mcpBased on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 11, 2026
The registry name was verified with the GitHub account mad4ms, which owns the repo
Code last changed 9 days ago
We have not read this repo from GitHub yet
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 2 of 2 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: COMDIRECT_CLIENT_ID, COMDIRECT_CLIENT_SECRET, COMDIRECT_USERNAME, COMDIRECT_PASSWORD
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed 9 days ago, and the latest version (0.6.1) reached the registry 28 days ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.
In the same category: Spree Commerce developer docs for AI agents, Stripe MCP, Sessy — Amazon SES observability
Servers in the same category from other makers, sorted by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
Stripe’s official server lets AI view and manage customers, products, payments and invoices. Connect to Stripe’s cloud and sign in with OAuth.
Read-only Amazon SES observability: search events, inspect bounces, pull delivery stats.
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
Read-only [MCP](https://modelcontextprotocol.io) server and typed Python client for the [comdirect REST API](https://www.comdirect.de/cms/kontakt-zugaenge-api.html). Let Claude, GitHub Copilot or a local model look at your accounts, transactions, depot and postbox. You approve the login in the photoTAN app, and no tool can move money.
[!WARNING]
Unofficial, not affiliated with comdirect. It handles your banking credentials, and every tool result goes to the
model behind your MCP client: with a cloud assistant your financial data leaves your computer. For the most
privacy use a local model. See SECURITY.md.
Leute, hier geht es um euer Geld. Nutzt das nur, wenn ihr den Code versteht und die Risiken kennt. MIT-Lizenz: Jeder darf damit machen, was er/sie will (auch ihr, comdirect 👀), aber ohne Gewährleistung und ohne Haftung.
Transparenz: Ein Teil des Codes stammt von Opus 5.5 und gpt-6.1-sol, ich habe reviewed, getestet und weise genickt. Genau deshalb: Code verstehen.
Der Server nutzt nur lesende Endpunkte, aber Fehler passieren trotzdem: comdirect kann die API ändern, Dependencies können kompromittiert werden, und 2FA ist kein Freifahrtschein. Deshalb:
comdirect-mcp configure). Eine .env enthält das Passwort im Klartext: niemals committen.MCP-Server: Hängt ihr ihn an einen Cloud-Client, verlassen eure Daten euren Rechner und können in Logs landen. Verwendungszwecke und Dokumente können Prompt-Injections enthalten. Also nur in Umgebungen nutzen, denen ihr vertraut.
Wer seine Kontoauszüge eh schon in ChatGPT kopiert: Macht, was ihr wollt, aber auf eigene Verantwortung!
The API returns account transactions of the last 180 days only.
| Tool | |
|---|---|
login / logout | Start a session (push TAN) / end and revoke it |
list_accounts, list_cards, get_wealth_overview | Balances of accounts, cards and all products |
list_transactions | Individual transactions |
summarize_transactions | Income, expenses and net per month, counterparty, type or category |
find_recurring_payments | Subscriptions, contracts and standing orders |
list_depots, get_depot_positions, summarize_portfolio | Depot positions and allocation |
list_depot_transactions, list_orders, get_order, get_instrument | Securities movements, order book, security data |
list_documents, read_document | Postbox documents as text or PDF (reading marks them as read) |
Prompts: monthly_review, find_subscriptions, tax_documents. Details: Tools reference.
You need uv, comdirect API access (Client ID and Secret) and photoTAN Push as default TAN method.
uvx comdirect-mcp@0.6.1 configure # stores your credentials in the OS keychain
Add the server to your client, e.g. Claude Code:
claude mcp add --transport stdio --scope user comdirect -- uvx comdirect-mcp@0.6.1
or Claude Desktop, LM Studio and others:
{
"mcpServers": { "comdirect": { "command": "uvx", "args": ["comdirect-mcp@0.6.1"] } } }
Then ask, e.g. *„Welche Abos zahle ich, und was kosten sie im Jahr?“* The assistant calls login and you approve the push in the app. VS Code, Ollama and more: Configure MCP clients · step by step: Getting started · problems: Troubleshoot.
from comdirect_mcp import ComdirectClient
from comdirect_mcp.utils import default_push_tan_callback
client = ComdirectClient( {"client_id": "...", "client_secret": "...", "username": "...", "password": "..."}, {"push_tan_cb": default_push_tan_callback}, ) client.login() # approve the push TAN, then press Enter for account in client.list_accounts(): print(account.id, account.balance, account.currency)
Documentation · CHANGELOG · CONTRIBUTING · AGENTS.md for AI coding agents · MIT License