@guiie/buda-mcp 1.4.2 → 1.5.1

package/dist/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAKA,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,QAAQ,CAAuC;IAEjD,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAyBtF,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI7B,KAAK,IAAI,IAAI;CAGd;AAED,eAAO,MAAM,SAAS;;;;CAIZ,CAAC;AAEX,eAAO,MAAM,KAAK,aAAoB,CAAC"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAKA,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,QAAQ,CAAuC;IAEjD,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAyBtF,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI7B,KAAK,IAAI,IAAI;CAGd;AAED,eAAO,MAAM,SAAS;;;;;CAKZ,CAAC;AAEX,eAAO,MAAM,KAAK,aAAoB,CAAC"}

package/dist/cache.js

@@ -34,6 +34,7 @@ export const CACHE_TTL = {
     MARKETS: 60_000,
     TICKER: 5_000,
     ORDERBOOK: 3_000,
+    BANKS: 60_000,
 };
 export const cache = new MemoryCache();
 //# sourceMappingURL=cache.js.map

package/dist/client.d.ts

@@ -10,6 +10,7 @@ export declare class BudaClient {
     private readonly apiSecret;
     constructor(baseUrl?: string, apiKey?: string, apiSecret?: string);
     hasAuth(): boolean;
+    private _nonceCounter;
     private nonce;
     private sign;
     private authHeaders;
@@ -29,5 +30,6 @@ export declare class BudaClient {
     get<T>(path: string, params?: Record<string, string | number>): Promise<T>;
     post<T>(path: string, payload: unknown): Promise<T>;
     put<T>(path: string, payload: unknown): Promise<T>;
+    delete<T>(path: string, params?: Record<string, string | number>): Promise<T>;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAKA,qBAAa,YAAa,SAAQ,KAAK;aAEnB,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,MAAM;aAEZ,YAAY,CAAC,EAAE,MAAM;gBAHrB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,YAAY,CAAC,EAAE,MAAM,YAAA;CAKxC;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;gBAG7C,OAAO,GAAE,MAAiB,EAC1B,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM;IAOpB,OAAO,IAAI,OAAO;IAIlB,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,WAAW;IAWnB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;;;OAIG;YACW,cAAc;YA2Bd,cAAc;IActB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAoB1E,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAmBnD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;CAkBzD"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAKA,qBAAa,YAAa,SAAQ,KAAK;aAEnB,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,MAAM;aAEZ,YAAY,CAAC,EAAE,MAAM;gBAHrB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,YAAY,CAAC,EAAE,MAAM,YAAA;CAKxC;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;gBAG7C,OAAO,GAAE,MAAiB,EAC1B,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM;IAOpB,OAAO,IAAI,OAAO;IAIlB,OAAO,CAAC,aAAa,CAAK;IAE1B,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,WAAW;IAWnB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;;;OAIG;YACW,cAAc;YA2Bd,cAAc;IActB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAoB1E,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAmBnD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAmBlD,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAmBpF"}

package/dist/client.js

@@ -25,8 +25,9 @@ export class BudaClient {
     hasAuth() {
         return Boolean(this.apiKey && this.apiSecret);
     }
+    _nonceCounter = 0;
     nonce() {
-        return String(Math.floor(Date.now() * 1000));
+        return String(Date.now() * 1000 + (this._nonceCounter++ % 1000));
     }
     sign(method, pathWithQuery, body, nonce) {
         const encodedBody = body ? Buffer.from(body).toString("base64") : "";
@@ -135,5 +136,21 @@ export class BudaClient {
         const response = await this.fetchWithRetry(url, { method: "PUT", headers, body: bodyStr }, path);
         return this.handleResponse(response, path);
     }
+    async delete(path, params) {
+        const url = new URL(`${this.baseUrl}${path}.json`);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                url.searchParams.set(key, String(value));
+            }
+        }
+        const urlPath = url.pathname + url.search;
+        const headers = {
+            Accept: "application/json",
+            "User-Agent": `buda-mcp/${VERSION}`,
+            ...this.authHeaders("DELETE", urlPath),
+        };
+        const response = await this.fetchWithRetry(url, { method: "DELETE", headers }, path);
+        return this.handleResponse(response, path);
+    }
 }
 //# sourceMappingURL=client.js.map

