agentcanary-mcp 1.1.2 → 1.3.0

package/index.js

@@ -81,7 +81,7 @@ async function detectTier() {
 
 const server = new McpServer({
   name: "agentcanary",
-  version: "1.1.2",
+  version: "1.2.0",
 });
 
 // --- Tool: get_briefs (all tiers) ---
@@ -294,7 +294,7 @@ server.tool(
 // --- Tool: get_btc_options (signal+) ---
 server.tool(
   "get_btc_options",
-  "Get BTC options data — max pain, volatility skew, put/call ratios. Key for understanding institutional positioning.",
+  "Get BTC options data — pass view= for maxpain (max pain price) or skew (volatility skew). Omit for overview (includes max pain + skew + put/call ratios). Key for understanding institutional positioning.",
   {
     view: z.string().optional().describe("View: maxpain, skew. Omit for overview."),
   },
@@ -305,6 +305,28 @@ server.tool(
   }
 );
 
+// --- Tool: get_market_structure (signal+) ---
+server.tool(
+  "get_market_structure",
+  "Get market structure & exchange data — pass view= for one of: orderbook (depth across exchanges), liquidation-heatmap (BTC leverage liquidation map), liquidation-ranges, exchange-assets (token listings by venue), exchange-volumes (trading volumes by exchange), coinbase (Coinbase-specific metrics). Omit for orderbook (default). Covers the leverage/depth/venue data that complements directional signals from get_signals.",
+  {
+    view: z.string().optional().describe("View: orderbook, liquidation-heatmap, liquidation-ranges, exchange-assets, exchange-volumes, coinbase. Omit for orderbook."),
+  },
+  async ({ view }) => {
+    const map = {
+      orderbook: "orderbook/depth",
+      "liquidation-heatmap": "btc-liquidation-heatmap",
+      "liquidation-ranges": "liquidation-ranges",
+      "exchange-assets": "exchange-assets",
+      "exchange-volumes": "exchange-volumes",
+      coinbase: "coinbase",
+    };
+    const endpoint = map[view] || map.orderbook;
+    const data = await acFetch(endpoint);
+    return { content: [{ type: "text", text: truncate(data) }] };
+  }
+);
+
 // --- Tool: get_central_banks (signal+) ---
 server.tool(
   "get_central_banks",
@@ -347,6 +369,37 @@ server.tool(
   }
 );
 
+// --- Tool: get_open_interest (builder+) ---
+// Live derivatives positioning across 43 tracked perps × 21 exchanges.
+// Sourced from coinglass-v2; refreshes ~hourly upstream. Same atom that
+// powers the OPEN INTEREST section of the pulse brief.
+server.tool(
+  "get_open_interest",
+  "Get cross-exchange open-interest snapshot for crypto perps. Aggregate OI across 43 symbols + top-N by USD size + top-N by absolute 4h Δ% (intraday OI shifters). Useful for agents detecting positioning unwinds, new builds, leveraged crowding. Builder tier or above.",
+  {
+    view: z.string().optional().describe("View: 'top' (top symbols by OI USD), 'shifters' (top intraday OI movers by 4h Δ%). Omit for full snapshot (aggregate + top + shifters + envelope)."),
+  },
+  async ({ view }) => {
+    const endpoint = view ? `derivatives/oi/${view}` : "derivatives/oi";
+    const data = await acFetch(endpoint);
+    return { content: [{ type: "text", text: truncate(data) }] };
+  }
+);
+
+// --- Tool: get_liquidations (builder+) ---
+// 24h aggregate + latest 4h breakdown with long/short USD split, per-side
+// event counts, dominant-direction label. Same atom that powers the
+// Liquidations line of the pulse brief.
+server.tool(
+  "get_liquidations",
+  "Get crypto perp liquidations. 24h total + latest-4h breakdown with long/short USD split, per-side event counts, long%/short%, and dominant-direction label (long-dominant >=65%, short-dominant <=35%, balanced). Useful for agents detecting forced deleveraging direction. Builder tier or above.",
+  {},
+  async () => {
+    const data = await acFetch("derivatives/liquidations");
+    return { content: [{ type: "text", text: truncate(data) }] };
+  }
+);
+
 // ─── Start ───────────────────────────────────────────────────────
 
 await detectTier();

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "agentcanary-mcp",
-  "version": "1.1.2",
+  "version": "1.3.0",
   "mcpName": "io.github.MrCerq/agentcanary",
-  "description": "MCP server for AgentCanary market intelligence — briefs, indicators, regime, narratives, predictions, scoring",
+  "description": "MCP server for AgentCanary market intelligence — briefs, indicators, regime, narratives, predictions, scoring, plus live derivatives (open interest, liquidations)",
   "main": "index.js",
   "type": "module",
   "bin": {

package/server.json

@@ -8,13 +8,13 @@
     "url": "https://github.com/MrCerq/agentcanary-mcp",
     "source": "github"
   },
-  "version": "1.1.2",
+  "version": "1.2.0",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "agentcanary-mcp",
-      "version": "1.1.2",
+      "version": "1.2.0",
       "transport": {
         "type": "stdio"
       },

package/smithery.yaml

@@ -0,0 +1,22 @@
+# Smithery configuration — https://smithery.ai/docs/config
+# Tells Smithery how to launch agentcanary-mcp via stdio with the user's API key.
+
+startCommand:
+  type: stdio
+  configSchema:
+    # JSON Schema for the config that Smithery passes to the server at launch.
+    type: object
+    required:
+      - acApiKey
+    properties:
+      acApiKey:
+        type: string
+        description: AgentCanary API key. Get one at https://app.agentcanary.ai or POST https://api.agentcanary.ai/api/keys/create with a wallet address.
+  commandFunction:
+    # Returns the CLI command Smithery uses to spawn the MCP server.
+    |-
+    (config) => ({
+      command: 'npx',
+      args: ['-y', 'agentcanary-mcp'],
+      env: { AC_API_KEY: config.acApiKey }
+    })