bankmcp 0.1.1 → 0.1.2

package/README.md

@@ -3,7 +3,7 @@
 **Your AI now reads your bank.** Ask it anything about your accounts. Read-only, self-hosted, one user. Standard MCP; tested with Claude and Ollama.
 
 BankMCP™ is not a bank. It is a small open-source server you host yourself
-(package name `bank-mcp`). It connects to your banks
+(npm package `bankmcp`). It connects to your banks
 through [Enable Banking](https://enablebanking.com), which wraps 2,700+
 European banks in one PSD2 API, and exposes them to any MCP client as a
 connector. Read-only, no payments, no third party holding your data.
@@ -24,8 +24,11 @@ Your assistant ──OAuth──▶ your BankMCP™ server ──JWT──▶ En
 - **Your server** holds the Enable Banking application key, the bank consents
   and your account ids. It does not store balances or transactions and sends no
   telemetry.
-- **Enable Banking** is the licensed provider. You log in at your bank's own
-  site to approve access; nobody sees your bank credentials.
+- **Enable Banking** is the licensed provider between your server and your
+  bank. Every balance and transaction you ask for passes through their
+  servers on the way to yours; they do not store it, and they do not see your
+  bank credentials, since you log in at your bank's own site. This hop is how
+  PSD2 works and is the one part of the chain that is not on your machine.
 
 ## Setup
 
@@ -38,6 +41,10 @@ minutes.
 
 ### On your own machine
 
+The server and its state live on your computer, and no AI vendor or app
+maker sees your data. The bank connection is not on your computer: it goes
+through Enable Banking, as described above.
+
 Requires [Node 24](https://nodejs.org) or newer. Add BankMCP™ to your client:
 
 Claude Code:
@@ -194,9 +201,10 @@ is polled. There is no way around that under PSD2.
 ## Claude Code plugin
 
 The repository is also a Claude Code plugin marketplace. The `bank` plugin
-bundles the connector entry and a skill that encodes how to work with the
-data: an account map, categorisation rules, the monthly review format and when
-to create watches.
+brings three skills: `/bank:setup` walks you through installing BankMCP™ on
+your machine, `/bank:deploy` through hosting it, and `bank` encodes how to work
+with the data: an account map, categorisation rules, the monthly review format
+and when to create watches.
 
 Point it at your server, then install:
 

package/dist/lib/mcp.js

@@ -1,7 +1,7 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { registerTools } from "./tools.js";
 import { registerPrompts } from "./prompts.js";
-export const VERSION = "0.1.1";
+export const VERSION = "0.1.2";
 export function createServer() {
     const server = new McpServer({ name: "bank", version: VERSION }, {
         instructions: [

package/dist/lib/stdio.js

@@ -11,5 +11,9 @@ const { ensureLocalServer } = await import("./local.js");
 ensureLocalServer().catch((err) => console.error("[bank] could not start the local server:", err.message));
 if (!isConfigured())
     console.error("[bank] not configured yet: ask your assistant anything and it will point you to the setup page");
-await createServer().connect(new StdioServerTransport());
+const transport = new StdioServerTransport();
+// Exit with the client: when stdin closes, the localhost listener must not keep the process alive.
+transport.onclose = () => process.exit(0);
+process.stdin.on("end", () => process.exit(0));
+await createServer().connect(transport);
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bankmcp",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "BankMCP™: self-hosted, read-only MCP server that lets any AI assistant (Claude, ChatGPT, Mistral, Cursor, or a local model) answer questions about your own bank accounts via open banking (Enable Banking, PSD2)",
   "license": "MIT",
   "type": "module",

package/plugin/.claude-plugin/plugin.json

@@ -1,9 +1,17 @@
 {
   "name": "bank",
-  "version": "0.1.0",
-  "description": "BankMCP™: work with your own bank accounts through an bank-mcp (Enable Banking, open banking) connector: account mapping, categorisation rules and the monthly review format.",
-  "author": { "name": "Nils Smed" },
+  "version": "0.1.1",
+  "description": "BankMCP™: work with your own bank accounts through a bankmcp server (Enable Banking, open banking) connector: account mapping, categorisation rules and the monthly review format.",
+  "author": {
+    "name": "Nils Smed"
+  },
   "homepage": "https://github.com/noskillish/bankmcp",
   "license": "MIT",
-  "keywords": ["banking", "personal-finance", "psd2", "enable-banking", "mcp"]
+  "keywords": [
+    "banking",
+    "personal-finance",
+    "psd2",
+    "enable-banking",
+    "mcp"
+  ]
 }

package/plugin/skills/deploy/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: deploy
+description: Deploy BankMCP™ to a small server so it works in claude.ai and on the phone: Railway or Fly.io, volume, domain, setup page, connector. Use when the user says "deploy bankmcp", "host it", "/deploy", "use it on my phone", or "add it to claude.ai".
+---
+
+# Deploy BankMCP™ to a server
+
+Guide one person through a hosted deployment. Prefer Railway unless the user names another host. Run what you can with the CLI; the user does the dashboard clicks, their bank login and their claude.ai settings.
+
+## 1. Choose the host
+
+Ask which they have: Railway, Fly.io, or their own box with Docker. If none, recommend Railway (https://railway.com) and wait until they have an account.
+
+## 2. Railway
+
+If the `railway` CLI is installed and logged in (`railway whoami`), do it from the terminal:
+
+```
+railway init
+railway add --service bankmcp --repo noskillish/bankmcp --branch main
+railway volume add -m /data
+railway domain --port 8080
+```
+
+Otherwise, in the Railway dashboard: New Project, Deploy from GitHub repo `noskillish/bankmcp`; add a Volume mounted at `/data`; Settings, Networking, Generate Domain on port 8080.
+
+Report the public address. No variables are needed; the server detects its own address on Railway.
+
+## 3. Fly.io or Docker
+
+Fly: `fly launch --no-deploy` from a clone of the repo, `fly volumes create data --size 1`, add a `[mounts]` entry for `/data`, `fly deploy`. Docker: `docker compose up -d` from a clone, then a TLS proxy in front and `BASE_URL` set to the public https address.
+
+## 4. Setup page
+
+Tell the user to open the public address. It shows a setup page with the values for Enable Banking's form. Walk them through registering the application as in the `setup` skill (environment, redirect URL, description, privacy and terms URLs, key download), then entering the application id, the `.pem` file and a password of twelve characters or more. The status page then shows the connector URL.
+
+## 5. Connector
+
+claude.ai (personal Pro or Max account): Settings, Connectors, Add custom connector, name `BankMCP™`, URL `https://<address>/mcp`, leave OAuth fields empty, Add, Connect, enter the password.
+
+Team or Enterprise workspaces only allow Owners to add custom connectors; say so if the button is missing.
+
+Claude Code: `claude mcp add --transport http bankmcp https://<address>/mcp`, then `/mcp` to sign in.
+
+## 6. Bank
+
+In the connected client: "connect my bank". Same flow as locally; the redirect returns to the server's `/callback`.
+
+## Notes
+
+- Changing the password later logs every client out; that is the kill switch.
+- Set `NOTIFY_WEBHOOK_URL` to a Slack incoming webhook for sign-in alerts and watch notifications.

package/plugin/skills/setup/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: setup
+description: Set up BankMCP™ on this machine step by step: check Node, register the local MCP server, walk through the Enable Banking application, finish the setup page and connect the first bank. Use when the user says "set up bankmcp", "install bankmcp", "/setup", "connect my bank for the first time", or has BankMCP tools that report "not set up yet".
+---
+
+# Set up BankMCP™ locally
+
+You are guiding one person through running BankMCP™ on their own machine. Do the steps in order, one at a time, and confirm each before the next. Run commands yourself where you can; ask the user to do the parts that need their browser or their bank login. Do not guess values; read them from command output.
+
+## 1. Node
+
+Run `node --version`. BankMCP needs 24 or newer. If it is older or missing, tell the user to install the current LTS from https://nodejs.org and stop until it is done.
+
+## 2. Register the server with Claude Code
+
+Run:
+
+```
+claude mcp add --scope user bankmcp -- npx -y bankmcp
+```
+
+Then tell the user to restart Claude Code (or run `/mcp`) so the `bankmcp` tools appear. Wait for them to confirm the tools are listed.
+
+## 3. Find the setup page
+
+Call any BankMCP tool, for example `list_accounts`. On a fresh install it answers with a localhost address such as `https://localhost:8080`. Give the user that exact address and tell them:
+
+- their browser will warn about a self-signed certificate on localhost; they should continue past it, it is the server they just started;
+- the page lists four values for Enable Banking's form, each with a Copy button.
+
+## 4. Enable Banking application
+
+Tell the user to open https://enablebanking.com/cp/applications in another tab, create an account if needed, and add an application:
+
+- Environment: **Production** for real accounts, **Sandbox** to try with test data.
+- Paste the redirect URL, description, privacy URL and terms URL from the setup page.
+- Keep "generate private key" selected. On Save a `.pem` file downloads once; the application id (a UUID) is shown after saving.
+
+For Production, mention that the application starts Inactive and that clicking **Activate by linking accounts** and logging in at their bank is what activates it for their own accounts.
+
+## 5. Finish the setup page
+
+Back on the localhost page: paste the application id, choose the downloaded `.pem`, set the country, click Finish setup. The page turns into a status page. Confirm with the user.
+
+## 6. Connect the first bank
+
+Call `list_banks` with the user's country and let them pick. Call `start_consent` with the exact bank name and give them the URL. They log in at the bank and land on a "Bank connected" page. Then call `list_accounts` and show what got linked. Offer labels with `set_account_label`.
+
+## If something fails
+
+- Tool says "not set up yet" after setup: the server may need a restart; run `/mcp` and reconnect `bankmcp`.
+- "redirect_uri" errors from Enable Banking: the redirect URL on the application must be exactly the one the setup page showed, including `https://` and the port.
+- Port in use: set `PORT` for the server (for example `claude mcp add --scope user -e PORT=8085 bankmcp -- npx -y bankmcp`) and register the matching redirect URL.