package/dist/http.js

@@ -1,9 +1,11 @@
 import express from "express";
+import rateLimit from "express-rate-limit";
 import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { BudaClient } from "./client.js";
 import { MemoryCache, CACHE_TTL } from "./cache.js";
 import { VERSION } from "./version.js";
+import { validateMarketId } from "./validation.js";
 import * as markets from "./tools/markets.js";
 import * as ticker from "./tools/ticker.js";
 import * as orderbook from "./tools/orderbook.js";
@@ -23,6 +25,21 @@ import * as positionSize from "./tools/calculate_position_size.js";
 import * as marketSentiment from "./tools/market_sentiment.js";
 import * as technicalIndicators from "./tools/technical_indicators.js";
 import * as deadMansSwitch from "./tools/dead_mans_switch.js";
+import * as banks from "./tools/banks.js";
+import * as account from "./tools/account.js";
+import * as balance from "./tools/balance.js";
+import * as orderLookup from "./tools/order_lookup.js";
+import * as networkFees from "./tools/fees.js";
+import * as deposits from "./tools/deposits.js";
+import * as withdrawals from "./tools/withdrawals.js";
+import * as receiveAddresses from "./tools/receive_addresses.js";
+import * as remittances from "./tools/remittances.js";
+import * as remittanceRecipients from "./tools/remittance_recipients.js";
+import * as quotation from "./tools/quotation.js";
+import * as cancelAllOrders from "./tools/cancel_all_orders.js";
+import * as cancelOrderByClientId from "./tools/cancel_order_by_client_id.js";
+import * as batchOrders from "./tools/batch_orders.js";
+import * as lightning from "./tools/lightning.js";
 import { handleMarketSummary } from "./tools/market_summary.js";
 const PORT = parseInt(process.env.PORT ?? "3000", 10);
 const client = new BudaClient(undefined, process.env.BUDA_API_KEY, process.env.BUDA_API_SECRET);
