@guiie/buda-mcp 1.4.2 → 1.5.1

package/dist/tools/receive_addresses.js

@@ -0,0 +1,185 @@
+import { z } from "zod";
+import { BudaApiError } from "../client.js";
+import { validateCurrency } from "../validation.js";
+export const createReceiveAddressToolSchema = {
+    name: "create_receive_address",
+    description: "Generates a new receive address for a crypto currency. " +
+        "Creates a new blockchain deposit address for the given currency. " +
+        "Each call generates a distinct address. Not idempotent. " +
+        "IMPORTANT: Pass confirmation_token='CONFIRM' to execute. " +
+        "Only applicable to crypto currencies (BTC, ETH, etc.). " +
+        "Requires BUDA_API_KEY and BUDA_API_SECRET. " +
+        "Example: 'Give me a fresh Bitcoin deposit address.'",
+    inputSchema: {
+        type: "object",
+        properties: {
+            currency: {
+                type: "string",
+                description: "Currency code (e.g. 'BTC', 'ETH').",
+            },
+            confirmation_token: {
+                type: "string",
+                description: "Safety confirmation. Must equal exactly 'CONFIRM' (case-sensitive) to generate a new address.",
+            },
+        },
+        required: ["currency", "confirmation_token"],
+    },
+};
+export const listReceiveAddressesToolSchema = {
+    name: "list_receive_addresses",
+    description: "Lists all receive (deposit) addresses for a crypto currency on the authenticated Buda.com account. " +
+        "Returns an empty array if no addresses have been created yet. " +
+        "Requires BUDA_API_KEY and BUDA_API_SECRET. " +
+        "Example: 'What are my Bitcoin deposit addresses?'",
+    inputSchema: {
+        type: "object",
+        properties: {
+            currency: {
+                type: "string",
+                description: "Currency code (e.g. 'BTC', 'ETH').",
+            },
+        },
+        required: ["currency"],
+    },
+};
+export const getReceiveAddressToolSchema = {
+    name: "get_receive_address",
+    description: "Returns a single receive address by its ID for a given currency on Buda.com. " +
+        "Requires BUDA_API_KEY and BUDA_API_SECRET. " +
+        "Example: 'Get the details of my BTC receive address ID 42.'",
+    inputSchema: {
+        type: "object",
+        properties: {
+            currency: {
+                type: "string",
+                description: "Currency code (e.g. 'BTC', 'ETH').",
+            },
+            id: {
+                type: "number",
+                description: "The numeric ID of the receive address.",
+            },
+        },
+        required: ["currency", "id"],
+    },
+};
+function normalizeAddress(a) {
+    return {
+        id: a.id,
+        address: a.address,
+        currency: a.currency,
+        created_at: a.created_at,
+        label: a.label ?? null,
+    };
+}
+export async function handleListReceiveAddresses(args, client) {
+    const { currency } = args;
+    const validationError = validateCurrency(currency);
+    if (validationError) {
+        return {
+            content: [{ type: "text", text: JSON.stringify({ error: validationError, code: "INVALID_CURRENCY" }) }],
+            isError: true,
+        };
+    }
+    try {
+        const data = await client.get(`/currencies/${currency.toUpperCase()}/receive_addresses`);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ receive_addresses: data.receive_addresses.map(normalizeAddress) }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof BudaApiError
+            ? { error: err.message, code: err.status, path: err.path }
+            : { error: String(err), code: "UNKNOWN" };
+        return {
+            content: [{ type: "text", text: JSON.stringify(msg) }],
+            isError: true,
+        };
+    }
+}
+export async function handleGetReceiveAddress(args, client) {
+    const { currency, id } = args;
+    const validationError = validateCurrency(currency);
+    if (validationError) {
+        return {
+            content: [{ type: "text", text: JSON.stringify({ error: validationError, code: "INVALID_CURRENCY" }) }],
+            isError: true,
+        };
+    }
+    try {
+        const data = await client.get(`/currencies/${currency.toUpperCase()}/receive_addresses/${id}`);
+        return {
+            content: [{ type: "text", text: JSON.stringify(normalizeAddress(data.receive_address), null, 2) }],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof BudaApiError
+            ? { error: err.message, code: err.status, path: err.path }
+            : { error: String(err), code: "UNKNOWN" };
+        return {
+            content: [{ type: "text", text: JSON.stringify(msg) }],
+            isError: true,
+        };
+    }
+}
+export async function handleCreateReceiveAddress(args, client) {
+    const { currency, confirmation_token } = args;
+    if (confirmation_token !== "CONFIRM") {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        error: "Address not generated. confirmation_token must equal 'CONFIRM' to execute. " +
+                            "Each call creates a distinct address — review and set confirmation_token='CONFIRM' to proceed.",
+                        code: "CONFIRMATION_REQUIRED",
+                        preview: { currency },
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    const validationError = validateCurrency(currency);
+    if (validationError) {
+        return {
+            content: [{ type: "text", text: JSON.stringify({ error: validationError, code: "INVALID_CURRENCY" }) }],
+            isError: true,
+        };
+    }
+    try {
+        const data = await client.post(`/currencies/${currency.toUpperCase()}/receive_addresses`, {});
+        return {
+            content: [{ type: "text", text: JSON.stringify(normalizeAddress(data.receive_address), null, 2) }],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof BudaApiError
+            ? { error: err.message, code: err.status, path: err.path }
+            : { error: String(err), code: "UNKNOWN" };
+        return {
+            content: [{ type: "text", text: JSON.stringify(msg) }],
+            isError: true,
+        };
+    }
+}
+export function register(server, client) {
+    server.tool(listReceiveAddressesToolSchema.name, listReceiveAddressesToolSchema.description, {
+        currency: z.string().min(2).max(10).describe("Currency code (e.g. 'BTC', 'ETH')."),
+    }, (args) => handleListReceiveAddresses(args, client));
+    server.tool(getReceiveAddressToolSchema.name, getReceiveAddressToolSchema.description, {
+        currency: z.string().min(2).max(10).describe("Currency code (e.g. 'BTC', 'ETH')."),
+        id: z.number().int().positive().describe("The numeric ID of the receive address."),
+    }, (args) => handleGetReceiveAddress(args, client));
+    server.tool(createReceiveAddressToolSchema.name, createReceiveAddressToolSchema.description, {
+        currency: z.string().min(2).max(10).describe("Currency code (e.g. 'BTC', 'ETH')."),
+        confirmation_token: z
+            .string()
+            .describe("Safety confirmation. Must equal exactly 'CONFIRM' (case-sensitive) to generate a new address."),
+    }, (args) => handleCreateReceiveAddress(args, client));
+}
+//# sourceMappingURL=receive_addresses.js.map

package/dist/tools/remittance_recipients.d.ts

@@ -0,0 +1,54 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BudaClient } from "../client.js";
+export declare const listToolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            per: {
+                type: string;
+                description: string;
+            };
+            page: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+};
+export declare const getToolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleListRemittanceRecipients(args: {
+    per?: number;
+    page?: number;
+}, client: BudaClient): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare function handleGetRemittanceRecipient(args: {
+    id: number;
+}, client: BudaClient): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare function register(server: McpServer, client: BudaClient): void;
+//# sourceMappingURL=remittance_recipients.d.ts.map

package/dist/tools/remittance_recipients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remittance_recipients.d.ts","sourceRoot":"","sources":["../../src/tools/remittance_recipients.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AAGxD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;CAoB1B,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;;;;;;;;;CAiBzB,CAAC;AAaF,wBAAsB,8BAA8B,CAClD,IAAI,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EACrC,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAoChF;AAED,wBAAsB,4BAA4B,CAChD,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EACpB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAgBhF;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAmBpE"}

package/dist/tools/remittance_recipients.js

@@ -0,0 +1,106 @@
+import { z } from "zod";
+import { BudaApiError } from "../client.js";
+export const listToolSchema = {
+    name: "list_remittance_recipients",
+    description: "Lists all saved remittance recipients (bank accounts) for the authenticated Buda.com account. " +
+        "Supports pagination. " +
+        "Requires BUDA_API_KEY and BUDA_API_SECRET. " +
+        "Example: 'Who are my saved remittance recipients?'",
+    inputSchema: {
+        type: "object",
+        properties: {
+            per: {
+                type: "number",
+                description: "Results per page (default: 20, max: 300).",
+            },
+            page: {
+                type: "number",
+                description: "Page number (default: 1).",
+            },
+        },
+    },
+};
+export const getToolSchema = {
+    name: "get_remittance_recipient",
+    description: "Returns a single saved remittance recipient by its ID on Buda.com. " +
+        "Fetches saved bank details for one recipient. " +
+        "Requires BUDA_API_KEY and BUDA_API_SECRET. " +
+        "Example: 'Show remittance recipient ID 5.'",
+    inputSchema: {
+        type: "object",
+        properties: {
+            id: {
+                type: "number",
+                description: "The numeric ID of the remittance recipient.",
+            },
+        },
+        required: ["id"],
+    },
+};
+function normalizeRecipient(r) {
+    return {
+        id: r.id,
+        name: r.name,
+        bank: r.bank,
+        account_number: r.account_number,
+        currency: r.currency,
+        country: r.country ?? null,
+    };
+}
+export async function handleListRemittanceRecipients(args, client) {
+    try {
+        const params = {};
+        if (args.per !== undefined)
+            params.per = args.per;
+        if (args.page !== undefined)
+            params.page = args.page;
+        const data = await client.get("/remittance_recipients", Object.keys(params).length > 0 ? params : undefined);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        remittance_recipients: data.remittance_recipients.map(normalizeRecipient),
+                        meta: data.meta,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof BudaApiError
+            ? { error: err.message, code: err.status, path: err.path }
+            : { error: String(err), code: "UNKNOWN" };
+        return {
+            content: [{ type: "text", text: JSON.stringify(msg) }],
+            isError: true,
+        };
+    }
+}
+export async function handleGetRemittanceRecipient(args, client) {
+    try {
+        const data = await client.get(`/remittance_recipients/${args.id}`);
+        return {
+            content: [{ type: "text", text: JSON.stringify(normalizeRecipient(data.remittance_recipient), null, 2) }],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof BudaApiError
+            ? { error: err.message, code: err.status, path: err.path }
+            : { error: String(err), code: "UNKNOWN" };
+        return {
+            content: [{ type: "text", text: JSON.stringify(msg) }],
+            isError: true,
+        };
+    }
+}
+export function register(server, client) {
+    server.tool(listToolSchema.name, listToolSchema.description, {
+        per: z.number().int().min(1).max(300).optional().describe("Results per page (default: 20, max: 300)."),
+        page: z.number().int().min(1).optional().describe("Page number (default: 1)."),
+    }, (args) => handleListRemittanceRecipients(args, client));
+    server.tool(getToolSchema.name, getToolSchema.description, {
+        id: z.number().int().positive().describe("The numeric ID of the remittance recipient."),
+    }, (args) => handleGetRemittanceRecipient(args, client));
+}
+//# sourceMappingURL=remittance_recipients.js.map

package/dist/tools/remittances.d.ts

@@ -0,0 +1,120 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BudaClient } from "../client.js";
+export declare const listRemittancesToolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            per: {
+                type: string;
+                description: string;
+            };
+            page: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+};
+export declare const quoteRemittanceToolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            currency: {
+                type: string;
+                description: string;
+            };
+            amount: {
+                type: string;
+                description: string;
+            };
+            recipient_id: {
+                type: string;
+                description: string;
+            };
+            confirmation_token: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const acceptRemittanceQuoteToolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            id: {
+                type: string;
+                description: string;
+            };
+            confirmation_token: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const getRemittanceToolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleListRemittances(args: {
+    per?: number;
+    page?: number;
+}, client: BudaClient): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare function handleGetRemittance(args: {
+    id: number;
+}, client: BudaClient): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare function handleQuoteRemittance(args: {
+    currency: string;
+    amount: number;
+    recipient_id: number;
+    confirmation_token: string;
+}, client: BudaClient): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare function handleAcceptRemittanceQuote(args: {
+    id: number;
+    confirmation_token: string;
+}, client: BudaClient): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare function register(server: McpServer, client: BudaClient): void;
+//# sourceMappingURL=remittances.d.ts.map

package/dist/tools/remittances.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remittances.d.ts","sourceRoot":"","sources":["../../src/tools/remittances.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AAKxD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;CAoBrC,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;CAiCrC,CAAC;AAEF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;CAuB3C,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;CAiBnC,CAAC;AAgBF,wBAAsB,qBAAqB,CACzC,IAAI,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EACrC,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAoChF;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EACpB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAgBhF;AAED,wBAAsB,qBAAqB,CACzC,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAA;CAAE,EAC5F,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAkDhF;AAED,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAA;CAAE,EAChD,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAqChF;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CA2CpE"}