@definitive-fi/mcp 1.1.2 → 1.2.1

package/dist/server.js

@@ -76,16 +76,28 @@ function createClient(baseUrl, apiKey, apiSecret) {
         };
       }
       if (!response.ok) {
+        const issues = validationIssues(response.status, json);
         return {
           error: true,
           status_code: response.status,
-          message: typeof json === "object" && json !== null && "message" in json ? String(json.message) : response.statusText
+          message: typeof json === "object" && json !== null && "message" in json ? String(json.message) : response.statusText,
+          ...issues && { details: issues }
         };
       }
       return json;
     }
   };
 }
+function validationIssues(status, json) {
+  if (status !== 400 || typeof json !== "object" || json === null) {
+    return;
+  }
+  const error = "error" in json ? json.error : undefined;
+  if (typeof error !== "object" || error === null || !("issues" in error)) {
+    return;
+  }
+  return Array.isArray(error.issues) ? error.issues : undefined;
+}
 
 
 function resolvePortfolioRoute(keyType, suffix, portfolioId, defaultPortfolioId) {
@@ -103,33 +115,131 @@ function resolvePortfolioRoute(keyType, suffix, portfolioId, defaultPortfolioId)
 import { z } from "zod";
 var zUUID = z.string().uuid();
 var portfolioIdParam = zUUID.optional().describe("Portfolio UUID (required for organization keys without a default)");
-var ChainEnum = z.enum([
-  "arbitrum",
-  "avalanche",
-  "base",
-  "blast",
-  "bsc",
-  "ethereum",
-  "optimism",
-  "polygon",
-  "solana",
-  "hyperevm",
-  "plasma",
-  "monad",
-  "robinhood"
-]);
+var chainParam = (label) => z.string().min(1).describe(`${label}, lowercase (e.g. ethereum, base, arbitrum, solana)`);
 var jsonResult = (result) => ({
-  content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+  content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+  ...isErrorResult(result) && { isError: true }
 });
+var isErrorResult = (result) => typeof result === "object" && result !== null && ("error" in result) && result.error === true;
 
 
 import { z as z2 } from "zod";
+var perpsSymbolParam = z2.string().min(1).max(32).describe('Perps market symbol. Qualify with the subvenue when the base symbol is ambiguous, e.g. "native:BTC" (core exchange) — a bare symbol works only when exactly one market uses it');
+var MIN_EPOCH_MS = 1600000000000;
+var MAX_EPOCH_MS = 4102444800000;
+var epochMsParam = () => z2.number().int().min(MIN_EPOCH_MS).max(MAX_EPOCH_MS);
+var startTimeParam = epochMsParam().optional().describe("Range start in epoch milliseconds");
+var decimalStringParam = z2.string().max(40).regex(/^\d+(\.\d+)?$/, "must be a non-negative decimal string").refine((value) => Number(value) > 0, "must be greater than zero");
+function registerPerpsReadTools(server, client, keyType, defaultPortfolioId) {
+  const resolve = (suffix, portfolioId) => resolvePortfolioRoute(keyType, `perps/${suffix}`, portfolioId, defaultPortfolioId);
+  server.tool("perps_list_markets", "List all perps markets with live mark/mid/oracle prices, funding rate, open interest, and leverage caps. Use each row's marketId to address the market in other perps tools.", {
+    portfolio_id: portfolioIdParam
+  }, async ({ portfolio_id }) => {
+    const result = await client.request("GET", resolve("markets", portfolio_id));
+    return jsonResult(result);
+  });
+  server.tool("perps_get_orderbook", "Get the L2 orderbook snapshot for a perps market: bid/ask price levels with sizes and order counts.", {
+    symbol: perpsSymbolParam,
+    portfolio_id: portfolioIdParam
+  }, async ({ symbol, portfolio_id }) => {
+    const result = await client.request("GET", resolve(`markets/${symbol}/orderbook`, portfolio_id));
+    return jsonResult(result);
+  });
+  server.tool("perps_get_candles", "Get OHLCV candles for a perps market. Defaults to the last 24 hours when no range is given.", {
+    symbol: perpsSymbolParam,
+    interval: z2.enum(["1m", "5m", "15m", "1h", "4h", "1d"]).default("1h").describe("Candle interval"),
+    start_time: startTimeParam,
+    end_time: epochMsParam().optional().describe("Range end in epoch milliseconds"),
+    portfolio_id: portfolioIdParam
+  }, async ({ symbol, interval, start_time, end_time, portfolio_id }) => {
+    const end = end_time ?? Date.now();
+    const start = start_time ?? Math.max(MIN_EPOCH_MS, end - 24 * 60 * 60 * 1000);
+    if (start >= end) {
+      throw new Error("end_time must be greater than start_time");
+    }
+    const result = await client.request("GET", resolve(`markets/${symbol}/candles`, portfolio_id), {
+      interval,
+      startTime: String(start),
+      endTime: String(end)
+    });
+    return jsonResult(result);
+  });
+  server.tool("perps_get_quote", "Get a size-aware execution estimate for a perps market against the live orderbook (anonymous — does not account for positions or margin).", {
+    symbol: perpsSymbolParam,
+    side: z2.enum(["buy", "sell"]).describe("Order side"),
+    size: decimalStringParam.describe('Order size in the base asset, decimal string (e.g. "0.5")'),
+    portfolio_id: portfolioIdParam
+  }, async ({ symbol, side, size, portfolio_id }) => {
+    const result = await client.request("GET", resolve(`markets/${symbol}/quote`, portfolio_id), { side, size });
+    return jsonResult(result);
+  });
+  server.tool("perps_get_funding", "Get historical funding entries and the predicted next funding for a perps market.", {
+    symbol: perpsSymbolParam,
+    start_time: startTimeParam,
+    portfolio_id: portfolioIdParam
+  }, async ({ symbol, start_time, portfolio_id }) => {
+    const params = {};
+    if (start_time != null)
+      params.startTime = String(start_time);
+    const result = await client.request("GET", resolve(`markets/${symbol}/funding`, portfolio_id), params);
+    return jsonResult(result);
+  });
+  server.tool("perps_get_account", "Get the perps account state: equity, withdrawable balance, margin usage, and open positions with entry/mark/liquidation prices and PnL.", {
+    portfolio_id: portfolioIdParam
+  }, async ({ portfolio_id }) => {
+    const result = await client.request("GET", resolve("account", portfolio_id));
+    return jsonResult(result);
+  });
+  server.tool("perps_get_account_status", "Get perps onboarding status for the portfolio (NO_ACCOUNT → READY) and whether it can trade. Check this first if account tools return errors.", {
+    portfolio_id: portfolioIdParam
+  }, async ({ portfolio_id }) => {
+    const result = await client.request("GET", resolve("account/status", portfolio_id));
+    return jsonResult(result);
+  });
+  server.tool("perps_list_open_orders", "List perps orders currently resting on the venue, including trigger orders and position TP/SL.", {
+    portfolio_id: portfolioIdParam
+  }, async ({ portfolio_id }) => {
+    const result = await client.request("GET", resolve("orders/open", portfolio_id));
+    return jsonResult(result);
+  });
+  server.tool("perps_get_order_history", "List historical perps orders with their final status and average fill price.", {
+    portfolio_id: portfolioIdParam
+  }, async ({ portfolio_id }) => {
+    const result = await client.request("GET", resolve("orders/history", portfolio_id));
+    return jsonResult(result);
+  });
+  server.tool("perps_list_fills", "List perps trade fills with price, size, fee, closed PnL, and direction.", {
+    portfolio_id: portfolioIdParam
+  }, async ({ portfolio_id }) => {
+    const result = await client.request("GET", resolve("fills", portfolio_id));
+    return jsonResult(result);
+  });
+  server.tool("perps_list_funding_payments", "List funding payments paid (negative) or received (positive) on perps positions.", {
+    start_time: startTimeParam,
+    portfolio_id: portfolioIdParam
+  }, async ({ start_time, portfolio_id }) => {
+    const params = {};
+    if (start_time != null)
+      params.startTime = String(start_time);
+    const result = await client.request("GET", resolve("funding-payments", portfolio_id), params);
+    return jsonResult(result);
+  });
+  server.tool("perps_get_fees", "Get the portfolio's current perps taker/maker fee rates.", {
+    portfolio_id: portfolioIdParam
+  }, async ({ portfolio_id }) => {
+    const result = await client.request("GET", resolve("fees", portfolio_id));
+    return jsonResult(result);
+  });
+}
+
+
+import { z as z3 } from "zod";
 function registerReadTools(server, client, keyType, defaultPortfolioId) {
   const resolve = (suffix, portfolioId) => resolvePortfolioRoute(keyType, suffix, portfolioId, defaultPortfolioId);
   server.tool("list_positions", "List current token holdings in the portfolio with balances, USD values, and P&L.", {
-    limit: z2.number().min(1).max(100).default(20).describe("Max positions to return (1-100)"),
-    cursor: z2.string().optional().describe("Pagination cursor from previous response's nextCursor field"),
-    include_dust_balances: z2.boolean().default(false).describe("Include positions worth less than $1"),
+    limit: z3.number().min(1).max(100).default(20).describe("Max positions to return (1-100)"),
+    cursor: z3.string().optional().describe("Pagination cursor from previous response's nextCursor field"),
+    include_dust_balances: z3.boolean().default(false).describe("Include positions worth less than $1"),
     portfolio_id: portfolioIdParam
   }, async ({ limit, cursor, include_dust_balances, portfolio_id }) => {
     const path = resolve("positions", portfolio_id);
@@ -149,17 +259,17 @@ function registerReadTools(server, client, keyType, defaultPortfolioId) {
     return jsonResult(result);
   });
   server.tool("list_transfers", "List historical transfers (deposits, withdrawals, swaps, bridge transactions) for the portfolio.", {
-    limit: z2.number().min(1).max(100).default(20).describe("Max transfers to return (1-100)"),
-    cursor: z2.string().optional().describe("Pagination cursor from previous response's nextCursor field"),
-    action_types: z2.array(z2.enum([
+    limit: z3.number().min(1).max(100).default(20).describe("Max transfers to return (1-100)"),
+    cursor: z3.string().optional().describe("Pagination cursor from previous response's nextCursor field"),
+    action_types: z3.array(z3.enum([
       "VAULT_ACTION_DEPOSIT",
       "VAULT_ACTION_WITHDRAW",
       "VAULT_ACTION_BRIDGE_SEND",
       "VAULT_ACTION_BRIDGE_RECEIVE",
       "VAULT_ACTION_SWAP"
     ])).optional().describe("Filter by transfer action types"),
-    start_timestamp: z2.string().datetime().optional().describe("Start of time range (ISO 8601 string, e.g. 2025-01-01T00:00:00Z)"),
-    end_timestamp: z2.string().datetime().optional().describe("End of time range (ISO 8601 string, e.g. 2025-01-01T00:00:00Z)"),
+    start_timestamp: z3.string().datetime().optional().describe("Start of time range (ISO 8601 string, e.g. 2025-01-01T00:00:00Z)"),
+    end_timestamp: z3.string().datetime().optional().describe("End of time range (ISO 8601 string, e.g. 2025-01-01T00:00:00Z)"),
     portfolio_id: portfolioIdParam
   }, async ({
     limit,
@@ -183,8 +293,8 @@ function registerReadTools(server, client, keyType, defaultPortfolioId) {
     return jsonResult(result);
   });
   server.tool("get_deposit_address", "Get a deposit address for a specific blockchain. Creates a vault if one doesn't exist for that chain.", {
-    chain: ChainEnum.describe("Blockchain network name"),
-    wallet_address: z2.string().min(1).describe("User's wallet address on this chain — ask the user if not provided"),
+    chain: chainParam("Blockchain network name"),
+    wallet_address: z3.string().min(1).describe("User's wallet address on this chain — ask the user if not provided"),
     portfolio_id: portfolioIdParam
   }, async ({ chain, wallet_address, portfolio_id }) => {
     const path = resolve(`address/${chain}`, portfolio_id);
@@ -193,9 +303,9 @@ function registerReadTools(server, client, keyType, defaultPortfolioId) {
     return jsonResult(result);
   });
   server.tool("list_orders", "List trade orders with optional status filtering. Returns order details including fill status and pricing.", {
-    limit: z2.number().min(1).max(100).default(20).describe("Max orders to return (1-100)"),
-    cursor: z2.string().optional().describe("Pagination cursor from previous response's nextCursor field"),
-    status: z2.enum([
+    limit: z3.number().min(1).max(100).default(20).describe("Max orders to return (1-100)"),
+    cursor: z3.string().optional().describe("Pagination cursor from previous response's nextCursor field"),
+    status: z3.enum([
       "ORDER_STATUS_PENDING",
       "ORDER_STATUS_ACCEPTED",
       "ORDER_STATUS_PARTIALLY_FILLED",
@@ -224,8 +334,8 @@ function registerReadTools(server, client, keyType, defaultPortfolioId) {
   if (keyType !== "organization")
     return;
   server.tool("list_portfolios", "List all portfolios in the organization. Organization API keys only.", {
-    limit: z2.number().min(1).max(100).default(10).describe("Max portfolios to return (1-100)"),
-    cursor: z2.string().optional().describe("Pagination cursor from previous response's nextCursor field")
+    limit: z3.number().min(1).max(100).default(10).describe("Max portfolios to return (1-100)"),
+    cursor: z3.string().optional().describe("Pagination cursor from previous response's nextCursor field")
   }, async ({ limit, cursor }) => {
     const params = { limit: String(limit) };
     if (cursor)
@@ -235,8 +345,8 @@ function registerReadTools(server, client, keyType, defaultPortfolioId) {
   });
   server.tool("get_fees", "Get fee summary for a portfolio over a time period. Organization API keys only.", {
     portfolio_id: zUUID.describe("Portfolio UUID to get fees for"),
-    start_timestamp: z2.string().datetime().optional().describe("Start of time range (ISO 8601 string, e.g. 2025-01-01T00:00:00Z)"),
-    end_timestamp: z2.string().datetime().optional().describe("End of time range (ISO 8601 string, e.g. 2025-01-01T00:00:00Z)")
+    start_timestamp: z3.string().datetime().optional().describe("Start of time range (ISO 8601 string, e.g. 2025-01-01T00:00:00Z)"),
+    end_timestamp: z3.string().datetime().optional().describe("End of time range (ISO 8601 string, e.g. 2025-01-01T00:00:00Z)")
   }, async ({ portfolio_id, start_timestamp, end_timestamp }) => {
     const params = {};
     if (start_timestamp)
@@ -249,9 +359,9 @@ function registerReadTools(server, client, keyType, defaultPortfolioId) {
 }
 
 
-import { z as z3 } from "zod";
-var OrderSideEnum = z3.enum(["buy", "sell"]);
-var OrderTypeEnum = z3.enum([
+import { z as z4 } from "zod";
+var OrderSideEnum = z4.enum(["buy", "sell"]);
+var OrderTypeEnum = z4.enum([
   "market",
   "limit",
   "twap",
@@ -263,20 +373,20 @@ function registerWriteTools(server, client, keyType, defaultPortfolioId) {
   const resolve = (suffix, portfolioId) => resolvePortfolioRoute(keyType, suffix, portfolioId, defaultPortfolioId);
   server.tool("get_trade_quote", "Get a price quote for a trade order. This is the DEFAULT tool for all trades — use this unless the user explicitly asks for a QuickTrade. Supports market, limit, TWAP, stop, stop-loss, and take-profit order types. This does not execute any trade. Use the returned quote ID with submit_trade to execute.", {
     type: OrderTypeEnum.describe("Order type"),
-    chain: ChainEnum.describe("Blockchain network name"),
-    target_asset: z3.string().min(1).describe("Target asset contract address"),
-    contra_asset: z3.string().min(1).describe("Contra (quote) asset contract address"),
-    qty: z3.string().min(1).describe("Order quantity as a decimal string"),
+    chain: chainParam("Blockchain network name"),
+    target_asset: z4.string().min(1).describe("Target asset contract address"),
+    contra_asset: z4.string().min(1).describe("Contra (quote) asset contract address"),
+    qty: z4.string().min(1).describe("Order quantity as a decimal string"),
     order_side: OrderSideEnum.describe("Buy or sell"),
-    limit_price: z3.string().optional().describe("Limit price (for limit orders)"),
-    limit_is_notional: z3.boolean().optional().describe("Whether limit price is in notional terms"),
-    trigger_price: z3.string().optional().describe("Trigger price (for stop/stop-loss/take-profit orders)"),
-    trigger_is_notional: z3.boolean().optional().describe("Whether trigger price is in notional terms"),
-    duration_seconds: z3.number().optional().describe("TWAP duration in seconds"),
-    target_twap_buckets: z3.number().optional().describe("Number of TWAP buckets"),
-    trigger_type: z3.enum(["upper", "lower"]).optional().describe("Trigger type for stop-buy orders only (upper or lower price bound)"),
-    slippage_tolerance: z3.string().optional().describe("Slippage tolerance as a decimal string (e.g. '0.01' for 1%)"),
-    max_price_impact: z3.string().optional().describe("Max price impact as a decimal string (e.g. '0.01' for 1%)"),
+    limit_price: z4.string().optional().describe("Limit price (for limit orders)"),
+    limit_is_notional: z4.boolean().optional().describe("Whether limit price is in notional terms"),
+    trigger_price: z4.string().optional().describe("Trigger price (for stop/stop-loss/take-profit orders)"),
+    trigger_is_notional: z4.boolean().optional().describe("Whether trigger price is in notional terms"),
+    duration_seconds: z4.number().optional().describe("TWAP duration in seconds"),
+    target_twap_buckets: z4.number().optional().describe("Number of TWAP buckets"),
+    trigger_type: z4.enum(["upper", "lower"]).optional().describe("Trigger type for stop-buy orders only (upper or lower price bound)"),
+    slippage_tolerance: z4.string().optional().describe("Slippage tolerance as a decimal string (e.g. '0.01' for 1%)"),
+    max_price_impact: z4.string().optional().describe("Max price impact as a decimal string (e.g. '0.01' for 1%)"),
     portfolio_id: portfolioIdParam
   }, { readOnlyHint: true }, async ({
     type,
@@ -331,10 +441,10 @@ function registerWriteTools(server, client, keyType, defaultPortfolioId) {
     return jsonResult(result);
   });
   server.tool("get_quicktrade_quote", "Get a price quote for a QuickTrade market swap. Only use when the user explicitly requests a QuickTrade. This does not execute any trade. Review the quote before executing with the quicktrade tool.", {
-    target_asset: z3.string().min(1).describe("Target asset contract address"),
-    contra_asset: z3.string().min(1).describe("Contra (quote) asset contract address"),
-    chain: ChainEnum.describe("Blockchain network name"),
-    qty: z3.string().min(1).describe("Order quantity as a decimal string"),
+    target_asset: z4.string().min(1).describe("Target asset contract address"),
+    contra_asset: z4.string().min(1).describe("Contra (quote) asset contract address"),
+    chain: chainParam("Blockchain network name"),
+    qty: z4.string().min(1).describe("Order quantity as a decimal string"),
     order_side: OrderSideEnum.describe("Buy or sell"),
     portfolio_id: portfolioIdParam
   }, { readOnlyHint: true }, async ({
@@ -358,11 +468,11 @@ function registerWriteTools(server, client, keyType, defaultPortfolioId) {
     return jsonResult(result);
   });
   server.tool("bridge_quote", "Get a quote for a cross-chain bridge transfer. This does not move any funds. Review the routes and select a route_id before executing with bridge_submit.", {
-    from_asset_address: z3.string().min(1).describe("Source asset contract address"),
-    from_chain: ChainEnum.describe("Source blockchain network"),
-    to_asset_address: z3.string().min(1).describe("Destination asset contract address"),
-    to_chain: ChainEnum.describe("Destination blockchain network"),
-    from_amount: z3.string().min(1).describe("Amount to bridge as a decimal string"),
+    from_asset_address: z4.string().min(1).describe("Source asset contract address"),
+    from_chain: chainParam("Source blockchain network"),
+    to_asset_address: z4.string().min(1).describe("Destination asset contract address"),
+    to_chain: chainParam("Destination blockchain network"),
+    from_amount: z4.string().min(1).describe("Amount to bridge as a decimal string"),
     portfolio_id: portfolioIdParam
   }, { readOnlyHint: true }, async ({
     from_asset_address,
@@ -408,20 +518,20 @@ function registerWriteTools(server, client, keyType, defaultPortfolioId) {
   server.tool("submit_trade", "Submit a trade order using a quote from get_trade_quote. This is irreversible — all order types (market, limit, stop, TWAP) may execute immediately. Always show the user the quote details and get confirmation before calling this tool. Pass the same parameters you used for get_trade_quote plus the quote_id.", {
     quote_id: zUUID.describe("Quote UUID from get_trade_quote response (found in quote.quote.id)"),
     type: OrderTypeEnum.describe("Order type"),
-    chain: ChainEnum.describe("Blockchain network name"),
-    target_asset: z3.string().min(1).describe("Target asset contract address"),
-    contra_asset: z3.string().min(1).describe("Contra (quote) asset contract address"),
-    qty: z3.string().min(1).describe("Order quantity as a decimal string"),
+    chain: chainParam("Blockchain network name"),
+    target_asset: z4.string().min(1).describe("Target asset contract address"),
+    contra_asset: z4.string().min(1).describe("Contra (quote) asset contract address"),
+    qty: z4.string().min(1).describe("Order quantity as a decimal string"),
     order_side: OrderSideEnum.describe("Buy or sell"),
-    limit_price: z3.string().optional().describe("Limit price (for limit orders)"),
-    limit_is_notional: z3.boolean().optional().describe("Whether limit price is in notional terms"),
-    trigger_price: z3.string().optional().describe("Trigger price (for stop/stop-loss/take-profit orders)"),
-    trigger_is_notional: z3.boolean().optional().describe("Whether trigger price is in notional terms"),
-    duration_seconds: z3.number().optional().describe("TWAP duration in seconds"),
-    target_twap_buckets: z3.number().optional().describe("Number of TWAP buckets"),
-    trigger_type: z3.enum(["upper", "lower"]).optional().describe("Trigger type for stop-buy orders only"),
-    slippage_tolerance: z3.string().optional().describe("Slippage tolerance as a decimal string (e.g. '0.01' for 1%)"),
-    max_price_impact: z3.string().optional().describe("Max price impact as a decimal string (e.g. '0.01' for 1%)"),
+    limit_price: z4.string().optional().describe("Limit price (for limit orders)"),
+    limit_is_notional: z4.boolean().optional().describe("Whether limit price is in notional terms"),
+    trigger_price: z4.string().optional().describe("Trigger price (for stop/stop-loss/take-profit orders)"),
+    trigger_is_notional: z4.boolean().optional().describe("Whether trigger price is in notional terms"),
+    duration_seconds: z4.number().optional().describe("TWAP duration in seconds"),
+    target_twap_buckets: z4.number().optional().describe("Number of TWAP buckets"),
+    trigger_type: z4.enum(["upper", "lower"]).optional().describe("Trigger type for stop-buy orders only"),
+    slippage_tolerance: z4.string().optional().describe("Slippage tolerance as a decimal string (e.g. '0.01' for 1%)"),
+    max_price_impact: z4.string().optional().describe("Max price impact as a decimal string (e.g. '0.01' for 1%)"),
     portfolio_id: portfolioIdParam
   }, {
     readOnlyHint: false,
@@ -482,14 +592,14 @@ function registerWriteTools(server, client, keyType, defaultPortfolioId) {
     return jsonResult(result);
   });
   server.tool("quicktrade", "Execute a QuickTrade market swap immediately. Only use when the user explicitly requests a QuickTrade. This is irreversible — funds move on-chain once submitted. Call get_quicktrade_quote first and confirm details with the user before executing, unless the user requests to skip the quote step.", {
-    target_asset: z3.string().min(1).describe("Target asset contract address"),
-    contra_asset: z3.string().min(1).describe("Contra (quote) asset contract address"),
-    chain: ChainEnum.describe("Blockchain network name"),
-    qty: z3.string().min(1).describe("Order quantity as a decimal string"),
+    target_asset: z4.string().min(1).describe("Target asset contract address"),
+    contra_asset: z4.string().min(1).describe("Contra (quote) asset contract address"),
+    chain: chainParam("Blockchain network name"),
+    qty: z4.string().min(1).describe("Order quantity as a decimal string"),
     order_side: OrderSideEnum.describe("Buy or sell"),
-    slippage_tolerance: z3.string().optional().describe("Slippage tolerance as a decimal string (e.g. '0.01' for 1%)"),
-    display_asset_price: z3.string().optional().describe("Target asset notional price for display validation"),
-    seconds_to_expire: z3.number().int().positive().optional().describe("Order expiry time in seconds"),
+    slippage_tolerance: z4.string().optional().describe("Slippage tolerance as a decimal string (e.g. '0.01' for 1%)"),
+    display_asset_price: z4.string().optional().describe("Target asset notional price for display validation"),
+    seconds_to_expire: z4.number().int().positive().optional().describe("Order expiry time in seconds"),
     portfolio_id: portfolioIdParam
   }, {
     readOnlyHint: false,
@@ -525,12 +635,12 @@ function registerWriteTools(server, client, keyType, defaultPortfolioId) {
     return jsonResult(result);
   });
   server.tool("bridge_submit", "Execute a cross-chain bridge transfer. This is irreversible — funds are sent from the source chain to the destination chain. Always call bridge_quote first and confirm the details with the user before executing.", {
-    from_chain: ChainEnum.describe("Source blockchain network"),
-    to_chain: ChainEnum.describe("Destination blockchain network"),
-    from_asset_address: z3.string().min(1).describe("Source asset contract address"),
-    to_asset_address: z3.string().min(1).describe("Destination asset contract address"),
-    from_amount: z3.string().min(1).describe("Amount to bridge as a decimal string"),
-    route_id: z3.string().min(1).describe("Route ID from bridge_quote response"),
+    from_chain: chainParam("Source blockchain network"),
+    to_chain: chainParam("Destination blockchain network"),
+    from_asset_address: z4.string().min(1).describe("Source asset contract address"),
+    to_asset_address: z4.string().min(1).describe("Destination asset contract address"),
+    from_amount: z4.string().min(1).describe("Amount to bridge as a decimal string"),
+    route_id: z4.string().min(1).describe("Route ID from bridge_quote response"),
     portfolio_id: portfolioIdParam
   }, {
     readOnlyHint: false,
@@ -560,7 +670,7 @@ function registerWriteTools(server, client, keyType, defaultPortfolioId) {
   if (keyType !== "organization")
     return;
   server.tool("create_portfolio", "Create a new portfolio in the organization. Organization API keys only.", {
-    portfolio_name: z3.string().min(1).describe("Name for the new portfolio")
+    portfolio_name: z4.string().min(1).describe("Name for the new portfolio")
   }, {
     readOnlyHint: false,
     destructiveHint: false
@@ -571,22 +681,21 @@ function registerWriteTools(server, client, keyType, defaultPortfolioId) {
 }
 
 
-import { z as z4 } from "zod";
-var McpEnvSchema = z4.object({
-  DEFINITIVE_API_KEY: z4.string().startsWith("dpka_"),
-  DEFINITIVE_API_SECRET: z4.string().startsWith("dpks_"),
-  DEFINITIVE_BASE_URL: z4.string().url().default("https://ddp.definitive.fi"),
-  DEFINITIVE_API_KEY_TYPE: z4.enum(["portfolio", "organization"]),
-  DEFINITIVE_PORTFOLIO_ID: z4.string().optional()
+import { z as z5 } from "zod";
+var McpEnvSchema = z5.object({
+  DEFINITIVE_API_KEY: z5.string().startsWith("dpka_"),
+  DEFINITIVE_API_SECRET: z5.string().startsWith("dpks_"),
+  DEFINITIVE_BASE_URL: z5.string().url().default("https://ddp.definitive.fi"),
+  DEFINITIVE_API_KEY_TYPE: z5.enum(["portfolio", "organization"]),
+  DEFINITIVE_PORTFOLIO_ID: z5.string().optional()
 });
 var env = McpEnvSchema.parse(process.env);
 var client = createClient(env.DEFINITIVE_BASE_URL, env.DEFINITIVE_API_KEY, env.DEFINITIVE_API_SECRET);
-var server = new McpServer({
-  name: "Definitive",
-  version: "1.1.2",
-  instructions: "MCP server for the Definitive on-chain trading platform. Provides unified tools for portfolio management, trading (market/limit/TWAP/stop orders), QuickTrade execution across multiple blockchains. Tools auto-route to the correct API based on the configured key type (portfolio or organization). For organization keys, pass portfolio_id to target a specific portfolio, or set DEFINITIVE_PORTFOLIO_ID as default. TRADING: Default to get_trade_quote + submit_trade for trades unless the user specifies QuickTrade."
+var server = new McpServer({ name: "Definitive", version: "1.2.1" }, {
+  instructions: "MCP server for the Definitive on-chain trading platform. Provides unified tools for portfolio management, trading (market/limit/TWAP/stop orders), QuickTrade execution across multiple blockchains, and read-only perps (perpetual futures) market data and account state. Tools auto-route to the correct API based on the configured key type (portfolio or organization). For organization keys, pass portfolio_id to target a specific portfolio, or set DEFINITIVE_PORTFOLIO_ID as default. TRADING: Default to get_trade_quote + submit_trade for trades unless the user specifies QuickTrade."
 });
 registerReadTools(server, client, env.DEFINITIVE_API_KEY_TYPE, env.DEFINITIVE_PORTFOLIO_ID);
 registerWriteTools(server, client, env.DEFINITIVE_API_KEY_TYPE, env.DEFINITIVE_PORTFOLIO_ID);
+registerPerpsReadTools(server, client, env.DEFINITIVE_API_KEY_TYPE, env.DEFINITIVE_PORTFOLIO_ID);
 var transport = new StdioServerTransport;
 await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@definitive-fi/mcp",
-  "version": "1.1.2",
+  "version": "1.2.1",
   "description": "MCP server for the Definitive on-chain trading platform",
   "keywords": [
     "mcp",