@definitive-fi/mcp 1.2.0 → 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,25 +115,12 @@ 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",
-  "ink"
-]);
+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";
@@ -294,7 +293,7 @@ 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"),
+    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 }) => {
@@ -374,7 +373,7 @@ 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"),
+    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"),
@@ -444,7 +443,7 @@ function registerWriteTools(server, client, keyType, defaultPortfolioId) {
   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: 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"),
+    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
@@ -470,9 +469,9 @@ function registerWriteTools(server, client, keyType, defaultPortfolioId) {
   });
   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: z4.string().min(1).describe("Source asset contract address"),
-    from_chain: ChainEnum.describe("Source blockchain network"),
+    from_chain: chainParam("Source blockchain network"),
     to_asset_address: z4.string().min(1).describe("Destination asset contract address"),
-    to_chain: ChainEnum.describe("Destination blockchain network"),
+    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 ({
@@ -519,7 +518,7 @@ 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"),
+    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"),
@@ -595,7 +594,7 @@ function registerWriteTools(server, client, keyType, defaultPortfolioId) {
   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: 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"),
+    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: z4.string().optional().describe("Slippage tolerance as a decimal string (e.g. '0.01' for 1%)"),
@@ -636,8 +635,8 @@ 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_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"),
@@ -692,7 +691,7 @@ var McpEnvSchema = z5.object({
 });
 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.2.0" }, {
+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);

package/package.json

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