monzo-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sam
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,351 @@
+# Monzo MCP Server
+
+An MCP (Model Context Protocol) server for the [Monzo banking API](https://docs.monzo.com). Check your balance, list transactions, manage pots, and more — all through natural language.
+
+Works with any MCP-compatible client, including Claude Desktop, Claude Code, Cursor, Windsurf, Cline, and others.
+
+> **Note:** The Monzo Developer API is for personal use only. You can only connect to your own account or a small number of explicitly allowed users.
+
+## Features
+
+19 tools covering the full Monzo API:
+
+| Category | Tools | Description |
+|----------|-------|-------------|
+| **Accounts** | `monzo_whoami`, `monzo_list_accounts`, `monzo_get_balance` | View account info and balances |
+| **Pots** | `monzo_list_pots`, `monzo_deposit_into_pot`, `monzo_withdraw_from_pot` | Manage savings pots |
+| **Transactions** | `monzo_list_transactions`, `monzo_get_transaction`, `monzo_annotate_transaction` | Browse and annotate transactions |
+| **Feed** | `monzo_create_feed_item` | Push custom items to the Monzo app feed |
+| **Attachments** | `monzo_upload_attachment`, `monzo_register_attachment`, `monzo_deregister_attachment` | Attach images to transactions |
+| **Receipts** | `monzo_create_receipt`, `monzo_get_receipt`, `monzo_delete_receipt` | Manage digital receipts |
+| **Webhooks** | `monzo_register_webhook`, `monzo_list_webhooks`, `monzo_delete_webhook` | Set up real-time notifications |
+
+---
+
+## Getting Your Monzo Access Token
+
+You need an access token to use this server.
+
+### Step 1: Create a Monzo Developer Account
+
+1. Go to [developers.monzo.com](https://developers.monzo.com)
+2. Log in with your Monzo email address
+3. You'll receive a magic link in your email — click it to sign in
+
+### Step 2: Get an Access Token via the API Playground
+
+1. Go to [developers.monzo.com/api/playground](https://developers.monzo.com/api/playground)
+2. Click **Auth** to start the authentication flow
+3. You'll receive a **push notification** on your Monzo app — tap it and verify with your PIN, fingerprint, or Face ID (Strong Customer Authentication)
+4. Once approved, the Playground will show your **Access Token**
+5. Copy this token — you'll need it in the next section
+
+### Important Notes About Tokens
+
+- **Tokens expire** after approximately **6 hours**
+- After authentication, you have **5 minutes** of full transaction history access. After that, only the **last 90 days** are available
+- Generating a new token **invalidates** the previous one
+- If your token expires, repeat Step 2
+
+---
+
+## Installation
+
+### Prerequisites
+
+- [Node.js](https://nodejs.org/) 18 or later
+
+### Use via npx (recommended)
+
+No installation required — just configure your MCP client to run:
+
+```bash
+npx monzo-mcp
+```
+
+### Install globally
+
+```bash
+npm install -g monzo-mcp
+```
+
+Then run:
+
+```bash
+monzo-mcp-server
+```
+
+### Build from source
+
+```bash
+git clone https://github.com/samaxbytez/monzo-mcp-server.git
+cd monzo-mcp-server
+npm install
+npm run build
+```
+
+---
+
+## Configuration
+
+### Claude Desktop
+
+Add the following to your Claude Desktop config file:
+
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "monzo": {
+      "command": "npx",
+      "args": ["monzo-mcp"],
+      "env": {
+        "MONZO_ACCESS_TOKEN": "your_access_token_here"
+      }
+    }
+  }
+}
+```
+
+Then restart Claude Desktop.
+
+### Claude Code (CLI)
+
+Add to your project's `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "monzo": {
+      "command": "npx",
+      "args": ["monzo-mcp"],
+      "env": {
+        "MONZO_ACCESS_TOKEN": "your_access_token_here"
+      }
+    }
+  }
+}
+```
+
+Or add it directly via the CLI:
+
+```bash
+claude mcp add monzo -- npx monzo-mcp
+```
+
+### Other MCP Clients (Cursor, Windsurf, Cline, etc.)
+
+Refer to your client's documentation for how to add an MCP server. The server command is:
+
+```
+npx monzo-mcp
+```
+
+With the environment variable `MONZO_ACCESS_TOKEN` set to your token.
+
+### Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `MONZO_ACCESS_TOKEN` | Yes | Your Monzo API access token |
+
+---
+
+## Usage Examples
+
+Once configured, you can ask your AI assistant things like (using Claude as an example):
+
+- **"What's my Monzo balance?"** — calls `monzo_get_balance`
+- **"Show my recent transactions"** — calls `monzo_list_transactions`
+- **"List my pots"** — calls `monzo_list_pots`
+- **"Move £50 into my Holiday pot"** — calls `monzo_deposit_into_pot`
+- **"What did I spend at Tesco last week?"** — calls `monzo_list_transactions` with filters
+- **"Send me a notification in Monzo saying 'Remember to buy milk'"** — calls `monzo_create_feed_item`
+
+---
+
+## Tool Reference
+
+### Accounts
+
+#### `monzo_whoami`
+Verify the authenticated user. Returns user ID, authentication type, and client ID.
+
+#### `monzo_list_accounts`
+List all accounts. Optionally filter by `account_type` (`uk_retail`, `uk_retail_joint`).
+
+#### `monzo_get_balance`
+Get the balance for a specific account. Returns balance, total balance, currency, and spend today — all in **pence** (minor units).
+
+**Parameters:**
+- `account_id` (required) — The account ID
+
+---
+
+### Pots
+
+#### `monzo_list_pots`
+List all pots for an account.
+
+**Parameters:**
+- `current_account_id` (required) — The account ID
+
+#### `monzo_deposit_into_pot`
+Move money from your account into a pot.
+
+**Parameters:**
+- `pot_id` (required) — The pot to deposit into
+- `source_account_id` (required) — The account to move money from
+- `amount` (required) — Amount in **pence** (e.g. `1000` = £10.00)
+- `dedupe_id` (required) — A unique string to prevent duplicate deposits
+
+#### `monzo_withdraw_from_pot`
+Move money from a pot back into your account. Pots with "added security" (lock) cannot be withdrawn via API.
+
+**Parameters:**
+- `pot_id` (required) — The pot to withdraw from
+- `destination_account_id` (required) — The account to move money to
+- `amount` (required) — Amount in **pence**
+- `dedupe_id` (required) — A unique string to prevent duplicate withdrawals
+
+---
+
+### Transactions
+
+#### `monzo_list_transactions`
+List transactions for an account. Limited to the last 90 days (after 5 minutes post-authentication).
+
+**Parameters:**
+- `account_id` (required) — The account ID
+- `since` (optional) — RFC 3339 timestamp or object ID (e.g. `2024-01-01T00:00:00Z`)
+- `before` (optional) — RFC 3339 timestamp
+- `limit` (optional) — Results per page (default 30, max 100)
+
+#### `monzo_get_transaction`
+Get details of a single transaction.
+
+**Parameters:**
+- `transaction_id` (required) — The transaction ID
+- `expand_merchant` (optional) — Set to `true` to include full merchant details
+
+#### `monzo_annotate_transaction`
+Add custom key-value metadata to a transaction.
+
+**Parameters:**
+- `transaction_id` (required) — The transaction ID
+- `key` (required) — The metadata key
+- `value` (required) — The metadata value (empty string to delete)
+
+---
+
+### Feed
+
+#### `monzo_create_feed_item`
+Create a custom item in the Monzo app feed.
+
+**Parameters:**
+- `account_id` (required) — The account ID
+- `title` (required) — Feed item title
+- `body` (required) — Feed item body text
+- `image_url` (optional) — URL of an image to display
+- `url` (optional) — URL to open when tapped
+
+---
+
+### Attachments
+
+#### `monzo_upload_attachment`
+Get a pre-signed upload URL for an image.
+
+**Parameters:**
+- `file_name` (required) — e.g. `receipt.png`
+- `file_type` (required) — MIME type, e.g. `image/png`
+- `content_length` (required) — File size in bytes
+
+#### `monzo_register_attachment`
+Attach an uploaded image to a transaction.
+
+**Parameters:**
+- `external_id` (required) — The transaction ID
+- `file_url` (required) — The URL from `monzo_upload_attachment`
+- `file_type` (required) — MIME type
+
+#### `monzo_deregister_attachment`
+Remove an attachment from a transaction.
+
+**Parameters:**
+- `id` (required) — The attachment ID
+
+---
+
+### Receipts
+
+#### `monzo_create_receipt`
+Create or update a digital receipt on a transaction.
+
+**Parameters:**
+- `transaction_id` (required) — The transaction ID
+- `items` (required) — JSON array of receipt items (each with `description`, `amount` in pence, `currency`, `quantity`)
+- `tax` (optional) — Total tax in pence
+
+#### `monzo_get_receipt`
+Get a receipt by its external ID.
+
+**Parameters:**
+- `external_id` (required) — Typically the transaction ID
+
+#### `monzo_delete_receipt`
+Delete a receipt.
+
+**Parameters:**
+- `external_id` (required) — Typically the transaction ID
+
+---
+
+### Webhooks
+
+#### `monzo_register_webhook`
+Register a URL to receive real-time transaction notifications.
+
+**Parameters:**
+- `account_id` (required) — The account ID
+- `url` (required) — The webhook URL
+
+#### `monzo_list_webhooks`
+List all webhooks for an account.
+
+**Parameters:**
+- `account_id` (required) — The account ID
+
+#### `monzo_delete_webhook`
+Delete a webhook.
+
+**Parameters:**
+- `webhook_id` (required) — The webhook ID
+
+---
+
+## Troubleshooting
+
+### "Missing required environment variable: MONZO_ACCESS_TOKEN"
+You haven't set the `MONZO_ACCESS_TOKEN` in your MCP server config. See [Getting Your Monzo Access Token](#getting-your-monzo-access-token).
+
+### "Monzo API error (401): unauthorized"
+Your access token has expired (tokens last ~6 hours). Get a new one from the [Monzo Playground](https://developers.monzo.com/api/playground).
+
+### "Monzo API error (403): forbidden"
+You may need to complete Strong Customer Authentication. Open the Monzo app and check for a pending approval notification.
+
+### "Transaction history is empty or limited"
+After 5 minutes post-authentication, the API only returns the last 90 days of transactions. This is a Monzo security restriction.
+
+### Pots withdrawal fails
+Pots with "added security" (locked pots) cannot be withdrawn from via the API. Unlock the pot in the Monzo app first.
+
+---
+
+## License
+
+MIT

package/build/client.d.ts

@@ -0,0 +1,16 @@
+export declare class MonzoApiError extends Error {
+    readonly status: number;
+    readonly errorCode: string;
+    constructor(status: number, errorCode: string, message: string);
+}
+export declare class MonzoClient {
+    private accessToken;
+    constructor(accessToken: string);
+    get<T = unknown>(path: string, params?: Record<string, string>): Promise<T>;
+    postForm<T = unknown>(path: string, body?: Record<string, string>): Promise<T>;
+    putForm<T = unknown>(path: string, body?: Record<string, string>): Promise<T>;
+    patchForm<T = unknown>(path: string, body?: Record<string, string>): Promise<T>;
+    putJson<T = unknown>(path: string, body: unknown): Promise<T>;
+    deleteReq<T = unknown>(path: string, params?: Record<string, string>): Promise<T>;
+    private request;
+}

package/build/client.js

@@ -0,0 +1,84 @@
+const MONZO_API_URL = "https://api.monzo.com";
+export class MonzoApiError extends Error {
+    status;
+    errorCode;
+    constructor(status, errorCode, message) {
+        super(`Monzo API error (${status}): ${errorCode} - ${message}`);
+        this.name = "MonzoApiError";
+        this.status = status;
+        this.errorCode = errorCode;
+    }
+}
+function parseApiError(status, body) {
+    try {
+        const parsed = JSON.parse(body);
+        const code = parsed?.error ?? "unknown";
+        const message = parsed?.message ?? parsed?.error_description ?? `HTTP ${status}`;
+        return new MonzoApiError(status, code, message);
+    }
+    catch {
+        return new MonzoApiError(status, "unknown", `HTTP ${status} error`);
+    }
+}
+function encodeFormBody(data) {
+    return new URLSearchParams(data).toString();
+}
+export class MonzoClient {
+    accessToken;
+    constructor(accessToken) {
+        this.accessToken = accessToken;
+    }
+    async get(path, params) {
+        return this.request("GET", path, undefined, undefined, params);
+    }
+    async postForm(path, body) {
+        return this.request("POST", path, body, "form");
+    }
+    async putForm(path, body) {
+        return this.request("PUT", path, body, "form");
+    }
+    async patchForm(path, body) {
+        return this.request("PATCH", path, body, "form");
+    }
+    async putJson(path, body) {
+        return this.request("PUT", path, body, "json");
+    }
+    async deleteReq(path, params) {
+        return this.request("DELETE", path, undefined, undefined, params);
+    }
+    async request(method, path, body, bodyType, params) {
+        const url = new URL(path, MONZO_API_URL);
+        if (params) {
+            for (const [k, v] of Object.entries(params)) {
+                url.searchParams.set(k, v);
+            }
+        }
+        const headers = {
+            Authorization: `Bearer ${this.accessToken}`,
+        };
+        let encodedBody;
+        if (body && bodyType === "json") {
+            headers["Content-Type"] = "application/json";
+            encodedBody = JSON.stringify(body);
+        }
+        else if (body && bodyType === "form") {
+            headers["Content-Type"] = "application/x-www-form-urlencoded";
+            encodedBody = encodeFormBody(body);
+        }
+        const response = await fetch(url.toString(), {
+            method,
+            headers,
+            body: encodedBody,
+        });
+        if (!response.ok) {
+            const errorBody = await response.text();
+            throw parseApiError(response.status, errorBody);
+        }
+        const text = await response.text();
+        if (!text) {
+            return {};
+        }
+        return JSON.parse(text);
+    }
+}
+//# sourceMappingURL=client.js.map

package/build/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/build/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/build/index.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { MonzoClient } from "./client.js";
+import { registerAccountTools } from "./tools/accounts.js";
+import { registerPotTools } from "./tools/pots.js";
+import { registerTransactionTools } from "./tools/transactions.js";
+import { registerFeedTools } from "./tools/feed.js";
+import { registerAttachmentTools } from "./tools/attachments.js";
+import { registerReceiptTools } from "./tools/receipts.js";
+import { registerWebhookTools } from "./tools/webhooks.js";
+const MONZO_ACCESS_TOKEN = process.env.MONZO_ACCESS_TOKEN;
+if (!MONZO_ACCESS_TOKEN) {
+    console.error("Missing required environment variable: MONZO_ACCESS_TOKEN");
+    process.exit(1);
+}
+const monzoClient = new MonzoClient(MONZO_ACCESS_TOKEN);
+const server = new McpServer({
+    name: "monzo-api",
+    version: "1.0.0",
+});
+registerAccountTools(server, monzoClient);
+registerPotTools(server, monzoClient);
+registerTransactionTools(server, monzoClient);
+registerFeedTools(server, monzoClient);
+registerAttachmentTools(server, monzoClient);
+registerReceiptTools(server, monzoClient);
+registerWebhookTools(server, monzoClient);
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Monzo MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;AAE1D,IAAI,CAAC,kBAAkB,EAAE,CAAC;IACxB,OAAO,CAAC,KAAK,CACX,2DAA2D,CAC5D,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,kBAAkB,CAAC,CAAC;AAExD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,oBAAoB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC1C,gBAAgB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AACtC,wBAAwB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC9C,iBAAiB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AACvC,uBAAuB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC7C,oBAAoB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC1C,oBAAoB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAE1C,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;AACrD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/build/tools/accounts.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { MonzoClient } from "../client.js";
+export declare function registerAccountTools(server: McpServer, client: MonzoClient): void;

package/build/tools/accounts.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { jsonResponse, errorResponse, logToolCall, buildParams } from "../utils.js";
+export function registerAccountTools(server, client) {
+    server.registerTool("monzo_whoami", {
+        title: "Who Am I",
+        description: "Verify the authenticated Monzo user. Returns user ID, authentication type, and client ID.",
+    }, async () => {
+        logToolCall("monzo_whoami");
+        try {
+            const result = await client.get("/ping/whoami");
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("monzo_list_accounts", {
+        title: "List Accounts",
+        description: "List the authenticated user's Monzo accounts. Returns account IDs, types, and descriptions.",
+        inputSchema: {
+            account_type: z
+                .string()
+                .optional()
+                .describe("Filter by account type (e.g. 'uk_retail', 'uk_retail_joint')"),
+        },
+    }, async ({ account_type }) => {
+        logToolCall("monzo_list_accounts", { account_type });
+        try {
+            const params = buildParams({ account_type });
+            const result = await client.get("/accounts", params);
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("monzo_get_balance", {
+        title: "Get Balance",
+        description: "Fetch the balance of a Monzo account. Returns balance, total balance, currency, and spend today (all in minor units / pence).",
+        inputSchema: {
+            account_id: z
+                .string()
+                .describe("The account ID to get the balance for"),
+        },
+    }, async ({ account_id }) => {
+        logToolCall("monzo_get_balance", { account_id });
+        try {
+            const result = await client.get("/balance", { account_id });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=accounts.js.map

package/build/tools/accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../../src/tools/accounts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEpF,MAAM,UAAU,oBAAoB,CAClC,MAAiB,EACjB,MAAmB;IAEnB,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,UAAU;QACjB,WAAW,EACT,2FAA2F;KAC9F,EACD,KAAK,IAAI,EAAE;QACT,WAAW,CAAC,cAAc,CAAC,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAChD,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,6FAA6F;QAC/F,WAAW,EAAE;YACX,YAAY,EAAE,CAAC;iBACZ,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,8DAA8D,CAAC;SAC5E;KACF,EACD,KAAK,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE;QACzB,WAAW,CAAC,qBAAqB,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;YAC7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YACrD,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,+HAA+H;QACjI,WAAW,EAAE;YACX,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,CAAC,uCAAuC,CAAC;SACrD;KACF,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QACvB,WAAW,CAAC,mBAAmB,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;YAC5D,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/attachments.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { MonzoClient } from "../client.js";
+export declare function registerAttachmentTools(server: McpServer, client: MonzoClient): void;

package/build/tools/attachments.js

@@ -0,0 +1,81 @@
+import { z } from "zod";
+import { jsonResponse, errorResponse, logToolCall } from "../utils.js";
+export function registerAttachmentTools(server, client) {
+    server.registerTool("monzo_upload_attachment", {
+        title: "Upload Attachment",
+        description: "Get a pre-signed upload URL for attaching an image to a Monzo transaction. Returns the upload URL and file URL to use with monzo_register_attachment.",
+        inputSchema: {
+            file_name: z
+                .string()
+                .describe("The name of the file (e.g. 'receipt.png')"),
+            file_type: z
+                .string()
+                .describe("The MIME type of the file (e.g. 'image/png', 'image/jpeg')"),
+            content_length: z
+                .number()
+                .int()
+                .positive()
+                .describe("The file size in bytes"),
+        },
+    }, async ({ file_name, file_type, content_length }) => {
+        logToolCall("monzo_upload_attachment", { file_name, file_type });
+        try {
+            const result = await client.postForm("/attachment/upload", {
+                file_name,
+                file_type,
+                content_length: String(content_length),
+            });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("monzo_register_attachment", {
+        title: "Register Attachment",
+        description: "Register an uploaded image as an attachment on a Monzo transaction. The image must already be uploaded to the URL from monzo_upload_attachment.",
+        inputSchema: {
+            external_id: z
+                .string()
+                .describe("The transaction ID to attach the image to"),
+            file_url: z
+                .string()
+                .describe("The file_url returned from monzo_upload_attachment"),
+            file_type: z
+                .string()
+                .describe("The MIME type of the file (e.g. 'image/png')"),
+        },
+    }, async ({ external_id, file_url, file_type }) => {
+        logToolCall("monzo_register_attachment", { external_id });
+        try {
+            const result = await client.postForm("/attachment/register", {
+                external_id,
+                file_url,
+                file_type,
+            });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("monzo_deregister_attachment", {
+        title: "Deregister Attachment",
+        description: "Remove an attachment from a Monzo transaction.",
+        inputSchema: {
+            id: z
+                .string()
+                .describe("The attachment ID to remove"),
+        },
+    }, async ({ id }) => {
+        logToolCall("monzo_deregister_attachment", { id });
+        try {
+            const result = await client.postForm("/attachment/deregister", { id });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=attachments.js.map

package/build/tools/attachments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.js","sourceRoot":"","sources":["../../src/tools/attachments.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEvE,MAAM,UAAU,uBAAuB,CACrC,MAAiB,EACjB,MAAmB;IAEnB,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,uJAAuJ;QACzJ,WAAW,EAAE;YACX,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,CAAC,2CAA2C,CAAC;YACxD,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,CAAC,4DAA4D,CAAC;YACzE,cAAc,EAAE,CAAC;iBACd,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,CAAC,wBAAwB,CAAC;SACtC;KACF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,EAAE,EAAE;QACjD,WAAW,CAAC,yBAAyB,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;QACjE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,oBAAoB,EAAE;gBACzD,SAAS;gBACT,SAAS;gBACT,cAAc,EAAE,MAAM,CAAC,cAAc,CAAC;aACvC,CAAC,CAAC;YACH,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,2BAA2B,EAC3B;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,iJAAiJ;QACnJ,WAAW,EAAE;YACX,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,CAAC,2CAA2C,CAAC;YACxD,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,CAAC,oDAAoD,CAAC;YACjE,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,CAAC,8CAA8C,CAAC;SAC5D;KACF,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE;QAC7C,WAAW,CAAC,2BAA2B,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,sBAAsB,EAAE;gBAC3D,WAAW;gBACX,QAAQ;gBACR,SAAS;aACV,CAAC,CAAC;YACH,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,6BAA6B,EAC7B;QACE,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EACT,gDAAgD;QAClD,WAAW,EAAE;YACX,EAAE,EAAE,CAAC;iBACF,MAAM,EAAE;iBACR,QAAQ,CAAC,6BAA6B,CAAC;SAC3C;KACF,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QACf,WAAW,CAAC,6BAA6B,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,wBAAwB,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YACvE,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/feed.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { MonzoClient } from "../client.js";
+export declare function registerFeedTools(server: McpServer, client: MonzoClient): void;

package/build/tools/feed.js

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import { jsonResponse, errorResponse, logToolCall } from "../utils.js";
+export function registerFeedTools(server, client) {
+    server.registerTool("monzo_create_feed_item", {
+        title: "Create Feed Item",
+        description: "Create a feed item in the Monzo app for a given account. The item appears in the user's transaction feed with a title, body, and optional image.",
+        inputSchema: {
+            account_id: z
+                .string()
+                .describe("The account ID to create the feed item for"),
+            title: z
+                .string()
+                .describe("The title of the feed item"),
+            body: z
+                .string()
+                .describe("The body text of the feed item"),
+            image_url: z
+                .string()
+                .optional()
+                .describe("URL of an image to display with the feed item"),
+            url: z
+                .string()
+                .optional()
+                .describe("URL to open when the feed item is tapped"),
+        },
+    }, async ({ account_id, title, body, image_url, url }) => {
+        logToolCall("monzo_create_feed_item", { account_id, title });
+        try {
+            const formBody = {
+                account_id,
+                type: "basic",
+                "params[title]": title,
+                "params[body]": body,
+            };
+            if (image_url)
+                formBody["params[image_url]"] = image_url;
+            if (url)
+                formBody["url"] = url;
+            const result = await client.postForm("/feed", formBody);
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=feed.js.map

package/build/tools/feed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feed.js","sourceRoot":"","sources":["../../src/tools/feed.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEvE,MAAM,UAAU,iBAAiB,CAC/B,MAAiB,EACjB,MAAmB;IAEnB,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,kJAAkJ;QACpJ,WAAW,EAAE;YACX,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,CAAC,4CAA4C,CAAC;YACzD,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,CAAC,4BAA4B,CAAC;YACzC,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,CAAC,gCAAgC,CAAC;YAC7C,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,+CAA+C,CAAC;YAC5D,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,0CAA0C,CAAC;SACxD;KACF,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,EAAE;QACpD,WAAW,CAAC,wBAAwB,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC;YACH,MAAM,QAAQ,GAA2B;gBACvC,UAAU;gBACV,IAAI,EAAE,OAAO;gBACb,eAAe,EAAE,KAAK;gBACtB,cAAc,EAAE,IAAI;aACrB,CAAC;YACF,IAAI,SAAS;gBAAE,QAAQ,CAAC,mBAAmB,CAAC,GAAG,SAAS,CAAC;YACzD,IAAI,GAAG;gBAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC;YAE/B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACxD,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/pots.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { MonzoClient } from "../client.js";
+export declare function registerPotTools(server: McpServer, client: MonzoClient): void;

package/build/tools/pots.js

@@ -0,0 +1,89 @@
+import { z } from "zod";
+import { jsonResponse, errorResponse, logToolCall } from "../utils.js";
+export function registerPotTools(server, client) {
+    server.registerTool("monzo_list_pots", {
+        title: "List Pots",
+        description: "List all pots for a Monzo account. Returns pot IDs, names, balances, and styles.",
+        inputSchema: {
+            current_account_id: z
+                .string()
+                .describe("The account ID to list pots for"),
+        },
+    }, async ({ current_account_id }) => {
+        logToolCall("monzo_list_pots", { current_account_id });
+        try {
+            const result = await client.get("/pots", { current_account_id });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("monzo_deposit_into_pot", {
+        title: "Deposit Into Pot",
+        description: "Move money from a Monzo account into a pot. Amount is in pence (e.g. 1000 = £10.00). Requires a unique dedupe_id to prevent duplicate deposits.",
+        inputSchema: {
+            pot_id: z
+                .string()
+                .describe("The pot ID to deposit into"),
+            source_account_id: z
+                .string()
+                .describe("The account ID to move money from"),
+            amount: z
+                .number()
+                .int()
+                .positive()
+                .describe("Amount in pence to deposit (e.g. 1000 = £10.00)"),
+            dedupe_id: z
+                .string()
+                .describe("Unique string to prevent duplicate deposits"),
+        },
+    }, async ({ pot_id, source_account_id, amount, dedupe_id }) => {
+        logToolCall("monzo_deposit_into_pot", { pot_id, amount });
+        try {
+            const result = await client.putForm(`/pots/${pot_id}/deposit`, {
+                source_account_id,
+                amount: String(amount),
+                dedupe_id,
+            });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("monzo_withdraw_from_pot", {
+        title: "Withdraw From Pot",
+        description: "Move money from a pot back into a Monzo account. Amount is in pence (e.g. 1000 = £10.00). Requires a unique dedupe_id. Pots with added security cannot be withdrawn via API.",
+        inputSchema: {
+            pot_id: z
+                .string()
+                .describe("The pot ID to withdraw from"),
+            destination_account_id: z
+                .string()
+                .describe("The account ID to move money to"),
+            amount: z
+                .number()
+                .int()
+                .positive()
+                .describe("Amount in pence to withdraw (e.g. 1000 = £10.00)"),
+            dedupe_id: z
+                .string()
+                .describe("Unique string to prevent duplicate withdrawals"),
+        },
+    }, async ({ pot_id, destination_account_id, amount, dedupe_id }) => {
+        logToolCall("monzo_withdraw_from_pot", { pot_id, amount });
+        try {
+            const result = await client.putForm(`/pots/${pot_id}/withdraw`, {
+                destination_account_id,
+                amount: String(amount),
+                dedupe_id,
+            });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=pots.js.map

package/build/tools/pots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pots.js","sourceRoot":"","sources":["../../src/tools/pots.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEvE,MAAM,UAAU,gBAAgB,CAC9B,MAAiB,EACjB,MAAmB;IAEnB,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,WAAW;QAClB,WAAW,EACT,kFAAkF;QACpF,WAAW,EAAE;YACX,kBAAkB,EAAE,CAAC;iBAClB,MAAM,EAAE;iBACR,QAAQ,CAAC,iCAAiC,CAAC;SAC/C;KACF,EACD,KAAK,EAAE,EAAE,kBAAkB,EAAE,EAAE,EAAE;QAC/B,WAAW,CAAC,iBAAiB,EAAE,EAAE,kBAAkB,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,kBAAkB,EAAE,CAAC,CAAC;YACjE,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,iJAAiJ;QACnJ,WAAW,EAAE;YACX,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,CAAC,4BAA4B,CAAC;YACzC,iBAAiB,EAAE,CAAC;iBACjB,MAAM,EAAE;iBACR,QAAQ,CAAC,mCAAmC,CAAC;YAChD,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,CAAC,iDAAiD,CAAC;YAC9D,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,CAAC,6CAA6C,CAAC;SAC3D;KACF,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE;QACzD,WAAW,CAAC,wBAAwB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,MAAM,UAAU,EAAE;gBAC7D,iBAAiB;gBACjB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;gBACtB,SAAS;aACV,CAAC,CAAC;YACH,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,8KAA8K;QAChL,WAAW,EAAE;YACX,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,CAAC,6BAA6B,CAAC;YAC1C,sBAAsB,EAAE,CAAC;iBACtB,MAAM,EAAE;iBACR,QAAQ,CAAC,iCAAiC,CAAC;YAC9C,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,CAAC,kDAAkD,CAAC;YAC/D,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,CAAC,gDAAgD,CAAC;SAC9D;KACF,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,sBAAsB,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE;QAC9D,WAAW,CAAC,yBAAyB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,MAAM,WAAW,EAAE;gBAC9D,sBAAsB;gBACtB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;gBACtB,SAAS;aACV,CAAC,CAAC;YACH,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/receipts.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { MonzoClient } from "../client.js";
+export declare function registerReceiptTools(server: McpServer, client: MonzoClient): void;

package/build/tools/receipts.js

@@ -0,0 +1,75 @@
+import { z } from "zod";
+import { jsonResponse, errorResponse, logToolCall } from "../utils.js";
+export function registerReceiptTools(server, client) {
+    server.registerTool("monzo_create_receipt", {
+        title: "Create/Update Receipt",
+        description: "Create or update a receipt on a Monzo transaction. Provide the transaction ID and receipt items as a JSON structure.",
+        inputSchema: {
+            transaction_id: z
+                .string()
+                .describe("The transaction ID to attach the receipt to"),
+            items: z
+                .string()
+                .describe("JSON array of receipt items, each with: description (string), amount (integer in pence), currency (string, e.g. 'GBP'), quantity (number). Example: [{\"description\":\"Coffee\",\"amount\":350,\"currency\":\"GBP\",\"quantity\":1}]"),
+            tax: z
+                .number()
+                .int()
+                .optional()
+                .describe("Total tax amount in pence"),
+        },
+    }, async ({ transaction_id, items, tax }) => {
+        logToolCall("monzo_create_receipt", { transaction_id });
+        try {
+            const parsedItems = JSON.parse(items);
+            const receiptBody = {
+                transaction_id,
+                external_id: transaction_id,
+                items: parsedItems,
+            };
+            if (tax !== undefined)
+                receiptBody.tax = tax;
+            const result = await client.putJson("/transaction-receipts", receiptBody);
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("monzo_get_receipt", {
+        title: "Get Receipt",
+        description: "Retrieve a receipt attached to a Monzo transaction.",
+        inputSchema: {
+            external_id: z
+                .string()
+                .describe("The external ID (typically the transaction ID) of the receipt"),
+        },
+    }, async ({ external_id }) => {
+        logToolCall("monzo_get_receipt", { external_id });
+        try {
+            const result = await client.get("/transaction-receipts", { external_id });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("monzo_delete_receipt", {
+        title: "Delete Receipt",
+        description: "Delete a receipt from a Monzo transaction.",
+        inputSchema: {
+            external_id: z
+                .string()
+                .describe("The external ID (typically the transaction ID) of the receipt to delete"),
+        },
+    }, async ({ external_id }) => {
+        logToolCall("monzo_delete_receipt", { external_id });
+        try {
+            const result = await client.deleteReq("/transaction-receipts", { external_id });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=receipts.js.map

package/build/tools/receipts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipts.js","sourceRoot":"","sources":["../../src/tools/receipts.ts"],"names":[],"mappings":"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"}

package/build/tools/transactions.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { MonzoClient } from "../client.js";
+export declare function registerTransactionTools(server: McpServer, client: MonzoClient): void;

package/build/tools/transactions.js

@@ -0,0 +1,91 @@
+import { z } from "zod";
+import { jsonResponse, errorResponse, logToolCall, buildParams } from "../utils.js";
+export function registerTransactionTools(server, client) {
+    server.registerTool("monzo_list_transactions", {
+        title: "List Transactions",
+        description: "List transactions for a Monzo account. Returns transaction amounts, merchants, categories, and metadata. Note: transaction history is limited to 90 days for API access.",
+        inputSchema: {
+            account_id: z
+                .string()
+                .describe("The account ID to list transactions for"),
+            since: z
+                .string()
+                .optional()
+                .describe("RFC 3339 timestamp or object ID to filter transactions after (e.g. '2024-01-01T00:00:00Z')"),
+            before: z
+                .string()
+                .optional()
+                .describe("RFC 3339 timestamp to filter transactions before"),
+            limit: z
+                .number()
+                .int()
+                .positive()
+                .max(100)
+                .optional()
+                .describe("Number of results per page (default 30, max 100)"),
+        },
+    }, async ({ account_id, since, before, limit }) => {
+        logToolCall("monzo_list_transactions", { account_id, since, before, limit });
+        try {
+            const params = buildParams({ account_id, since, before, limit });
+            const result = await client.get("/transactions", params);
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("monzo_get_transaction", {
+        title: "Get Transaction",
+        description: "Retrieve details of a single Monzo transaction by its ID. Optionally expand merchant details.",
+        inputSchema: {
+            transaction_id: z
+                .string()
+                .describe("The transaction ID to look up"),
+            expand_merchant: z
+                .boolean()
+                .optional()
+                .describe("Set to true to include full merchant details"),
+        },
+    }, async ({ transaction_id, expand_merchant }) => {
+        logToolCall("monzo_get_transaction", { transaction_id });
+        try {
+            const params = {};
+            if (expand_merchant) {
+                params["expand[]"] = "merchant";
+            }
+            const result = await client.get(`/transactions/${transaction_id}`, params);
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("monzo_annotate_transaction", {
+        title: "Annotate Transaction",
+        description: "Add custom metadata/annotations to a Monzo transaction. You can store key-value pairs on the transaction.",
+        inputSchema: {
+            transaction_id: z
+                .string()
+                .describe("The transaction ID to annotate"),
+            key: z
+                .string()
+                .describe("The metadata key (will be stored as metadata[key])"),
+            value: z
+                .string()
+                .describe("The metadata value. Set to empty string to delete the key."),
+        },
+    }, async ({ transaction_id, key, value }) => {
+        logToolCall("monzo_annotate_transaction", { transaction_id, key });
+        try {
+            const result = await client.patchForm(`/transactions/${transaction_id}`, {
+                [`metadata[${key}]`]: value,
+            });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=transactions.js.map

package/build/tools/transactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.js","sourceRoot":"","sources":["../../src/tools/transactions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEpF,MAAM,UAAU,wBAAwB,CACtC,MAAiB,EACjB,MAAmB;IAEnB,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,0KAA0K;QAC5K,WAAW,EAAE;YACX,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,CAAC,yCAAyC,CAAC;YACtD,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,4FAA4F,CAAC;YACzG,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,kDAAkD,CAAC;YAC/D,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,kDAAkD,CAAC;SAChE;KACF,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;QAC7C,WAAW,CAAC,yBAAyB,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YACjE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;YACzD,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,+FAA+F;QACjG,WAAW,EAAE;YACX,cAAc,EAAE,CAAC;iBACd,MAAM,EAAE;iBACR,QAAQ,CAAC,+BAA+B,CAAC;YAC5C,eAAe,EAAE,CAAC;iBACf,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,8CAA8C,CAAC;SAC5D;KACF,EACD,KAAK,EAAE,EAAE,cAAc,EAAE,eAAe,EAAE,EAAE,EAAE;QAC5C,WAAW,CAAC,uBAAuB,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,IAAI,eAAe,EAAE,CAAC;gBACpB,MAAM,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC;YAClC,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,iBAAiB,cAAc,EAAE,EAAE,MAAM,CAAC,CAAC;YAC3E,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,4BAA4B,EAC5B;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,2GAA2G;QAC7G,WAAW,EAAE;YACX,cAAc,EAAE,CAAC;iBACd,MAAM,EAAE;iBACR,QAAQ,CAAC,gCAAgC,CAAC;YAC7C,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,QAAQ,CAAC,oDAAoD,CAAC;YACjE,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,CAAC,4DAA4D,CAAC;SAC1E;KACF,EACD,KAAK,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE;QACvC,WAAW,CAAC,4BAA4B,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,iBAAiB,cAAc,EAAE,EAAE;gBACvE,CAAC,YAAY,GAAG,GAAG,CAAC,EAAE,KAAK;aAC5B,CAAC,CAAC;YACH,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/webhooks.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { MonzoClient } from "../client.js";
+export declare function registerWebhookTools(server: McpServer, client: MonzoClient): void;

package/build/tools/webhooks.js

@@ -0,0 +1,62 @@
+import { z } from "zod";
+import { jsonResponse, errorResponse, logToolCall } from "../utils.js";
+export function registerWebhookTools(server, client) {
+    server.registerTool("monzo_register_webhook", {
+        title: "Register Webhook",
+        description: "Register a webhook URL to receive real-time notifications for a Monzo account. Each time a transaction is created, Monzo will POST the transaction data to the URL.",
+        inputSchema: {
+            account_id: z
+                .string()
+                .describe("The account ID to register the webhook for"),
+            url: z
+                .string()
+                .describe("The URL that Monzo will POST transaction events to"),
+        },
+    }, async ({ account_id, url }) => {
+        logToolCall("monzo_register_webhook", { account_id, url });
+        try {
+            const result = await client.postForm("/webhooks", { account_id, url });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("monzo_list_webhooks", {
+        title: "List Webhooks",
+        description: "List all registered webhooks for a Monzo account.",
+        inputSchema: {
+            account_id: z
+                .string()
+                .describe("The account ID to list webhooks for"),
+        },
+    }, async ({ account_id }) => {
+        logToolCall("monzo_list_webhooks", { account_id });
+        try {
+            const result = await client.get("/webhooks", { account_id });
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    server.registerTool("monzo_delete_webhook", {
+        title: "Delete Webhook",
+        description: "Delete a registered webhook by its ID.",
+        inputSchema: {
+            webhook_id: z
+                .string()
+                .describe("The webhook ID to delete"),
+        },
+    }, async ({ webhook_id }) => {
+        logToolCall("monzo_delete_webhook", { webhook_id });
+        try {
+            const result = await client.deleteReq(`/webhooks/${webhook_id}`);
+            return jsonResponse(result);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=webhooks.js.map

package/build/tools/webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../src/tools/webhooks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEvE,MAAM,UAAU,oBAAoB,CAClC,MAAiB,EACjB,MAAmB;IAEnB,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,qKAAqK;QACvK,WAAW,EAAE;YACX,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,CAAC,4CAA4C,CAAC;YACzD,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,QAAQ,CAAC,oDAAoD,CAAC;SAClE;KACF,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE,EAAE;QAC5B,WAAW,CAAC,wBAAwB,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;YACvE,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,mDAAmD;QACrD,WAAW,EAAE;YACX,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,CAAC,qCAAqC,CAAC;SACnD;KACF,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QACvB,WAAW,CAAC,qBAAqB,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;YAC7D,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EACT,wCAAwC;QAC1C,WAAW,EAAE;YACX,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,CAAC,0BAA0B,CAAC;SACxC;KACF,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QACvB,WAAW,CAAC,sBAAsB,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,aAAa,UAAU,EAAE,CAAC,CAAC;YACjE,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/utils.d.ts

@@ -0,0 +1,16 @@
+export declare const TOKEN_BUFFER_MS = 60000;
+export declare function jsonResponse(data: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function errorResponse(error: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+};
+export declare function buildParams(obj: Record<string, unknown>): Record<string, string>;
+export declare function logToolCall(tool: string, params?: Record<string, unknown>): void;

package/build/utils.js

@@ -0,0 +1,33 @@
+export const TOKEN_BUFFER_MS = 60_000;
+export function jsonResponse(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+}
+export function errorResponse(error) {
+    const msg = error instanceof Error ? error.message : String(error);
+    return {
+        content: [{ type: "text", text: `Error: ${msg}` }],
+        isError: true,
+    };
+}
+export function buildParams(obj) {
+    const params = {};
+    for (const [k, v] of Object.entries(obj)) {
+        if (v !== undefined && v !== null)
+            params[k] = String(v);
+    }
+    return params;
+}
+export function logToolCall(tool, params) {
+    const sanitized = { ts: new Date().toISOString(), tool };
+    if (params) {
+        for (const [k, v] of Object.entries(params)) {
+            sanitized[k] = typeof v === "string" && v.length > 100
+                ? v.slice(0, 20) + "..."
+                : v;
+        }
+    }
+    console.error(JSON.stringify(sanitized));
+}
+//# sourceMappingURL=utils.js.map

package/build/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AAEtC,MAAM,UAAU,YAAY,CAAC,IAAa;IACxC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KAC1E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnE,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,GAAG,EAAE,EAAE,CAAC;QAC3D,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,GAA4B;IAE5B,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;YAAE,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,MAAgC;IACxE,MAAM,SAAS,GAA4B,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC;IAClF,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5C,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,GAAG;gBACpD,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK;gBACxB,CAAC,CAAC,CAAC,CAAC;QACR,CAAC;IACH,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;AAC3C,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "monzo-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for the Monzo banking API",
+  "type": "module",
+  "license": "MIT",
+  "keywords": [
+    "monzo",
+    "mcp",
+    "model-context-protocol",
+    "banking",
+    "ai",
+    "claude",
+    "llm"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/samaxbytez/monzo-mcp-server.git"
+  },
+  "homepage": "https://github.com/samaxbytez/monzo-mcp-server#readme",
+  "bugs": {
+    "url": "https://github.com/samaxbytez/monzo-mcp-server/issues"
+  },
+  "bin": {
+    "monzo-mcp-server": "build/index.js"
+  },
+  "files": [
+    "build"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc && chmod 755 build/index.js",
+    "dev": "tsc --watch",
+    "start": "node build/index.js",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.16.0",
+    "typescript": "^5.8.3",
+    "vitest": "^4.0.18"
+  }
+}