@guiie/buda-mcp 1.4.2 → 1.5.0

package/dist/tools/withdrawals.js

@@ -0,0 +1,215 @@
+import { z } from "zod";
+import { BudaApiError } from "../client.js";
+import { validateCurrency } from "../validation.js";
+import { flattenAmount } from "../utils.js";
+export const getWithdrawalHistoryToolSchema = {
+    name: "get_withdrawal_history",
+    description: "Returns withdrawal history for a currency on the authenticated Buda.com account. " +
+        "Supports state filtering and pagination. All amounts are floats with separate _currency fields. " +
+        "Requires BUDA_API_KEY and BUDA_API_SECRET. " +
+        "Example: 'Show my pending CLP withdrawals.'",
+    inputSchema: {
+        type: "object",
+        properties: {
+            currency: {
+                type: "string",
+                description: "Currency code (e.g. 'BTC', 'CLP').",
+            },
+            state: {
+                type: "string",
+                description: "Filter by state: 'pending_signature', 'pending', 'confirmed', 'rejected', 'anulled'.",
+            },
+            per: {
+                type: "number",
+                description: "Results per page (default: 20, max: 300).",
+            },
+            page: {
+                type: "number",
+                description: "Page number (default: 1).",
+            },
+        },
+        required: ["currency"],
+    },
+};
+function normalizeWithdrawal(w) {
+    const amount = flattenAmount(w.amount);
+    const fee = flattenAmount(w.fee);
+    return {
+        id: w.id,
+        state: w.state,
+        currency: w.currency,
+        amount: amount.value,
+        amount_currency: amount.currency,
+        fee: fee.value,
+        fee_currency: fee.currency,
+        address: w.address,
+        tx_hash: w.tx_hash,
+        bank_account_id: w.bank_account_id,
+        created_at: w.created_at,
+        updated_at: w.updated_at,
+    };
+}
+export async function handleGetWithdrawalHistory(args, client) {
+    const { currency, state, per, page } = args;
+    const validationError = validateCurrency(currency);
+    if (validationError) {
+        return {
+            content: [{ type: "text", text: JSON.stringify({ error: validationError, code: "INVALID_CURRENCY" }) }],
+            isError: true,
+        };
+    }
+    try {
+        const params = {};
+        if (state)
+            params.state = state;
+        if (per !== undefined)
+            params.per = per;
+        if (page !== undefined)
+            params.page = page;
+        const data = await client.get(`/currencies/${currency.toUpperCase()}/withdrawals`, Object.keys(params).length > 0 ? params : undefined);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        withdrawals: data.withdrawals.map(normalizeWithdrawal),
+                        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 const createWithdrawalToolSchema = {
+    name: "create_withdrawal",
+    description: "Create a withdrawal on Buda.com. Supports both crypto (address) and fiat (bank_account_id) withdrawals. " +
+        "Exactly one of address or bank_account_id must be provided. " +
+        "IMPORTANT: Pass confirmation_token='CONFIRM' to execute. " +
+        "Requires BUDA_API_KEY and BUDA_API_SECRET.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            currency: { type: "string", description: "Currency code (e.g. 'BTC', 'CLP')." },
+            amount: { type: "number", description: "Withdrawal amount." },
+            address: { type: "string", description: "Destination crypto address. Mutually exclusive with bank_account_id." },
+            network: { type: "string", description: "Blockchain network for crypto withdrawals (e.g. 'bitcoin', 'ethereum')." },
+            bank_account_id: { type: "number", description: "Fiat bank account ID. Mutually exclusive with address." },
+            confirmation_token: {
+                type: "string",
+                description: "Safety confirmation. Must equal exactly 'CONFIRM' (case-sensitive) to execute.",
+            },
+        },
+        required: ["currency", "amount", "confirmation_token"],
+    },
+};
+export async function handleCreateWithdrawal(args, client) {
+    const { currency, amount, address, network, bank_account_id, confirmation_token } = args;
+    if (confirmation_token !== "CONFIRM") {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        error: "Withdrawal not created. confirmation_token must equal 'CONFIRM' to execute. " +
+                            "Review the details and set confirmation_token='CONFIRM' to proceed.",
+                        code: "CONFIRMATION_REQUIRED",
+                        preview: { currency, amount, destination: address ?? bank_account_id },
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    const hasAddress = address !== undefined;
+    const hasBankAccount = bank_account_id !== undefined;
+    if (hasAddress && hasBankAccount) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        error: "Provide either address (crypto) or bank_account_id (fiat), not both.",
+                        code: "VALIDATION_ERROR",
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    if (!hasAddress && !hasBankAccount) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        error: "Either address (crypto) or bank_account_id (fiat) must be provided.",
+                        code: "VALIDATION_ERROR",
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    const validationError = validateCurrency(currency);
+    if (validationError) {
+        return {
+            content: [{ type: "text", text: JSON.stringify({ error: validationError, code: "INVALID_CURRENCY" }) }],
+            isError: true,
+        };
+    }
+    try {
+        const payload = { amount: String(amount) };
+        if (hasAddress) {
+            payload.address = address;
+            if (network)
+                payload.network = network;
+        }
+        else {
+            payload.bank_account_id = bank_account_id;
+        }
+        const data = await client.post(`/currencies/${currency.toUpperCase()}/withdrawals`, payload);
+        return {
+            content: [{ type: "text", text: JSON.stringify(normalizeWithdrawal(data.withdrawal), 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(getWithdrawalHistoryToolSchema.name, getWithdrawalHistoryToolSchema.description, {
+        currency: z.string().min(2).max(10).describe("Currency code (e.g. 'BTC', 'CLP')."),
+        state: z
+            .enum(["pending_signature", "pending", "confirmed", "rejected", "anulled"])
+            .optional()
+            .describe("Filter by state."),
+        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) => handleGetWithdrawalHistory(args, client));
+    server.tool(createWithdrawalToolSchema.name, createWithdrawalToolSchema.description, {
+        currency: z.string().min(2).max(10).describe("Currency code (e.g. 'BTC', 'CLP')."),
+        amount: z.number().positive().describe("Withdrawal amount."),
+        address: z.string().optional().describe("Destination crypto address. Mutually exclusive with bank_account_id."),
+        network: z.string().optional().describe("Blockchain network for crypto withdrawals (e.g. 'bitcoin', 'ethereum')."),
+        bank_account_id: z.number().int().positive().optional().describe("Fiat bank account ID. Mutually exclusive with address."),
+        confirmation_token: z
+            .string()
+            .describe("Safety confirmation. Must equal exactly 'CONFIRM' (case-sensitive) to execute."),
+    }, (args) => handleCreateWithdrawal(args, client));
+}
+//# sourceMappingURL=withdrawals.js.map

package/dist/types.d.ts

@@ -108,4 +108,159 @@ export interface OhlcvCandle {
     volume: number;
     trade_count: number;
 }
+export interface PaginationMeta {
+    current_page: number;
+    total_count: number;
+    total_pages: number;
+}
+export interface MeResponse {
+    me: {
+        id: number;
+        email: string;
+        name: string | null;
+        monthly_transacted: Amount;
+        pubsub_key: string | null;
+    };
+}
+export interface SingleBalanceResponse {
+    balance: Balance;
+}
+export interface Fee {
+    name: string;
+    fee_type: string;
+    base_fee: Amount;
+    percent: string | null;
+}
+export interface FeesResponse {
+    fees: Fee[];
+}
+export interface Deposit {
+    id: number;
+    state: string;
+    currency: string;
+    amount: Amount;
+    fee: Amount;
+    created_at: string;
+    updated_at: string;
+    transfer_account_id: number | null;
+    transaction_hash: string | null;
+}
+export interface DepositsResponse {
+    deposits: Deposit[];
+    meta: PaginationMeta;
+}
+export interface SingleDepositResponse {
+    deposit: Deposit;
+}
+export interface Withdrawal {
+    id: number;
+    state: string;
+    currency: string;
+    amount: Amount;
+    fee: Amount;
+    address: string | null;
+    tx_hash: string | null;
+    bank_account_id: number | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface WithdrawalsResponse {
+    withdrawals: Withdrawal[];
+    meta: PaginationMeta;
+}
+export interface SingleWithdrawalResponse {
+    withdrawal: Withdrawal;
+}
+export interface ReceiveAddress {
+    id: number;
+    address: string;
+    currency: string;
+    created_at: string;
+    label: string | null;
+}
+export interface ReceiveAddressesResponse {
+    receive_addresses: ReceiveAddress[];
+}
+export interface SingleReceiveAddressResponse {
+    receive_address: ReceiveAddress;
+}
+export interface Remittance {
+    id: number;
+    state: string;
+    currency: string;
+    amount: Amount;
+    recipient_id: number | null;
+    created_at: string;
+    expires_at: string | null;
+}
+export interface RemittancesResponse {
+    remittances: Remittance[];
+    meta: PaginationMeta;
+}
+export interface SingleRemittanceResponse {
+    remittance: Remittance;
+}
+export interface RemittanceRecipient {
+    id: number;
+    name: string;
+    bank: string;
+    account_number: string;
+    currency: string;
+    country: string | null;
+}
+export interface RemittanceRecipientsResponse {
+    remittance_recipients: RemittanceRecipient[];
+    meta: PaginationMeta;
+}
+export interface SingleRemittanceRecipientResponse {
+    remittance_recipient: RemittanceRecipient;
+}
+export interface Quotation {
+    id: number | null;
+    type: string;
+    market_id: string;
+    amount: Amount;
+    limit: Amount | null;
+    base_balance_change: Amount;
+    quote_balance_change: Amount;
+    fee_amount: Amount;
+    order_amount: Amount;
+}
+export interface QuotationResponse {
+    quotation: Quotation;
+}
+export interface Bank {
+    id: string;
+    name: string;
+    country: string | null;
+}
+export interface BanksResponse {
+    banks: Bank[];
+}
+export interface CancelAllOrdersResponse {
+    canceled_count: number;
+}
+export interface LightningWithdrawal {
+    id: number;
+    state: string;
+    amount: Amount;
+    fee: Amount;
+    payment_hash: string;
+    created_at: string;
+}
+export interface LightningWithdrawalResponse {
+    lightning_withdrawal: LightningWithdrawal;
+}
+export interface LightningInvoice {
+    id: number;
+    payment_request: string;
+    amount: Amount;
+    description: string | null;
+    expires_at: string;
+    state: string;
+    created_at: string;
+}
+export interface LightningInvoiceResponse {
+    lightning_network_invoice: LightningInvoice;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/validation.d.ts

@@ -3,4 +3,9 @@
  * Returns an error message string if invalid, or null if valid.
  */
 export declare function validateMarketId(id: string): string | null;
+/**
+ * Validates a currency code (e.g. "BTC", "CLP", "USDC").
+ * Returns an error message string if invalid, or null if valid.
+ */
+export declare function validateCurrency(id: string): string | null;
 //# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS1D"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS1D;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ1D"}

package/dist/validation.js

@@ -11,4 +11,16 @@ export function validateMarketId(id) {
     }
     return null;
 }
+const CURRENCY_RE = /^[A-Z0-9]{2,10}$/i;
+/**
+ * Validates a currency code (e.g. "BTC", "CLP", "USDC").
+ * Returns an error message string if invalid, or null if valid.
+ */
+export function validateCurrency(id) {
+    if (!CURRENCY_RE.test(id)) {
+        return (`Invalid currency "${id}". ` +
+            `Expected 2–10 alphanumeric characters (e.g. "BTC", "CLP", "USDC").`);
+    }
+    return null;
+}
 //# sourceMappingURL=validation.js.map

package/marketplace/README.md

@@ -1,4 +1,4 @@
-# Marketplace Submission Assets — v1.4.0
+# Marketplace Submission Assets — v1.5.0
 
 Ready-to-use assets for submitting buda-mcp to every major AI marketplace.
 Replace `gtorreal` / `gtorreal` with your actual handles before submitting.

package/marketplace/claude-listing.md

@@ -12,9 +12,9 @@
 
 Real-time market data from [Buda.com](https://www.buda.com/), the leading cryptocurrency exchange operating in Chile, Colombia, and Peru. All public data is sourced from Buda's public REST API v2 — no API key required.
 
-Use this server to query live prices, spreads, order books, OHLCV candles, trade history, volume, and cross-market arbitrage opportunities for all BTC, ETH, and altcoin markets quoted in CLP, COP, PEN, and USDC. Optional API credentials unlock account tools for balances and order management.
+Use this server to query live prices, spreads, order books, OHLCV candles, trade history, volume, and cross-market arbitrage opportunities for all BTC, ETH, and altcoin markets quoted in CLP, COP, PEN, and USDC. Optional API credentials unlock account tools for balances, order management, withdrawals, deposits, and Lightning Network payments.
 
-**v1.4.0** adds 5 new tools: `simulate_order`, `calculate_position_size`, `get_market_sentiment`, `get_technical_indicators`, and a dead man's switch (`schedule_cancel_all` + `renew_cancel_timer` + `disarm_cancel_timer`). All response schemas are flat and fully typed.
+**v1.5.0** adds 8 new authenticated tools: `cancel_all_orders`, `cancel_order_by_client_id`, `place_batch_orders`, extended `place_order` (TIF + stop), `create_withdrawal`, `create_fiat_deposit`, `lightning_withdrawal`, and `create_lightning_invoice`. All response schemas are flat and fully typed.
 
 ---
 
@@ -97,6 +97,34 @@ Place a limit or market order. Requires `confirmation_token="CONFIRM"` to preven
 Cancel an open order by ID. Requires `confirmation_token="CONFIRM"`.  
 **Parameters:** `order_id`, `confirmation_token`.
 
+### `cancel_all_orders`
+Cancel all open orders in a specific market or across all markets (`market_id="*"`). Requires `confirmation_token="CONFIRM"`. Market validation fires before any API call.  
+**Parameters:** `market_id` (or `"*"` for all), `confirmation_token`.
+
+### `cancel_order_by_client_id`
+Cancel an open order by its client-assigned string ID. Requires `confirmation_token="CONFIRM"`. Returns the same flat order shape as `get_order`.  
+**Parameters:** `client_id`, `confirmation_token`.
+
+### `place_batch_orders`
+Place up to 20 orders sequentially. All orders are pre-validated before any API call. Partial failures do not roll back placed orders; a `warning` field surfaces this. Returns `{ results, total, succeeded, failed }`.  
+**Parameters:** `orders` (array of 1–20 order objects), `confirmation_token`.
+
+### `create_withdrawal`
+Create a crypto or fiat withdrawal. Exactly one of `address` (crypto) or `bank_account_id` (fiat) must be provided. Requires `confirmation_token="CONFIRM"`.  
+**Parameters:** `currency`, `amount`, `address` *(crypto)*, `network` *(optional)*, `bank_account_id` *(fiat)*, `confirmation_token`.
+
+### `create_fiat_deposit`
+Record a fiat deposit. Guard is critical — calling twice creates duplicates. Requires `confirmation_token="CONFIRM"`.  
+**Parameters:** `currency`, `amount`, `bank` *(optional)*, `confirmation_token`.
+
+### `lightning_withdrawal`
+Pay a BOLT-11 Lightning invoice from the LN-BTC reserve. Requires `confirmation_token="CONFIRM"`. Returns `{ id, state, amount, fee, payment_hash, created_at }`.  
+**Parameters:** `invoice`, `confirmation_token`.
+
+### `create_lightning_invoice`
+Create a Lightning receive invoice. No confirmation required. Returns `{ id, payment_request, amount_satoshis, description, expires_at, state, created_at }`.  
+**Parameters:** `amount_satoshis`, `description` *(optional, max 140 chars)*, `expiry_seconds` *(optional, 60–86400)*.
+
 ### `schedule_cancel_all`
 **WARNING: timer state is lost on server restart. Use only on locally-run instances.**  
 Arms an in-memory dead man's switch: if not renewed within `ttl_seconds`, all open orders for the market are automatically cancelled. Requires `confirmation_token="CONFIRM"`.  

package/marketplace/gemini-tools.json

@@ -1,5 +1,5 @@
 {
-  "_comment": "Gemini function declarations for buda-mcp v1.4.0. Pass this array as the `tools[0].functionDeclarations` field when calling the Gemini API. See: https://ai.google.dev/gemini-api/docs/function-calling",
+  "_comment": "Gemini function declarations for buda-mcp v1.5.0. Pass this array as the `tools[0].functionDeclarations` field when calling the Gemini API. See: https://ai.google.dev/gemini-api/docs/function-calling",
   "functionDeclarations": [
     {
       "name": "get_markets",
@@ -393,6 +393,160 @@
         },
         "required": ["order_id", "confirmation_token"]
       }
+    },
+    {
+      "name": "cancel_all_orders",
+      "description": "Cancels all open orders on Buda.com, optionally filtered by market. Pass market_id='*' to cancel across all markets. IMPORTANT: Requires confirmation_token='CONFIRM'. Auth-gated.",
+      "parameters": {
+        "type": "OBJECT",
+        "properties": {
+          "market_id": {
+            "type": "STRING",
+            "description": "Market ID (e.g. 'BTC-CLP') or '*' to cancel orders across all markets."
+          },
+          "confirmation_token": {
+            "type": "STRING",
+            "description": "Safety confirmation. Must equal exactly 'CONFIRM' (case-sensitive) to execute."
+          }
+        },
+        "required": ["market_id", "confirmation_token"]
+      }
+    },
+    {
+      "name": "cancel_order_by_client_id",
+      "description": "Cancels an open order by its client-assigned string ID on Buda.com. IMPORTANT: Requires confirmation_token='CONFIRM'. Auth-gated.",
+      "parameters": {
+        "type": "OBJECT",
+        "properties": {
+          "client_id": {
+            "type": "STRING",
+            "description": "The client ID string assigned when placing the order."
+          },
+          "confirmation_token": {
+            "type": "STRING",
+            "description": "Safety confirmation. Must equal exactly 'CONFIRM' (case-sensitive) to execute."
+          }
+        },
+        "required": ["client_id", "confirmation_token"]
+      }
+    },
+    {
+      "name": "place_batch_orders",
+      "description": "Places up to 20 orders sequentially on Buda.com. All orders are pre-validated before any API call. Partial failures do not roll back placed orders. IMPORTANT: Requires confirmation_token='CONFIRM'. Auth-gated.",
+      "parameters": {
+        "type": "OBJECT",
+        "properties": {
+          "orders": {
+            "type": "ARRAY",
+            "description": "Array of 1–20 orders to place. Each order: market_id, type (Bid/Ask), price_type (limit/market), amount, optional limit_price."
+          },
+          "confirmation_token": {
+            "type": "STRING",
+            "description": "Safety confirmation. Must equal exactly 'CONFIRM' (case-sensitive) to execute."
+          }
+        },
+        "required": ["orders", "confirmation_token"]
+      }
+    },
+    {
+      "name": "create_withdrawal",
+      "description": "Creates a crypto or fiat withdrawal on Buda.com. Exactly one of address (crypto) or bank_account_id (fiat) must be provided. IMPORTANT: Requires confirmation_token='CONFIRM'. Auth-gated.",
+      "parameters": {
+        "type": "OBJECT",
+        "properties": {
+          "currency": {
+            "type": "STRING",
+            "description": "Currency code (e.g. 'BTC', 'CLP')."
+          },
+          "amount": {
+            "type": "NUMBER",
+            "description": "Withdrawal amount."
+          },
+          "address": {
+            "type": "STRING",
+            "description": "Destination crypto address. Mutually exclusive with bank_account_id."
+          },
+          "network": {
+            "type": "STRING",
+            "description": "Blockchain network (e.g. 'bitcoin', 'ethereum'). Optional."
+          },
+          "bank_account_id": {
+            "type": "INTEGER",
+            "description": "Fiat bank account ID. Mutually exclusive with address."
+          },
+          "confirmation_token": {
+            "type": "STRING",
+            "description": "Safety confirmation. Must equal exactly 'CONFIRM' (case-sensitive) to execute."
+          }
+        },
+        "required": ["currency", "amount", "confirmation_token"]
+      }
+    },
+    {
+      "name": "create_fiat_deposit",
+      "description": "Records a fiat deposit on Buda.com. IMPORTANT: Calling twice creates duplicate records. Requires confirmation_token='CONFIRM'. Auth-gated.",
+      "parameters": {
+        "type": "OBJECT",
+        "properties": {
+          "currency": {
+            "type": "STRING",
+            "description": "Fiat currency code (e.g. 'CLP', 'COP', 'PEN')."
+          },
+          "amount": {
+            "type": "NUMBER",
+            "description": "Deposit amount."
+          },
+          "bank": {
+            "type": "STRING",
+            "description": "Bank name or identifier for the deposit source. Optional."
+          },
+          "confirmation_token": {
+            "type": "STRING",
+            "description": "Safety confirmation. Must equal exactly 'CONFIRM' (case-sensitive) to execute."
+          }
+        },
+        "required": ["currency", "amount", "confirmation_token"]
+      }
+    },
+    {
+      "name": "lightning_withdrawal",
+      "description": "Pays a Bitcoin Lightning Network BOLT-11 invoice from the Buda.com LN-BTC reserve. Funds leave immediately on success. IMPORTANT: Requires confirmation_token='CONFIRM'. Auth-gated.",
+      "parameters": {
+        "type": "OBJECT",
+        "properties": {
+          "invoice": {
+            "type": "STRING",
+            "description": "BOLT-11 Lightning invoice string (starts with 'lnbc', 'lntb', etc.)."
+          },
+          "confirmation_token": {
+            "type": "STRING",
+            "description": "Safety confirmation. Must equal exactly 'CONFIRM' (case-sensitive) to execute."
+          }
+        },
+        "required": ["invoice", "confirmation_token"]
+      }
+    },
+    {
+      "name": "create_lightning_invoice",
+      "description": "Creates a Bitcoin Lightning Network receive invoice on Buda.com. No confirmation required — no funds leave the account. Auth-gated.",
+      "parameters": {
+        "type": "OBJECT",
+        "properties": {
+          "amount_satoshis": {
+            "type": "INTEGER",
+            "description": "Invoice amount in satoshis (positive integer)."
+          },
+          "description": {
+            "type": "STRING",
+            "description": "Optional payment description (max 140 characters)."
+          },
+          "expiry_seconds": {
+            "type": "INTEGER",
+            "description": "Invoice expiry in seconds (60–86400). Default: 3600."
+          }
+        },
+        "required": ["amount_satoshis"]
+      }
     }
   ]
 }

package/marketplace/openapi.yaml

@@ -14,7 +14,7 @@ info:
     stdio server. Deploy locally with mcp-proxy:
       mcp-proxy --port 8000 -- npx -y @guiie/buda-mcp
     Or point `servers[0].url` at your hosted instance.
-  version: 1.4.1
+  version: 1.5.0
   contact:
     url: https://github.com/gtorreal/buda-mcp
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guiie/buda-mcp",
-  "version": "1.4.2",
+  "version": "1.5.0",
   "mcpName": "io.github.gtorreal/buda-mcp",
   "description": "MCP server for Buda.com's public cryptocurrency exchange API (Chile, Colombia, Peru)",
   "type": "module",