@definitive-fi/mcp 1.1.2 → 1.2.0

package/dist/server.js

@@ -116,7 +116,8 @@ var ChainEnum = z.enum([
   "hyperevm",
   "plasma",
   "monad",
-  "robinhood"
+  "robinhood",
+  "ink"
 ]);
 var jsonResult = (result) => ({
   content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
@@ -124,12 +125,122 @@ var jsonResult = (result) => ({
 
 
 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 +260,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,
@@ -184,7 +295,7 @@ function registerReadTools(server, client, keyType, defaultPortfolioId) {
   });
   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"),
+    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 +304,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 +335,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 +346,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 +360,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",
@@ -264,19 +375,19 @@ function registerWriteTools(server, client, keyType, 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"),
+    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 +442,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"),
+    target_asset: z4.string().min(1).describe("Target asset contract address"),
+    contra_asset: z4.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"),
+    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 +469,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_asset_address: z4.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_asset_address: z4.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_amount: z4.string().min(1).describe("Amount to bridge as a decimal string"),
     portfolio_id: portfolioIdParam
   }, { readOnlyHint: true }, async ({
     from_asset_address,
@@ -409,19 +520,19 @@ function registerWriteTools(server, client, keyType, defaultPortfolioId) {
     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"),
+    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 +593,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"),
+    target_asset: z4.string().min(1).describe("Target asset contract address"),
+    contra_asset: z4.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"),
+    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,
@@ -527,10 +638,10 @@ function registerWriteTools(server, client, keyType, defaultPortfolioId) {
   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_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 +671,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 +682,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.0" }, {
+  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.0",
   "description": "MCP server for the Definitive on-chain trading platform",
   "keywords": [
     "mcp",