@@ -41,9 +58,11 @@ const PUBLIC_TOOL_SCHEMAS = [
     arbitrage.toolSchema,
     marketSummary.toolSchema,
     simulateOrder.toolSchema,
+    quotation.toolSchema,
     positionSize.toolSchema,
     marketSentiment.toolSchema,
     technicalIndicators.toolSchema,
+    banks.toolSchema,
 ];
 const AUTH_TOOL_SCHEMAS = [
     balances.toolSchema,
@@ -53,6 +72,29 @@ const AUTH_TOOL_SCHEMAS = [
     deadMansSwitch.toolSchema,
     deadMansSwitch.renewToolSchema,
     deadMansSwitch.disarmToolSchema,
+    account.toolSchema,
+    balance.toolSchema,
+    orderLookup.getOrderToolSchema,
+    orderLookup.getOrderByClientIdToolSchema,
+    networkFees.toolSchema,
+    deposits.getDepositHistoryToolSchema,
+    withdrawals.getWithdrawalHistoryToolSchema,
+    receiveAddresses.listReceiveAddressesToolSchema,
+    receiveAddresses.getReceiveAddressToolSchema,
+    remittances.listRemittancesToolSchema,
+    remittances.getRemittanceToolSchema,
+    remittances.quoteRemittanceToolSchema,
+    remittances.acceptRemittanceQuoteToolSchema,
+    remittanceRecipients.listToolSchema,
+    remittanceRecipients.getToolSchema,
+    receiveAddresses.createReceiveAddressToolSchema,
+    cancelAllOrders.toolSchema,
+    cancelOrderByClientId.toolSchema,
+    batchOrders.toolSchema,
+    withdrawals.createWithdrawalToolSchema,
+    deposits.createFiatDepositToolSchema,
+    lightning.lightningWithdrawalToolSchema,
+    lightning.createLightningInvoiceToolSchema,
 ];
 function createServer() {
     const server = new McpServer({ name: "buda-mcp", version: VERSION });
@@ -69,15 +111,30 @@ function createServer() {
     arbitrage.register(server, client, reqCache);
     marketSummary.register(server, client, reqCache);
     simulateOrder.register(server, client, reqCache);
+    quotation.register(server, client);
     positionSize.register(server);
     marketSentiment.register(server, client, reqCache);
     technicalIndicators.register(server, client);
+    banks.register(server, client, reqCache);
     if (authEnabled) {
         balances.register(server, client);
         orders.register(server, client);
         placeOrder.register(server, client);
         cancelOrder.register(server, client);
-        deadMansSwitch.register(server, client);
+        deadMansSwitch.register(server, client, "http");
+        account.register(server, client);
+        balance.register(server, client);
+        orderLookup.register(server, client);
+        networkFees.register(server, client);
+        deposits.register(server, client);
+        withdrawals.register(server, client);
+        receiveAddresses.register(server, client);
+        remittances.register(server, client);
+        remittanceRecipients.register(server, client);
+        cancelAllOrders.register(server, client);
+        cancelOrderByClientId.register(server, client);
+        batchOrders.register(server, client);
+        lightning.register(server, client);
     }
     // MCP Resources
     server.resource("buda-markets", "buda://markets", async (uri) => {
@@ -93,7 +150,11 @@ function createServer() {
         };
     });
     server.resource("buda-ticker", new ResourceTemplate("buda://ticker/{market}", { list: undefined }), async (uri, params) => {
-        const marketId = params.market.toLowerCase();
+        const raw = params.market;
+        const validationError = validateMarketId(raw);
+        if (validationError)
+            throw new Error(validationError);
+        const marketId = raw.toLowerCase();
         const data = await reqCache.getOrFetch(`ticker:${marketId}`, CACHE_TTL.TICKER, () => client.get(`/markets/${marketId}/ticker`));
         return {
             contents: [
@@ -106,9 +167,13 @@ function createServer() {
         };
     });
     server.resource("buda-summary", new ResourceTemplate("buda://summary/{market}", { list: undefined }), async (uri, params) => {
-        const marketId = params.market.toUpperCase();
+        const raw = params.market;
+        const validationError = validateMarketId(raw);
+        if (validationError)
+            throw new Error(validationError);
+        const marketId = raw.toUpperCase();
         const result = await handleMarketSummary({ market_id: marketId }, client, reqCache);
-        const text = result.content[0].text;
+        const text = result.content[0]?.text ?? JSON.stringify({ error: "No content returned" });
         return {
             contents: [
                 {
@@ -123,6 +188,32 @@ function createServer() {
 }
 const app = express();
 app.use(express.json());
+const MCP_AUTH_TOKEN = process.env.MCP_AUTH_TOKEN;
+if (authEnabled && !MCP_AUTH_TOKEN) {
+    console.error("[buda-mcp] FATAL: BUDA_API_KEY/BUDA_API_SECRET are set but MCP_AUTH_TOKEN is not.\n" +
+        "  The /mcp endpoint would be publicly accessible with full account access.\n" +
+        "  Set MCP_AUTH_TOKEN to a long random secret, or run in stdio mode instead.");
+    process.exit(1);
+}
+const mcpRateLimiter = rateLimit({
+    windowMs: 60_000,
+    max: parseInt(process.env.MCP_RATE_LIMIT ?? "120", 10),
+    standardHeaders: true,
+    legacyHeaders: false,
+    message: { error: "Too many requests. Retry after 60 seconds.", code: "RATE_LIMITED" },
+});
+function mcpAuthMiddleware(req, res, next) {
+    if (!MCP_AUTH_TOKEN) {
+        next();
+        return;
+    }
+    const auth = req.headers.authorization ?? "";
+    if (auth !== `Bearer ${MCP_AUTH_TOKEN}`) {
+        res.status(401).json({ error: "Unauthorized" });
+        return;
+    }
+    next();
+}
 // Health check for Railway / uptime monitors
 app.get("/health", (_req, res) => {
     res.json({
@@ -148,7 +239,7 @@ app.get("/.well-known/mcp/server-card.json", (_req, res) => {
     });
 });
 // Stateless StreamableHTTP — new server instance per request (no session state needed)
-app.post("/mcp", async (req, res) => {
+app.post("/mcp", mcpRateLimiter, mcpAuthMiddleware, async (req, res) => {
     const transport = new StreamableHTTPServerTransport({
         sessionIdGenerator: undefined,
     });
@@ -160,7 +251,7 @@ app.post("/mcp", async (req, res) => {
     await transport.handleRequest(req, res, req.body);
 });
 // SSE upgrade for clients that prefer streaming
-app.get("/mcp", async (req, res) => {
+app.get("/mcp", mcpRateLimiter, mcpAuthMiddleware, async (req, res) => {
     const transport = new StreamableHTTPServerTransport({
         sessionIdGenerator: undefined,
     });

package/dist/index.js

@@ -5,6 +5,7 @@ import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { BudaClient } from "./client.js";
 import { cache, CACHE_TTL } from "./cache.js";
 import { VERSION } from "./version.js";
+import { validateMarketId } from "./validation.js";
 import * as markets from "./tools/markets.js";
 import * as ticker from "./tools/ticker.js";
 import * as orderbook from "./tools/orderbook.js";
@@ -24,6 +25,21 @@ import * as positionSize from "./tools/calculate_position_size.js";
 import * as marketSentiment from "./tools/market_sentiment.js";
 import * as technicalIndicators from "./tools/technical_indicators.js";
 import * as deadMansSwitch from "./tools/dead_mans_switch.js";
+import * as banks from "./tools/banks.js";
+import * as account from "./tools/account.js";
+import * as balance from "./tools/balance.js";
+import * as orderLookup from "./tools/order_lookup.js";
+import * as networkFees from "./tools/fees.js";
+import * as deposits from "./tools/deposits.js";
+import * as withdrawals from "./tools/withdrawals.js";
+import * as receiveAddresses from "./tools/receive_addresses.js";
+import * as remittances from "./tools/remittances.js";
+import * as remittanceRecipients from "./tools/remittance_recipients.js";
+import * as quotation from "./tools/quotation.js";
+import * as cancelAllOrders from "./tools/cancel_all_orders.js";
+import * as cancelOrderByClientId from "./tools/cancel_order_by_client_id.js";
+import * as batchOrders from "./tools/batch_orders.js";
+import * as lightning from "./tools/lightning.js";
 import { handleMarketSummary } from "./tools/market_summary.js";
 const client = new BudaClient(undefined, process.env.BUDA_API_KEY, process.env.BUDA_API_SECRET);
 const server = new McpServer({
@@ -42,9 +58,11 @@ priceHistory.register(server, client, cache);
 arbitrage.register(server, client, cache);
 marketSummary.register(server, client, cache);
 simulateOrder.register(server, client, cache);
+quotation.register(server, client);
 positionSize.register(server);
 marketSentiment.register(server, client, cache);
 technicalIndicators.register(server, client);
+banks.register(server, client, cache);
 // Auth-gated tools — only registered when API credentials are present
 if (client.hasAuth()) {
     balances.register(server, client);
@@ -52,6 +70,19 @@ if (client.hasAuth()) {
     placeOrder.register(server, client);
     cancelOrder.register(server, client);
     deadMansSwitch.register(server, client);
+    account.register(server, client);
+    balance.register(server, client);
+    orderLookup.register(server, client);
+    networkFees.register(server, client);
+    deposits.register(server, client);
+    withdrawals.register(server, client);
+    receiveAddresses.register(server, client);
+    remittances.register(server, client);
+    remittanceRecipients.register(server, client);
+    cancelAllOrders.register(server, client);
+    cancelOrderByClientId.register(server, client);
+    batchOrders.register(server, client);
+    lightning.register(server, client);
 }
 // MCP Resources
 server.resource("buda-markets", "buda://markets", async (uri) => {
@@ -67,7 +98,11 @@ server.resource("buda-markets", "buda://markets", async (uri) => {
     };
 });
 server.resource("buda-ticker", new ResourceTemplate("buda://ticker/{market}", { list: undefined }), async (uri, params) => {
-    const marketId = params.market.toLowerCase();
+    const raw = params.market;
+    const validationError = validateMarketId(raw);
+    if (validationError)
+        throw new Error(validationError);
+    const marketId = raw.toLowerCase();
     const data = await cache.getOrFetch(`ticker:${marketId}`, CACHE_TTL.TICKER, () => client.get(`/markets/${marketId}/ticker`));
     return {
         contents: [
@@ -80,9 +115,13 @@ server.resource("buda-ticker", new ResourceTemplate("buda://ticker/{market}", {
     };
 });
 server.resource("buda-summary", new ResourceTemplate("buda://summary/{market}", { list: undefined }), async (uri, params) => {
-    const marketId = params.market.toUpperCase();
+    const raw = params.market;
+    const validationError = validateMarketId(raw);
+    if (validationError)
+        throw new Error(validationError);
+    const marketId = raw.toUpperCase();
     const result = await handleMarketSummary({ market_id: marketId }, client, cache);
-    const text = result.content[0].text;
+    const text = result.content[0]?.text ?? JSON.stringify({ error: "No content returned" });
     return {
         contents: [
             {

package/dist/tools/account.d.ts

@@ -0,0 +1,19 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BudaClient } from "../client.js";
+export declare const toolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+    };
+};
+export declare function handleGetAccountInfo(client: BudaClient): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare function register(server: McpServer, client: BudaClient): void;
+//# sourceMappingURL=account.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../src/tools/account.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AAIxD,eAAO,MAAM,UAAU;;;;;;;CAYtB,CAAC;AAEF,wBAAsB,oBAAoB,CACxC,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,CAmChF;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAOpE"}

package/dist/tools/account.js

@@ -0,0 +1,49 @@
+import { BudaApiError } from "../client.js";
+import { flattenAmount } from "../utils.js";
+export const toolSchema = {
+    name: "get_account_info",
+    description: "Returns the authenticated user's profile on Buda.com. " +
+        "Fetches account details including email, display name, pubsub key, and monthly transacted amounts. " +
+        "Read-only; no side effects. " +
+        "Requires BUDA_API_KEY and BUDA_API_SECRET. " +
+        "Example: 'What is my account email and how much have I transacted this month?'",
+    inputSchema: {
+        type: "object",
+        properties: {},
+    },
+};
+export async function handleGetAccountInfo(client) {
+    try {
+        const data = await client.get("/me");
+        const me = data.me;
+        const monthly = flattenAmount(me.monthly_transacted);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        id: me.id,
+                        email: me.email,
+                        name: me.name ?? null,
+                        monthly_transacted: monthly.value,
+                        monthly_transacted_currency: monthly.currency,
+                        pubsub_key: me.pubsub_key ?? null,
+                    }, 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(toolSchema.name, toolSchema.description, {}, () => handleGetAccountInfo(client));
+}
+//# sourceMappingURL=account.js.map

package/dist/tools/balance.d.ts

@@ -0,0 +1,29 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BudaClient } from "../client.js";
+export declare const toolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            currency: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+type GetBalanceArgs = {
+    currency: string;
+};
+export declare function handleGetBalance(args: GetBalanceArgs, client: BudaClient): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare function register(server: McpServer, client: BudaClient): void;
+export {};
+//# sourceMappingURL=balance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"balance.d.ts","sourceRoot":"","sources":["../../src/tools/balance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AAKxD,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAiBtB,CAAC;AAEF,KAAK,cAAc,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,cAAc,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,CAmDhF;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CASpE"}

package/dist/tools/balance.js

@@ -0,0 +1,72 @@
+import { z } from "zod";
+import { BudaApiError } from "../client.js";
+import { validateCurrency } from "../validation.js";
+import { flattenAmount } from "../utils.js";
+export const toolSchema = {
+    name: "get_balance",
+    description: "Returns the balance for a single currency for the authenticated Buda.com account. " +
+        "Fetches total, available, frozen, and pending-withdrawal amounts as floats with separate _currency fields. " +
+        "Requires BUDA_API_KEY and BUDA_API_SECRET. " +
+        "Example: 'How much ETH do I have available?'",
+    inputSchema: {
+        type: "object",
+        properties: {
+            currency: {
+                type: "string",
+                description: "Currency code (e.g. 'BTC', 'CLP', 'USDC').",
+            },
+        },
+        required: ["currency"],
+    },
+};
+export async function handleGetBalance(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(`/balances/${currency.toUpperCase()}`);
+        const b = data.balance;
+        const amount = flattenAmount(b.amount);
+        const available = flattenAmount(b.available_amount);
+        const frozen = flattenAmount(b.frozen_amount);
+        const pending = flattenAmount(b.pending_withdraw_amount);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        id: b.id,
+                        amount: amount.value,
+                        amount_currency: amount.currency,
+                        available_amount: available.value,
+                        available_amount_currency: available.currency,
+                        frozen_amount: frozen.value,
+                        frozen_amount_currency: frozen.currency,
+                        pending_withdraw_amount: pending.value,
+                        pending_withdraw_amount_currency: pending.currency,
+                    }, 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(toolSchema.name, toolSchema.description, {
+        currency: z.string().min(2).max(10).describe("Currency code (e.g. 'BTC', 'CLP', 'USDC')."),
+    }, (args) => handleGetBalance(args, client));
+}
+//# sourceMappingURL=balance.js.map

package/dist/tools/banks.d.ts

@@ -0,0 +1,28 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BudaClient } from "../client.js";
+import { MemoryCache } from "../cache.js";
+export declare const toolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            currency: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleGetAvailableBanks(args: {
+    currency: string;
+}, client: BudaClient, cache: MemoryCache): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare function register(server: McpServer, client: BudaClient, cache: MemoryCache): void;
+//# sourceMappingURL=banks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"banks.d.ts","sourceRoot":"","sources":["../../src/tools/banks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAIrD,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAkBtB,CAAC;AAEF,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,EAC1B,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,WAAW,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,CAmDhF;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CASxF"}

package/dist/tools/banks.js

@@ -0,0 +1,68 @@
+import { z } from "zod";
+import { BudaApiError } from "../client.js";
+import { CACHE_TTL } from "../cache.js";
+import { validateCurrency } from "../validation.js";
+export const toolSchema = {
+    name: "get_available_banks",
+    description: "Returns banks available for deposits and withdrawals of a fiat currency on Buda.com. " +
+        "Returns an empty banks array (not an error) if the currency has no associated banks " +
+        "(e.g. crypto currencies or unsupported fiat currencies). " +
+        "Results are cached for 60 seconds. " +
+        "Example: 'Which banks can I use for CLP deposits?'",
+    inputSchema: {
+        type: "object",
+        properties: {
+            currency: {
+                type: "string",
+                description: "Currency code (e.g. 'CLP', 'COP', 'PEN').",
+            },
+        },
+        required: ["currency"],
+    },
+};
+export async function handleGetAvailableBanks(args, client, cache) {
+    const { currency } = args;
+    const validationError = validateCurrency(currency);
+    if (validationError) {
+        return {
+            content: [{ type: "text", text: JSON.stringify({ error: validationError, code: "INVALID_CURRENCY" }) }],
+            isError: true,
+        };
+    }
+    const currencyUpper = currency.toUpperCase();
+    try {
+        const data = await cache.getOrFetch(`banks:${currencyUpper}`, CACHE_TTL.BANKS, () => client.get(`/currencies/${currencyUpper}/banks`));
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        currency: currencyUpper,
+                        banks: data.banks.map((b) => ({ id: b.id, name: b.name, country: b.country ?? null })),
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        // 404 means no banks exist for this currency — return empty list (not an error)
+        if (err instanceof BudaApiError && err.status === 404) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ currency: currencyUpper, banks: [] }, null, 2) }],
+            };
+        }
+        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, cache) {
+    server.tool(toolSchema.name, toolSchema.description, {
+        currency: z.string().min(2).max(10).describe("Currency code (e.g. 'CLP', 'COP', 'PEN')."),
+    }, (args) => handleGetAvailableBanks(args, client, cache));
+}
+//# sourceMappingURL=banks.js.map