@blanketbyte/wise-mcp 0.0.0-stage → 1.0.0

package/dist/wise/service.js

@@ -0,0 +1,350 @@
+import { WiseApiError } from "./client.js";
+const PROFILE_TTL_MS = 5 * 60 * 1000;
+/** Activity types that move money between the user's own balances. */
+const NEUTRAL_TYPES = new Set(["INTERBALANCE", "AUTO_CONVERSION", "CARD_CHECK"]);
+/** Friendly `type` filter names → Wise `monetaryResourceType`. */
+export const ACTIVITY_TYPES = {
+    card: "CARD_TRANSACTION",
+    transfer: "TRANSFER",
+    conversion: "BALANCE_TRANSACTION",
+    direct_debit: "DIRECT_DEBIT_TRANSACTION",
+    cashback: "BALANCE_CASHBACK",
+    interest: "BALANCE_INTEREST",
+};
+export const stripTags = (s) => (s ?? "")
+    .replace(/<[^>]*>/g, "")
+    .replace(/&amp;/g, "&")
+    .replace(/&lt;/g, "<")
+    .replace(/&gt;/g, ">")
+    .replace(/&quot;/g, '"')
+    .replace(/&#39;/g, "'")
+    .replace(/\s+/g, " ")
+    .trim();
+/** "1,234.56" / "1.234,56" / "2,000" / "24.73" → number */
+export function parseNumber(raw) {
+    let s = raw.replace(/[\s  ']/g, "");
+    const lastComma = s.lastIndexOf(",");
+    const lastDot = s.lastIndexOf(".");
+    if (lastComma >= 0 && lastDot >= 0) {
+        s = lastComma > lastDot ? s.replace(/\./g, "").replace(",", ".") : s.replace(/,/g, "");
+    }
+    else if (lastComma >= 0) {
+        s = /^\d{1,3}(,\d{3})+$/.test(s) ? s.replace(/,/g, "") : s.replace(",", ".");
+    }
+    return Number(s);
+}
+/**
+ * Parses Wise's formatted activity amounts:
+ *   "24.73 EUR" (out), "<positive>+ 4,500 EUR</positive>" (in), "<negative>- 5 EUR</negative>" (out).
+ * Returns undefined for non-amount text such as "Roundup".
+ */
+export function parseAmount(text, activityType) {
+    if (!text)
+        return undefined;
+    const plain = stripTags(text);
+    const m = plain.match(/([+\-−])?\s*([\d][\d.,\s  ']*)\s*([A-Z]{3})\b/);
+    if (!m)
+        return undefined;
+    const amount = parseNumber(m[2]);
+    if (!Number.isFinite(amount))
+        return undefined;
+    let direction;
+    if (/<positive>/i.test(text) || m[1] === "+")
+        direction = "in";
+    else if (/<negative>/i.test(text) || m[1] === "-" || m[1] === "−")
+        direction = "out";
+    else
+        direction = activityType && NEUTRAL_TYPES.has(activityType) ? "neutral" : "out";
+    return { amount, currency: m[3], direction };
+}
+function profileName(p) {
+    return (p.fullName ??
+        p.businessName ??
+        p.details?.name ??
+        ([p.firstName ?? p.details?.firstName, p.lastName ?? p.details?.lastName].filter(Boolean).join(" ") || undefined));
+}
+/** Wise accepts ISO 8601; plain dates are expanded to the whole UTC day. */
+function isoBound(date, end) {
+    if (!date)
+        return undefined;
+    const d = new Date(/^\d{4}-\d{2}-\d{2}$/.test(date) ? `${date}T${end ? "23:59:59.999" : "00:00:00.000"}Z` : date);
+    if (Number.isNaN(d.getTime()))
+        throw new Error(`"${date}" isn't a valid date. Use YYYY-MM-DD or an ISO 8601 timestamp.`);
+    return d.toISOString();
+}
+export class WiseService {
+    client;
+    profiles;
+    constructor(client) {
+        this.client = client;
+    }
+    // --- Profiles ---------------------------------------------------------------
+    async listProfiles() {
+        if (this.profiles && Date.now() - this.profiles.at < PROFILE_TTL_MS)
+            return this.profiles.list;
+        const raw = await this.client.get("/v2/profiles");
+        const list = raw.map((p) => ({ id: p.id, type: String(p.type ?? "UNKNOWN"), name: profileName(p) }));
+        this.profiles = { at: Date.now(), list };
+        return list;
+    }
+    /** Accepts a profile id, "personal", "business" or (part of) a profile name. Default: the personal profile. */
+    async resolveProfile(ref) {
+        const profiles = await this.listProfiles();
+        if (!profiles.length)
+            throw new Error("This Wise user has no profiles.");
+        if (ref === undefined || ref === "")
+            return profiles.find((p) => p.type === "PERSONAL") ?? profiles[0];
+        const s = String(ref).trim().toLowerCase();
+        const found = profiles.find((p) => String(p.id) === s) ??
+            profiles.find((p) => p.type.toLowerCase() === s) ??
+            profiles.find((p) => p.name?.toLowerCase().includes(s));
+        if (!found) {
+            throw new Error(`Unknown profile "${ref}". Available: ${profiles.map((p) => `${p.id} (${p.type}${p.name ? ", " + p.name : ""})`).join("; ")}`);
+        }
+        return found;
+    }
+    /** One profile, or all of them when `ref` is omitted or "all". */
+    async resolveProfiles(ref) {
+        if (ref === undefined || ref === "" || String(ref).toLowerCase() === "all")
+            return this.listProfiles();
+        return [await this.resolveProfile(ref)];
+    }
+    // --- Balances ---------------------------------------------------------------
+    async listBalances(profiles, includeEmpty) {
+        const perProfile = await Promise.all(profiles.map(async (p) => {
+            const [standard, savings] = await Promise.all(["STANDARD", "SAVINGS"].map((types) => this.client.get(`/v4/profiles/${p.id}/balances`, { types })));
+            return [...standard, ...savings].map((b) => ({
+                id: b.id,
+                profile: { id: p.id, type: p.type },
+                kind: b.type === "SAVINGS" ? "jar" : "balance",
+                name: b.name ?? undefined,
+                currency: b.currency,
+                amount: b.amount?.value,
+                reserved: b.reservedAmount?.value || undefined,
+                total_worth: b.totalWorth?.value !== b.amount?.value ? b.totalWorth?.value : undefined,
+            }));
+        }));
+        return perProfile.flat().filter((b) => includeEmpty || Number(b.amount) !== 0 || Number(b.reserved ?? 0) !== 0);
+    }
+    // --- Activities (transactions, incl. card payments) ---------------------------
+    async listActivities(opts) {
+        const search = opts.search?.trim().toLowerCase();
+        const maxPages = search ? 20 : Math.ceil(opts.limit / 100) + 1;
+        const out = [];
+        let cursor = opts.cursor;
+        let pages = 0;
+        do {
+            // Without a search, page sizes line up with `limit` so Wise's cursor resumes exactly after the last item returned.
+            // With a search we keep whole pages (all matches), so a page can push the count slightly over `limit`.
+            const size = search ? 100 : Math.min(100, opts.limit - out.length);
+            const res = await this.client.get(`/v1/profiles/${opts.profile.id}/activities`, {
+                size,
+                since: isoBound(opts.since, false),
+                until: isoBound(opts.until, true),
+                monetaryResourceType: opts.resourceType,
+                status: opts.status,
+                nextCursor: cursor,
+            });
+            const items = (res.activities ?? []).map(mapActivity);
+            out.push(...(search ? items.filter((a) => matches(a, search)) : items));
+            cursor = res.cursor ?? undefined;
+            pages++;
+        } while (cursor && out.length < opts.limit && pages < maxPages);
+        return { activities: out, nextCursor: cursor, scannedPages: pages };
+    }
+    // --- Transfers ----------------------------------------------------------------
+    async listTransfers(opts) {
+        // Wise returns transfers oldest-first; fetch everything in range, then sort newest-first.
+        const PAGE = 100;
+        const MAX_PAGES = 20;
+        const all = [];
+        let offset = 0;
+        for (let page = 0; page < MAX_PAGES; page++) {
+            const batch = await this.client.get("/v1/transfers", {
+                profile: opts.profile.id,
+                limit: PAGE,
+                offset,
+                status: opts.status,
+                createdDateStart: isoBound(opts.since, false),
+                createdDateEnd: isoBound(opts.until, true),
+            });
+            all.push(...batch);
+            if (batch.length < PAGE)
+                break;
+            offset += PAGE;
+        }
+        const names = new Map();
+        if (all.length) {
+            const recipients = await this.listRecipients([opts.profile]).catch(() => []);
+            for (const r of recipients)
+                names.set(r.id, r.name);
+        }
+        const search = opts.search?.trim().toLowerCase();
+        const transfers = all
+            .map((t) => ({ ...mapTransfer(t), recipient_name: names.get(t.targetAccount) }))
+            .filter((t) => !search || JSON.stringify([t.reference, t.recipient_name, t.id]).toLowerCase().includes(search))
+            .sort((a, b) => String(b.created).localeCompare(String(a.created)));
+        return { total: transfers.length, transfers: transfers.slice(0, opts.limit), truncated: all.length >= PAGE * MAX_PAGES };
+    }
+    async getTransfer(id) {
+        const t = await this.client.get(`/v1/transfers/${id}`);
+        const recipient = t.targetAccount ? await this.getRecipient(t.targetAccount).catch(() => undefined) : undefined;
+        return { ...mapTransfer(t), recipient, rate: t.rate, quote_id: t.quoteUuid ?? t.quote, has_active_issues: t.hasActiveIssues, raw_status: t.status };
+    }
+    // --- Recipients -----------------------------------------------------------------
+    async listRecipients(profiles, currency) {
+        const lists = await Promise.all(profiles.map(async (p) => {
+            // Wise pages saved recipients with a seek position; follow it (capped) so long lists aren't cut at 100.
+            const items = [];
+            let seek;
+            for (let page = 0; page < 10; page++) {
+                const res = await this.client.get("/v2/accounts", { profileId: p.id, size: 100, currency: currency?.toUpperCase(), seekPosition: seek });
+                items.push(...(Array.isArray(res) ? res : (res.content ?? [])));
+                seek = Array.isArray(res) ? undefined : (res.seekPositionForNext ?? undefined);
+                if (seek === undefined || seek === null)
+                    break;
+            }
+            return items.map((r) => ({ ...mapRecipient(r), profile: { id: p.id, type: p.type } }));
+        }));
+        return lists.flat();
+    }
+    async getRecipient(id) {
+        return mapRecipient(await this.client.get(`/v2/accounts/${id}`));
+    }
+    // --- Quotes, recipients and transfers (write) ------------------------------------
+    /** Creates a Wise quote. Moves no money; a quote is the price a transfer would be made at. */
+    async createQuote(profile, q) {
+        const raw = await this.client.post(`/v3/profiles/${profile.id}/quotes`, {
+            sourceCurrency: q.sourceCurrency.toUpperCase(),
+            targetCurrency: q.targetCurrency.toUpperCase(),
+            sourceAmount: q.sourceAmount ?? null,
+            targetAmount: q.targetAmount ?? null,
+            targetAccount: q.targetAccount,
+        });
+        return mapQuote(raw);
+    }
+    /** Fields Wise needs to create a recipient in `target` currency (via a throwaway quote). */
+    async recipientRequirements(profile, source, target, amount) {
+        const quote = await this.createQuote(profile, { sourceCurrency: source, targetCurrency: target, sourceAmount: amount });
+        const raw = await this.client.get(`/v1/quotes/${quote.id}/account-requirements`, {}, { "Accept-Minor-Version": "1" });
+        return raw.map((r) => ({
+            type: r.type,
+            title: r.title,
+            usage: r.usageInfo ?? undefined,
+            fields: (r.fields ?? []).flatMap((f) => (f.group ?? []).map(mapRequirementField)),
+        }));
+    }
+    async createRecipient(profile, r) {
+        const raw = await this.client.post("/v1/accounts", {
+            profile: profile.id,
+            currency: r.currency.toUpperCase(),
+            type: r.type,
+            accountHolderName: r.accountHolderName,
+            ownedByCustomer: r.ownedByCustomer,
+            details: r.details,
+        });
+        return mapRecipient(raw);
+    }
+    /** Extra fields Wise needs for this transfer (e.g. transferPurpose, sourceOfFunds) that weren't provided. */
+    async missingTransferFields(quoteId, targetAccount, details) {
+        const raw = await this.client.post("/v1/transfer-requirements", { targetAccount, quoteUuid: quoteId, details });
+        const fields = (raw ?? []).flatMap((r) => (r.fields ?? []).flatMap((f) => (f.group ?? []).map(mapRequirementField)));
+        return fields
+            .map((f) => ({ ...f, key: f.key.replace(/^details\./, "") }))
+            .filter((f) => f.required && f.key !== "reference" && details[f.key] === undefined);
+    }
+    async createTransfer(t) {
+        // customerTransactionId makes this idempotent, so a retry after a timeout can't create a second transfer.
+        const raw = await this.client.post("/v1/transfers", { targetAccount: t.targetAccount, quoteUuid: t.quoteId, customerTransactionId: t.customerTransactionId, details: t.details }, { idempotent: true });
+        return mapTransfer(raw);
+    }
+    async cancelTransfer(id) {
+        return mapTransfer(await this.client.put(`/v1/transfers/${id}/cancel`));
+    }
+    // --- Rates ------------------------------------------------------------------------
+    async getRate(source, target, at) {
+        const res = await this.client.get("/v1/rates", { source: source.toUpperCase(), target: target.toUpperCase(), time: at ? isoBound(at, false) : undefined });
+        const r = Array.isArray(res) ? res[0] : res;
+        if (!r)
+            throw new WiseApiError(404, `No rate for ${source}→${target}`);
+        return { source: r.source, target: r.target, rate: r.rate, time: r.time };
+    }
+}
+function mapActivity(a) {
+    const amount = parseAmount(a.primaryAmount, a.type);
+    const secondary = parseAmount(a.secondaryAmount);
+    const secondaryText = stripTags(a.secondaryAmount);
+    return {
+        id: a.id,
+        date: a.createdOn,
+        type: a.type,
+        status: a.status,
+        title: stripTags(a.title),
+        description: stripTags(a.description) || undefined,
+        direction: amount?.direction,
+        amount: amount?.amount,
+        currency: amount?.currency,
+        amount_text: amount ? undefined : stripTags(a.primaryAmount) || undefined,
+        secondary_amount: secondary ? { amount: secondary.amount, currency: secondary.currency } : undefined,
+        secondary_text: !secondary && secondaryText ? secondaryText : undefined,
+        resource: a.resource?.type ? { type: a.resource.type, id: a.resource.id } : undefined,
+    };
+}
+function matches(a, search) {
+    return [a.title, a.description, a.type, a.secondary_text, a.amount_text].some((v) => v?.toLowerCase().includes(search));
+}
+function mapTransfer(t) {
+    return {
+        id: t.id,
+        created: t.created,
+        status: t.status,
+        reference: t.reference || t.details?.reference || undefined,
+        source: { amount: t.sourceValue, currency: t.sourceCurrency },
+        target: { amount: t.targetValue, currency: t.targetCurrency },
+        recipient_id: t.targetAccount ?? undefined,
+    };
+}
+function mapRecipient(r) {
+    return {
+        id: r.id,
+        name: typeof r.name === "string" ? r.name : (r.name?.fullName ?? r.accountHolderName),
+        currency: r.currency,
+        type: r.type,
+        account: r.accountSummary ?? r.longAccountSummary ?? undefined,
+        details: r.longAccountSummary && r.longAccountSummary !== r.accountSummary ? r.longAccountSummary : undefined,
+        owned_by_me: r.ownedByCustomer ?? undefined,
+        profile_id: r.profileId ?? r.profile ?? undefined,
+        active: r.active ?? undefined,
+    };
+}
+function mapQuote(q) {
+    const options = (q.paymentOptions ?? []).filter((o) => !o.disabled && (!q.payOut || o.payOut === q.payOut));
+    // You pay in the Wise app, usually from your balance: show that option's price.
+    const o = options.find((x) => x.payIn === "BALANCE") ?? options[0];
+    return {
+        id: String(q.id),
+        source: { amount: o?.sourceAmount ?? q.sourceAmount, currency: q.sourceCurrency },
+        target: { amount: o?.targetAmount ?? q.targetAmount, currency: q.targetCurrency },
+        rate: q.rate,
+        rate_type: q.rateType,
+        rate_expires: q.rateExpirationTime,
+        fee: o?.fee?.total !== undefined ? { amount: o.fee.total, currency: q.sourceCurrency } : undefined,
+        pay_in: o?.payIn,
+        pay_out: o?.payOut ?? q.payOut,
+        estimated_delivery: o?.estimatedDelivery,
+        delivery: o?.formattedEstimatedDelivery,
+        notices: (q.notices ?? []).map((n) => stripTags(n.text)).filter(Boolean),
+    };
+}
+function mapRequirementField(g) {
+    return {
+        key: String(g.key),
+        name: g.name,
+        required: !!g.required,
+        type: g.type,
+        example: g.example || undefined,
+        pattern: g.validationRegexp || undefined,
+        allowed: g.valuesAllowed?.length ? g.valuesAllowed.map((v) => ({ key: v.key, name: v.name })) : undefined,
+        refresh_on_change: g.refreshRequirementsOnChange || undefined,
+    };
+}

package/package.json

@@ -1,6 +1,71 @@
 {
   "name": "@blanketbyte/wise-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "MCP server for Wise: read balances, card payments, transfers and recipients, and prepare transfers you approve twice. Runs locally (npx, for Claude, Codex, Cursor…) or as a remote connector for Claude and ChatGPT.",
+  "mcpName": "io.github.BlanketByte/wise-mcp",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "wise",
+    "transferwise",
+    "claude",
+    "chatgpt",
+    "codex",
+    "mcp-server",
+    "banking",
+    "payments"
+  ],
+  "homepage": "https://github.com/BlanketByte/wise-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/BlanketByte/wise-mcp/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BlanketByte/wise-mcp.git"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "BlanketByte",
+    "url": "https://blanketbyte.com"
+  },
+  "type": "module",
+  "bin": {
+    "wise-mcp": "dist/cli.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "public",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/cli.js serve",
+    "dev": "tsx watch src/cli.ts serve",
+    "typecheck": "tsc --noEmit",
+    "e2e": "tsx scripts/e2e.ts",
+    "e2e:stdio": "tsx scripts/e2e-stdio.ts",
+    "test": "npm run typecheck && npm run e2e && npm run e2e:stdio",
+    "mcpb": "bash scripts/build-mcpb.sh",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.32.1",
+    "express": "^5.3.0",
+    "zod": "^4.6.5"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^26.6.5",
+    "tsx": "^4.23.15",
+    "typescript": "^7.0.2"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}

package/public/logo.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="512" height="512" viewBox="0 0 160 160">
+  <title>Wise MCP</title>
+  <rect width="160" height="160" rx="36" fill="#1a4d5c"/>
+  <rect x="28" y="38" width="104" height="70" rx="8" fill="#9fe870"/>
+  <path transform="translate(54.4,47.4) scale(1.6)" d="M0 20.2803L8.65113 9.64374H8.64862L3.38975 0H32L20.9261 32H14.6508L23.8219 5.45086H11.9916L14.6223 10.2126L14.6092 10.3439L10.5644 15.2642H17.1828L15.4463 20.2803H0Z" fill="#163300"/>
+  <path d="M18 114 H142 L134 126 H26 Z" fill="#5ba3b8"/>
+</svg>