@guiie/buda-mcp 1.4.2 → 1.5.0

package/CHANGELOG.md

@@ -7,6 +7,45 @@ This project uses [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [1.5.0] – 2026-04-11
+
+### Added
+
+- **`cancel_all_orders`** (`src/tools/cancel_all_orders.ts`) — auth-gated tool to cancel all open orders in a specific market or across all markets (`market_id="*"`). Confirmation guard fires before market validation or API call. Uses new `DELETE /orders` endpoint via `client.delete<T>()`. Exports `handleCancelAllOrders` for unit testing.
+
+- **`cancel_order_by_client_id`** (`src/tools/cancel_order_by_client_id.ts`) — auth-gated tool to cancel an open order by its client-assigned string ID (`PUT /orders/by-client-id/{client_id}`). Confirmation guard first; returns the same flat order shape as `get_order`. Exports `handleCancelOrderByClientId` for unit testing.
+
+- **`place_batch_orders`** (`src/tools/batch_orders.ts`) — auth-gated tool to place up to 20 orders sequentially. Pre-validates **all** orders (market ID format + `limit_price` presence) before any API call — a single validation failure aborts with zero orders placed. API failures mid-batch do not roll back placed orders; a `warning` field surfaces this. Returns `{ results, total, succeeded, failed, warning? }`. Exports `handlePlaceBatchOrders` for unit testing.
+
+- **`place_order` extended (optional TIF + stop fields)** — backward-compatible additions:
+  - **Time-in-force flags**: `ioc` (immediate-or-cancel), `fok` (fill-or-kill), `post_only`, `gtd_timestamp` (ISO 8601 expiry). Mutually exclusive — specifying more than one returns `VALIDATION_ERROR`.
+  - **Stop orders**: `stop_price` + `stop_type` (`">="` or `"<="`) — both must be present together or both absent, otherwise `VALIDATION_ERROR`.
+  - All validation happens after the confirmation guard but before the API call.
+
+- **`create_withdrawal`** (added to `src/tools/withdrawals.ts`) — auth-gated `POST /currencies/{currency}/withdrawals`. Supports crypto (via `address` + optional `network`) and fiat (via `bank_account_id`). Exactly one destination must be provided; both or neither → `VALIDATION_ERROR`. Confirmation guard preview includes `{ currency, amount, destination }`. Returns flat `Withdrawal` shape. Exports `handleCreateWithdrawal` and `createWithdrawalToolSchema`.
+
+- **`create_fiat_deposit`** (added to `src/tools/deposits.ts`) — auth-gated `POST /currencies/{currency}/deposits`. Guard is critical — calling twice creates duplicate records. Validates currency before API call. Returns flat `Deposit` shape. Exports `handleCreateFiatDeposit` and `createFiatDepositToolSchema`.
+
+- **`lightning_withdrawal`** + **`create_lightning_invoice`** (`src/tools/lightning.ts`) — two auth-gated Lightning Network tools:
+  - `lightning_withdrawal` — pays a BOLT-11 invoice from the LN-BTC reserve (`POST /reserves/ln-btc/withdrawals`). Confirmation guard truncates the invoice in the preview (`invoice_preview: first 20 chars + "..."`). Returns `{ id, state, amount, amount_currency, fee, fee_currency, payment_hash, created_at }`.
+  - `create_lightning_invoice` — creates a receive invoice (`POST /lightning_network_invoices`). No confirmation required. Inputs: `amount_satoshis`, optional `description` (max 140 chars), optional `expiry_seconds` (60–86400). Returns `{ id, payment_request, amount_satoshis, description, expires_at, state, created_at }`.
+
+- **`delete<T>()` on `BudaClient`** (`src/client.ts`) — follows the same HMAC auth headers + 429 retry pattern as `put<T>()`. Supports optional query params.
+
+- **New types** in `src/types.ts`: `CancelAllOrdersResponse`, `LightningWithdrawal`, `LightningWithdrawalResponse`, `LightningInvoice`, `LightningInvoiceResponse`.
+
+- **Unit tests (32 new, 138 total)** in `test/unit.ts`:
+  - `cancel_all_orders` (5 tests): no confirmation; `*` + CONFIRM; specific market + CONFIRM; invalid market with CONFIRM; 404 passthrough.
+  - `cancel_order_by_client_id` (3 tests): no confirmation; happy path with flat order; 404 passthrough.
+  - `place_batch_orders` (5 tests): no confirmation; all valid; invalid market pre-validation; missing limit_price pre-validation; mid-batch API error partial success.
+  - `place_order extended` (4 tests): existing limit order unchanged; IOC → `limit.type='ioc'`; stop_price without stop_type; mutually exclusive TIF flags.
+  - `create_withdrawal` (6 tests): no confirmation; both address+bank_account_id; neither; crypto path; fiat path; 422 passthrough.
+  - `create_fiat_deposit` (4 tests): no confirmation; invalid currency; happy path; 422 passthrough.
+  - `lightning_withdrawal` (3 tests): no confirmation with preview; happy path; 422 passthrough.
+  - `create_lightning_invoice` (2 tests): happy path; 422 passthrough.
+
+---
+
 ## [1.4.2] – 2026-04-11
 
 ### Added

package/dist/cache.d.ts

@@ -9,6 +9,7 @@ export declare const CACHE_TTL: {
     readonly MARKETS: 60000;
     readonly TICKER: 5000;
     readonly ORDERBOOK: 3000;
+    readonly BANKS: 60000;
 };
 export declare const cache: MemoryCache;
 //# sourceMappingURL=cache.d.ts.map

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

@@ -29,5 +29,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,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

@@ -135,5 +135,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

@@ -23,6 +23,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 +56,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 +70,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 +109,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);
+        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) => {

package/dist/index.js

@@ -24,6 +24,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 +57,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 +69,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) => {

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

package/dist/tools/batch_orders.d.ts

@@ -0,0 +1,77 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { BudaClient } from "../client.js";
+export declare const toolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            orders: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                    properties: {
+                        market_id: {
+                            type: string;
+                            description: string;
+                        };
+                        type: {
+                            type: string;
+                            enum: string[];
+                            description: string;
+                        };
+                        price_type: {
+                            type: string;
+                            enum: string[];
+                            description: string;
+                        };
+                        amount: {
+                            type: string;
+                            description: string;
+                        };
+                        limit_price: {
+                            type: string;
+                            description: string;
+                        };
+                    };
+                    required: string[];
+                };
+            };
+            confirmation_token: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+declare const orderShape: z.ZodObject<{
+    market_id: z.ZodString;
+    type: z.ZodEnum<{
+        Bid: "Bid";
+        Ask: "Ask";
+    }>;
+    price_type: z.ZodEnum<{
+        limit: "limit";
+        market: "market";
+    }>;
+    amount: z.ZodNumber;
+    limit_price: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type SingleOrderInput = z.infer<typeof orderShape>;
+type BatchOrdersArgs = {
+    orders: SingleOrderInput[];
+    confirmation_token: string;
+};
+export declare function handlePlaceBatchOrders(args: BatchOrdersArgs, client: BudaClient): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare function register(server: McpServer, client: BudaClient): void;
+export {};
+//# sourceMappingURL=batch_orders.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"batch_orders.d.ts","sourceRoot":"","sources":["../../src/tools/batch_orders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AAIxD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCtB,CAAC;AAEF,QAAA,MAAM,UAAU;;;;;;;;;;;;iBAMd,CAAC;AAEH,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAWnD,KAAK,eAAe,GAAG;IACrB,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,eAAe,EACrB,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,CA6GhF;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAkBpE"}