@ironflowsh/mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ironflow
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,74 @@
+# @ironflowsh/mcp
+
+Model Context Protocol (MCP) server for [Ironflow](https://ironflow.sh) — real-time and historical market data for on-chain derivatives, designed for AI agents.
+
+Exposes 24 tools for market data, analytics, triggers, cohorts, and bulk export. Works with Claude Desktop, Cursor, any MCP-compatible client.
+
+## Install
+
+```bash
+# Run directly (no install)
+npx @ironflowsh/mcp
+
+# Or install globally
+npm install -g @ironflowsh/mcp
+```
+
+Requires Node.js 18+.
+
+## Use with Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%/Claude/claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "ironflow": {
+      "command": "npx",
+      "args": ["-y", "@ironflowsh/mcp"],
+      "env": {
+        "IRONFLOW_API_KEY": "if_your_api_key"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop.
+
+## Authentication
+
+Without an API key: 10 req/min, 24h history, REST only. Sign up at [ironflow.sh](https://ironflow.sh/dashboard/login) for higher limits.
+
+```bash
+IRONFLOW_API_KEY=if_xxx npx @ironflowsh/mcp
+```
+
+## Tools
+
+**Market data** — `get_price`, `get_orderbook`, `get_recent_trades`, `get_candles`, `get_funding_rates`, `get_open_interest`, `get_liquidations`, `get_fills`, `get_mark_prices`, `get_deposits`, `get_withdrawals`, `get_order_statuses`, `get_vault_operations`
+
+**Analytics** (Builder+) — `get_net_flows`, `get_liquidation_levels`, `get_order_flow`, `get_vault_leaderboard`, `get_funding_stats`
+
+**Export** (Builder+) — `export_data`
+
+**Triggers** — `list_triggers`, `create_trigger`, `test_trigger`
+
+**Cohorts** — `list_cohorts`, `get_cohort_addresses`
+
+## Configuration
+
+| Env var | Default |
+|---|---|
+| `IRONFLOW_API_KEY` | — |
+| `IRONFLOW_API_URL` | `https://api.ironflow.sh` |
+
+## Links
+
+- Dashboard: [ironflow.sh/dashboard](https://ironflow.sh/dashboard)
+- Docs: [docs.ironflow.sh](https://docs.ironflow.sh)
+- API reference: [docs.ironflow.sh/api-reference](https://docs.ironflow.sh/api-reference)
+
+## License
+
+MIT

package/build/api.d.ts

@@ -0,0 +1,33 @@
+export declare class IronflowAPI {
+    private baseUrl;
+    private apiKey?;
+    private source;
+    constructor(baseUrl?: string, apiKey?: string, source?: string);
+    private headers;
+    get(path: string, params?: Record<string, string>): Promise<unknown>;
+    post(path: string, body: unknown): Promise<unknown>;
+    getPrice(market: string): Promise<string>;
+    getOrderbook(market: string): Promise<unknown>;
+    getRecentTrades(market: string, limit?: string): Promise<unknown>;
+    getCandles(market: string, interval?: string, limit?: string): Promise<unknown>;
+    getFundingRates(market: string, limit?: string): Promise<unknown>;
+    getOpenInterest(market: string): Promise<unknown>;
+    getLiquidations(market: string, limit?: string): Promise<unknown>;
+    getFills(address: string, market?: string, limit?: string): Promise<unknown>;
+    getMarkPrices(market: string): Promise<unknown>;
+    getDeposits(address?: string, limit?: string): Promise<unknown>;
+    getWithdrawals(address?: string, limit?: string): Promise<unknown>;
+    getOrderStatuses(address: string, market?: string, limit?: string): Promise<unknown>;
+    getVaultOperations(vault?: string, address?: string, limit?: string): Promise<unknown>;
+    getNetFlows(interval?: string, limit?: string): Promise<unknown>;
+    getLiquidationLevels(market: string, bucket_size?: string): Promise<unknown>;
+    getOrderFlow(market?: string): Promise<unknown>;
+    getVaultLeaderboard(limit?: string): Promise<unknown>;
+    getFundingStats(market: string, interval?: string, limit?: string): Promise<unknown>;
+    listTriggers(): Promise<unknown>;
+    createTrigger(body: unknown): Promise<unknown>;
+    testTrigger(body: unknown): Promise<unknown>;
+    listCohorts(): Promise<unknown>;
+    getCohortAddresses(name: string): Promise<unknown>;
+}
+//# sourceMappingURL=api.d.ts.map

package/build/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAKA,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAGrB,OAAO,SAAmB,EAC1B,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,SAAiB;IAOzB,OAAO,CAAC,OAAO;IAWT,GAAG,CACP,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAClC,OAAO,CAAC,OAAO,CAAC;IAqBb,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAmBnD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAazC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9C,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAa,GACnB,OAAO,CAAC,OAAO,CAAC;IAIb,UAAU,CACd,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,MAAa,EACvB,KAAK,GAAE,MAAa,GACnB,OAAO,CAAC,OAAO,CAAC;IAIb,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAa,GACnB,OAAO,CAAC,OAAO,CAAC;IAIb,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjD,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAa,GACnB,OAAO,CAAC,OAAO,CAAC;IAIb,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAW,EAAE,KAAK,GAAE,MAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAMtF,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/C,WAAW,CAAC,OAAO,GAAE,MAAW,EAAE,KAAK,GAAE,MAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAMzE,cAAc,CAAC,OAAO,GAAE,MAAW,EAAE,KAAK,GAAE,MAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAM5E,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAW,EAAE,KAAK,GAAE,MAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAM9F,kBAAkB,CAAC,KAAK,GAAE,MAAW,EAAE,OAAO,GAAE,MAAW,EAAE,KAAK,GAAE,MAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IASpG,WAAW,CAAC,QAAQ,GAAE,MAAa,EAAE,KAAK,GAAE,MAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3E,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,GAAE,MAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAInF,YAAY,CAAC,MAAM,GAAE,MAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAMnD,mBAAmB,CAAC,KAAK,GAAE,MAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3D,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAa,EAAE,KAAK,GAAE,MAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAM/F,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAIhC,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9C,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAM5C,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGzD"}

package/build/api.js

@@ -0,0 +1,155 @@
+// Ironflow REST API client. Uses native fetch — no external HTTP dependencies.
+const DEFAULT_BASE_URL = "https://api.ironflow.sh";
+const DEFAULT_SOURCE = "hyperliquid";
+export class IronflowAPI {
+    baseUrl;
+    apiKey;
+    source;
+    constructor(baseUrl = DEFAULT_BASE_URL, apiKey, source = DEFAULT_SOURCE) {
+        this.baseUrl = baseUrl.replace(/\/$/, "");
+        this.apiKey = apiKey;
+        this.source = source;
+    }
+    headers() {
+        const h = {
+            "Content-Type": "application/json",
+            "User-Agent": "ironflow-mcp/0.1.0",
+        };
+        if (this.apiKey) {
+            h["Authorization"] = `Bearer ${this.apiKey}`;
+        }
+        return h;
+    }
+    async get(path, params = {}) {
+        // Always include source.
+        if (!params.source) {
+            params.source = this.source;
+        }
+        const url = new URL(path, this.baseUrl);
+        for (const [k, v] of Object.entries(params)) {
+            if (v)
+                url.searchParams.set(k, v);
+        }
+        const res = await fetch(url.toString(), { headers: this.headers() });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`Ironflow API error ${res.status}: ${text}`);
+        }
+        return res.json();
+    }
+    async post(path, body) {
+        const url = new URL(path, this.baseUrl);
+        const res = await fetch(url.toString(), {
+            method: "POST",
+            headers: this.headers(),
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`Ironflow API error ${res.status}: ${text}`);
+        }
+        return res.json();
+    }
+    // ─── Convenience methods ──────────────────────────────────────────────
+    async getPrice(market) {
+        const data = (await this.post("/v1/info", {
+            type: "allMids",
+        }));
+        // allMids returns {"BTC-PERP": "67123.5", "ETH-PERP": "3456.7", ...}
+        const price = data[market];
+        if (!price) {
+            throw new Error(`Market ${market} not found`);
+        }
+        return price;
+    }
+    async getOrderbook(market) {
+        return this.get("/v1/book", { market });
+    }
+    async getRecentTrades(market, limit = "20") {
+        return this.get("/v1/trades", { market, limit });
+    }
+    async getCandles(market, interval = "1h", limit = "24") {
+        return this.get("/v1/candles", { market, interval, limit });
+    }
+    async getFundingRates(market, limit = "10") {
+        return this.get("/v1/funding", { market, limit });
+    }
+    async getOpenInterest(market) {
+        return this.get("/v1/open-interest", { market, limit: "1" });
+    }
+    async getLiquidations(market, limit = "20") {
+        return this.get("/v1/liquidations", { market, limit });
+    }
+    async getFills(address, market = "", limit = "20") {
+        const params = { address, limit };
+        if (market)
+            params.market = market;
+        return this.get("/v1/fills", params);
+    }
+    async getMarkPrices(market) {
+        return this.get("/v1/mark-prices", { market, limit: "1" });
+    }
+    async getDeposits(address = "", limit = "20") {
+        const params = { limit };
+        if (address)
+            params.address = address;
+        return this.get("/v1/deposits", params);
+    }
+    async getWithdrawals(address = "", limit = "20") {
+        const params = { limit };
+        if (address)
+            params.address = address;
+        return this.get("/v1/withdrawals", params);
+    }
+    async getOrderStatuses(address, market = "", limit = "20") {
+        const params = { address, limit };
+        if (market)
+            params.market = market;
+        return this.get("/v1/order-statuses", params);
+    }
+    async getVaultOperations(vault = "", address = "", limit = "20") {
+        const params = { limit };
+        if (vault)
+            params.vault = vault;
+        if (address)
+            params.address = address;
+        return this.get("/v1/vault-operations", params);
+    }
+    // ─── Analytics ────────────────────────────────────────────────────────
+    async getNetFlows(interval = "1d", limit = "7") {
+        return this.get("/v1/analytics/net-flows", { interval, limit });
+    }
+    async getLiquidationLevels(market, bucket_size = "100") {
+        return this.get("/v1/analytics/liquidation-levels", { market, bucket_size });
+    }
+    async getOrderFlow(market = "") {
+        const params = {};
+        if (market)
+            params.market = market;
+        return this.get("/v1/analytics/order-flow", params);
+    }
+    async getVaultLeaderboard(limit = "10") {
+        return this.get("/v1/analytics/vault-leaderboard", { limit });
+    }
+    async getFundingStats(market, interval = "1d", limit = "7") {
+        return this.get("/v1/analytics/funding-stats", { market, interval, limit });
+    }
+    // ─── Triggers ─────────────────────────────────────────────────────────
+    async listTriggers() {
+        return this.get("/v1/triggers");
+    }
+    async createTrigger(body) {
+        return this.post("/v1/triggers", body);
+    }
+    async testTrigger(body) {
+        return this.post("/v1/triggers/test", body);
+    }
+    // ─── Cohorts ──────────────────────────────────────────────────────────
+    async listCohorts() {
+        return this.get("/v1/cohorts");
+    }
+    async getCohortAddresses(name) {
+        return this.get(`/v1/cohorts/${encodeURIComponent(name)}`);
+    }
+}
+//# sourceMappingURL=api.js.map

package/build/api.js.map

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

package/build/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/build/index.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+// Ironflow MCP Server — market data for AI agents.
+//
+// Usage:
+//   npx @ironflowsh/mcp                              # keyless, 30 req/min
+//   IRONFLOW_API_KEY=if_xxx npx @ironflowsh/mcp       # with API key
+//
+// Claude Desktop config (~/.claude/claude_desktop_config.json):
+//   {
+//     "mcpServers": {
+//       "ironflow": {
+//         "command": "npx",
+//         "args": ["-y", "@ironflowsh/mcp"]
+//       }
+//     }
+//   }
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { IronflowAPI } from "./api.js";
+import { tools } from "./tools.js";
+const apiUrl = process.env.IRONFLOW_API_URL || "https://api.ironflow.sh";
+const apiKey = process.env.IRONFLOW_API_KEY;
+const api = new IronflowAPI(apiUrl, apiKey);
+const server = new Server({
+    name: "ironflow",
+    version: "0.1.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// List all available tools.
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: tools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema,
+        })),
+    };
+});
+// Handle tool calls.
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    const tool = tools.find((t) => t.name === name);
+    if (!tool) {
+        return {
+            content: [{ type: "text", text: `Unknown tool: ${name}` }],
+            isError: true,
+        };
+    }
+    try {
+        const result = await tool.handler(args ?? {}, api);
+        return {
+            content: [{ type: "text", text: result }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,mDAAmD;AACnD,EAAE;AACF,SAAS;AACT,2EAA2E;AAC3E,qEAAqE;AACrE,EAAE;AACF,gEAAgE;AAChE,MAAM;AACN,sBAAsB;AACtB,sBAAsB;AACtB,4BAA4B;AAC5B,4CAA4C;AAC5C,UAAU;AACV,QAAQ;AACR,MAAM;AAEN,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,yBAAyB,CAAC;AACzE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;AAE5C,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE5C,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;IACE,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,OAAO;CACjB,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;KACV;CACF,CACF,CAAC;AAEF,4BAA4B;AAC5B,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;IAC1D,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,qBAAqB;AACrB,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,IAAI,EAAE,EAAE,CAAC;YAC1D,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;QACnD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;SAC1C,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;YACtD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/build/tools.d.ts

@@ -0,0 +1,17 @@
+import { IronflowAPI } from "./api.js";
+export interface ToolDef {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: Record<string, {
+            type: string;
+            description: string;
+            enum?: string[];
+        }>;
+        required: string[];
+    };
+    handler: (args: Record<string, unknown>, api: IronflowAPI) => Promise<string>;
+}
+export declare const tools: ToolDef[];
+//# sourceMappingURL=tools.d.ts.map

package/build/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAGvC,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAC;QACnF,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/E;AAiCD,eAAO,MAAM,KAAK,EAAE,OAAO,EAmb1B,CAAC"}

package/build/tools.js

@@ -0,0 +1,457 @@
+// MCP tool definitions for Ironflow market data.
+// ─── Arg validation helpers ──────────────────────────────────────────────────
+function requireString(args, key) {
+    const val = args[key];
+    if (typeof val !== "string" || val.trim() === "") {
+        throw new Error(`"${key}" is required and must be a non-empty string`);
+    }
+    return val;
+}
+function optionalNumber(args, key, defaultVal) {
+    const val = args[key];
+    if (val === undefined || val === null)
+        return defaultVal;
+    const n = Number(val);
+    if (!Number.isFinite(n) || n <= 0) {
+        throw new Error(`"${key}" must be a positive number`);
+    }
+    return Math.floor(n);
+}
+function optionalString(args, key, defaultVal) {
+    const val = args[key];
+    if (val === undefined || val === null)
+        return defaultVal;
+    if (typeof val !== "string") {
+        throw new Error(`"${key}" must be a string`);
+    }
+    return val;
+}
+// ─── Tools ──────────────────────────────────────────────────────────────────
+export const tools = [
+    {
+        name: "get_price",
+        description: "Get the latest mid-market price for a perpetual futures market on Hyperliquid",
+        inputSchema: {
+            type: "object",
+            properties: {
+                market: { type: "string", description: 'Market symbol (e.g. "BTC-PERP", "ETH-PERP")' },
+            },
+            required: ["market"],
+        },
+        handler: async (args, api) => {
+            const market = requireString(args, "market");
+            const price = await api.getPrice(market);
+            return `${market}: $${price}`;
+        },
+    },
+    {
+        name: "get_orderbook",
+        description: "Get the current L2 order book snapshot for a market, showing bid and ask price levels",
+        inputSchema: {
+            type: "object",
+            properties: {
+                market: { type: "string", description: 'Market symbol (e.g. "BTC-PERP", "ETH-PERP")' },
+            },
+            required: ["market"],
+        },
+        handler: async (args, api) => {
+            const market = requireString(args, "market");
+            const data = await api.getOrderbook(market);
+            return JSON.stringify(data, null, 2);
+        },
+    },
+    {
+        name: "get_recent_trades",
+        description: "Get recent tick-level trades for a market including price, size, side, and timestamp",
+        inputSchema: {
+            type: "object",
+            properties: {
+                market: { type: "string", description: 'Market symbol (e.g. "BTC-PERP", "ETH-PERP")' },
+                limit: { type: "number", description: "Number of trades to return (1-100, default 20)" },
+            },
+            required: ["market"],
+        },
+        handler: async (args, api) => {
+            const market = requireString(args, "market");
+            const limit = optionalNumber(args, "limit", 20);
+            const data = await api.getRecentTrades(market, String(limit));
+            return JSON.stringify(data, null, 2);
+        },
+    },
+    {
+        name: "get_candles",
+        description: "Get OHLCV candlestick data for a market. Useful for price analysis and charting",
+        inputSchema: {
+            type: "object",
+            properties: {
+                market: { type: "string", description: 'Market symbol (e.g. "BTC-PERP", "ETH-PERP")' },
+                interval: { type: "string", description: "Candle interval (1m, 5m, 15m, 1h, 4h, 1d). Default: 1h", enum: ["1m", "5m", "15m", "1h", "4h", "1d"] },
+                limit: { type: "number", description: "Number of candles to return (1-500, default 24)" },
+            },
+            required: ["market"],
+        },
+        handler: async (args, api) => {
+            const market = requireString(args, "market");
+            const interval = optionalString(args, "interval", "1h");
+            const limit = optionalNumber(args, "limit", 24);
+            const data = await api.getCandles(market, interval, String(limit));
+            return JSON.stringify(data, null, 2);
+        },
+    },
+    {
+        name: "get_funding_rates",
+        description: "Get funding rate history for a perpetual futures market. Rates are paid hourly on Hyperliquid",
+        inputSchema: {
+            type: "object",
+            properties: {
+                market: { type: "string", description: 'Market symbol (e.g. "BTC-PERP", "ETH-PERP")' },
+                limit: { type: "number", description: "Number of funding rate entries (1-100, default 10)" },
+            },
+            required: ["market"],
+        },
+        handler: async (args, api) => {
+            const market = requireString(args, "market");
+            const limit = optionalNumber(args, "limit", 10);
+            const data = await api.getFundingRates(market, String(limit));
+            return JSON.stringify(data, null, 2);
+        },
+    },
+    {
+        name: "get_open_interest",
+        description: "Get the current open interest and 24h trading volume for a perpetual futures market",
+        inputSchema: {
+            type: "object",
+            properties: {
+                market: { type: "string", description: 'Market symbol (e.g. "BTC-PERP", "ETH-PERP")' },
+            },
+            required: ["market"],
+        },
+        handler: async (args, api) => {
+            const market = requireString(args, "market");
+            const data = await api.getOpenInterest(market);
+            return JSON.stringify(data, null, 2);
+        },
+    },
+    {
+        name: "get_liquidations",
+        description: "Get recent liquidation events for a market showing forced position closures with price, size, and address",
+        inputSchema: {
+            type: "object",
+            properties: {
+                market: { type: "string", description: 'Market symbol (e.g. "BTC-PERP", "ETH-PERP")' },
+                limit: { type: "number", description: "Number of liquidation events (1-100, default 20)" },
+            },
+            required: ["market"],
+        },
+        handler: async (args, api) => {
+            const market = requireString(args, "market");
+            const limit = optionalNumber(args, "limit", 20);
+            const data = await api.getLiquidations(market, String(limit));
+            return JSON.stringify(data, null, 2);
+        },
+    },
+    // ─── Additional Market Data ──────────────────────────────────────────
+    {
+        name: "get_fills",
+        description: "Get trade fills for a specific wallet address, optionally filtered by market",
+        inputSchema: {
+            type: "object",
+            properties: {
+                address: { type: "string", description: "Wallet address (e.g. 0x...)" },
+                market: { type: "string", description: "Optional market filter (e.g. BTC-PERP)" },
+                limit: { type: "number", description: "Number of fills (1-100, default 20)" },
+            },
+            required: ["address"],
+        },
+        handler: async (args, api) => {
+            const address = requireString(args, "address");
+            const market = optionalString(args, "market", "");
+            const limit = optionalNumber(args, "limit", 20);
+            const data = await api.getFills(address, market, String(limit));
+            return JSON.stringify(data, null, 2);
+        },
+    },
+    {
+        name: "get_mark_prices",
+        description: "Get the current mark price, oracle price, and funding rate for a market",
+        inputSchema: {
+            type: "object",
+            properties: {
+                market: { type: "string", description: 'Market symbol (e.g. "BTC-PERP")' },
+            },
+            required: ["market"],
+        },
+        handler: async (args, api) => {
+            const market = requireString(args, "market");
+            const data = await api.getMarkPrices(market);
+            return JSON.stringify(data, null, 2);
+        },
+    },
+    {
+        name: "get_deposits",
+        description: "Get recent deposit events, optionally filtered by address",
+        inputSchema: {
+            type: "object",
+            properties: {
+                address: { type: "string", description: "Optional wallet address filter" },
+                limit: { type: "number", description: "Number of deposits (1-100, default 20)" },
+            },
+            required: [],
+        },
+        handler: async (args, api) => {
+            const address = optionalString(args, "address", "");
+            const limit = optionalNumber(args, "limit", 20);
+            const data = await api.getDeposits(address, String(limit));
+            return JSON.stringify(data, null, 2);
+        },
+    },
+    {
+        name: "get_withdrawals",
+        description: "Get recent withdrawal events, optionally filtered by address",
+        inputSchema: {
+            type: "object",
+            properties: {
+                address: { type: "string", description: "Optional wallet address filter" },
+                limit: { type: "number", description: "Number of withdrawals (1-100, default 20)" },
+            },
+            required: [],
+        },
+        handler: async (args, api) => {
+            const address = optionalString(args, "address", "");
+            const limit = optionalNumber(args, "limit", 20);
+            const data = await api.getWithdrawals(address, String(limit));
+            return JSON.stringify(data, null, 2);
+        },
+    },
+    {
+        name: "get_order_statuses",
+        description: "Get order status history for a wallet address (placed, filled, cancelled, triggered)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                address: { type: "string", description: "Wallet address (e.g. 0x...)" },
+                market: { type: "string", description: "Optional market filter" },
+                limit: { type: "number", description: "Number of statuses (1-100, default 20)" },
+            },
+            required: ["address"],
+        },
+        handler: async (args, api) => {
+            const address = requireString(args, "address");
+            const market = optionalString(args, "market", "");
+            const limit = optionalNumber(args, "limit", 20);
+            const data = await api.getOrderStatuses(address, market, String(limit));
+            return JSON.stringify(data, null, 2);
+        },
+    },
+    {
+        name: "get_vault_operations",
+        description: "Get vault deposit and withdrawal events, filterable by vault address or user address",
+        inputSchema: {
+            type: "object",
+            properties: {
+                vault: { type: "string", description: "Vault address" },
+                address: { type: "string", description: "User address" },
+                limit: { type: "number", description: "Number of events (1-100, default 20)" },
+            },
+            required: [],
+        },
+        handler: async (args, api) => {
+            const vault = optionalString(args, "vault", "");
+            const address = optionalString(args, "address", "");
+            const limit = optionalNumber(args, "limit", 20);
+            const data = await api.getVaultOperations(vault, address, String(limit));
+            return JSON.stringify(data, null, 2);
+        },
+    },
+    // ─── Analytics (Builder+ tier) ───────────────────────────────────────
+    {
+        name: "get_net_flows",
+        description: "Get net deposit/withdrawal flows over time — shows capital inflows and outflows (Builder+ tier)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                interval: { type: "string", description: "Time interval (1h, 4h, 8h, 1d, 7d). Default: 1d", enum: ["1h", "4h", "8h", "1d", "7d"] },
+                limit: { type: "number", description: "Number of data points (default 7)" },
+            },
+            required: [],
+        },
+        handler: async (args, api) => {
+            const interval = optionalString(args, "interval", "1d");
+            const limit = optionalNumber(args, "limit", 7);
+            const data = await api.getNetFlows(interval, String(limit));
+            return JSON.stringify(data, null, 2);
+        },
+    },
+    {
+        name: "get_liquidation_levels",
+        description: "Get liquidations bucketed by price level — useful for heatmap visualization (Builder+ tier)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                market: { type: "string", description: 'Market symbol (e.g. "BTC-PERP")' },
+                bucket_size: { type: "string", description: "Price bucket size (1, 5, 10, 50, 100, 500, 1000, 5000). Default: 100" },
+            },
+            required: ["market"],
+        },
+        handler: async (args, api) => {
+            const market = requireString(args, "market");
+            const bucket = optionalString(args, "bucket_size", "100");
+            const data = await api.getLiquidationLevels(market, bucket);
+            return JSON.stringify(data, null, 2);
+        },
+    },
+    {
+        name: "get_order_flow",
+        description: "Get fill and cancel rates per market — shows execution quality (Builder+ tier)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                market: { type: "string", description: "Optional market filter" },
+            },
+            required: [],
+        },
+        handler: async (args, api) => {
+            const market = optionalString(args, "market", "");
+            const data = await api.getOrderFlow(market);
+            return JSON.stringify(data, null, 2);
+        },
+    },
+    {
+        name: "get_vault_leaderboard",
+        description: "Get vaults ranked by net deposits — shows which vaults are attracting capital (Builder+ tier)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: { type: "number", description: "Number of vaults (default 10)" },
+            },
+            required: [],
+        },
+        handler: async (args, api) => {
+            const limit = optionalNumber(args, "limit", 10);
+            const data = await api.getVaultLeaderboard(String(limit));
+            return JSON.stringify(data, null, 2);
+        },
+    },
+    {
+        name: "get_funding_stats",
+        description: "Get funding rate statistics over time including annualized rates (Builder+ tier)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                market: { type: "string", description: 'Market symbol (e.g. "BTC-PERP")' },
+                interval: { type: "string", description: "Time interval (1h, 4h, 8h, 1d, 7d). Default: 1d", enum: ["1h", "4h", "8h", "1d", "7d"] },
+                limit: { type: "number", description: "Number of data points (default 7)" },
+            },
+            required: ["market"],
+        },
+        handler: async (args, api) => {
+            const market = requireString(args, "market");
+            const interval = optionalString(args, "interval", "1d");
+            const limit = optionalNumber(args, "limit", 7);
+            const data = await api.getFundingStats(market, interval, String(limit));
+            return JSON.stringify(data, null, 2);
+        },
+    },
+    // ─── Export ───────────────────────────────────────────────────────────
+    {
+        name: "export_data",
+        description: "Export historical data as CSV (Builder+ tier). Returns the download URL or raw data for a given event type and time range",
+        inputSchema: {
+            type: "object",
+            properties: {
+                event_type: { type: "string", description: "Data type to export (trades, fills, liquidations, funding_rates, book_snapshots, order_statuses, deposits, withdrawals)" },
+                market: { type: "string", description: "Optional market filter (e.g. BTC-PERP)" },
+                format: { type: "string", description: "Output format: csv or parquet. Default: csv", enum: ["csv", "parquet"] },
+            },
+            required: ["event_type"],
+        },
+        handler: async (args, api) => {
+            const eventType = requireString(args, "event_type");
+            const market = optionalString(args, "market", "");
+            const format = optionalString(args, "format", "csv");
+            const params = { event_type: eventType, format };
+            if (market)
+                params.market = market;
+            const data = await api.get("/v1/export", params);
+            return typeof data === "string" ? data : JSON.stringify(data, null, 2);
+        },
+    },
+    // ─── Triggers ────────────────────────────────────────────────────────
+    {
+        name: "list_triggers",
+        description: "List all webhook triggers configured for the authenticated user",
+        inputSchema: { type: "object", properties: {}, required: [] },
+        handler: async (_args, api) => {
+            const data = await api.listTriggers();
+            return JSON.stringify(data, null, 2);
+        },
+    },
+    {
+        name: "create_trigger",
+        description: "Create a rule-based webhook trigger that fires when market events match conditions (e.g. BTC price > 100000)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "Human-readable trigger name" },
+                channel: { type: "string", description: "Event channel to monitor (trades, fills, liquidations, funding_rates, etc.)" },
+                webhook_url: { type: "string", description: "HTTPS URL to receive webhook POST when trigger fires" },
+                rule: { type: "string", description: 'Rule as JSON string, e.g. {"condition":{"field":"data.price","op":"gt","value":"100000"}}' },
+            },
+            required: ["name", "channel", "webhook_url", "rule"],
+        },
+        handler: async (args, api) => {
+            const name = requireString(args, "name");
+            const channel = requireString(args, "channel");
+            const webhook_url = requireString(args, "webhook_url");
+            const ruleStr = requireString(args, "rule");
+            const rule = JSON.parse(ruleStr);
+            const data = await api.createTrigger({ name, channel, rule, webhook_url });
+            return JSON.stringify(data, null, 2);
+        },
+    },
+    {
+        name: "test_trigger",
+        description: "Test a trigger rule against a sample event without creating it — dry run evaluation",
+        inputSchema: {
+            type: "object",
+            properties: {
+                rule: { type: "string", description: "Rule as JSON string" },
+                event: { type: "string", description: "Sample event as JSON string to test against" },
+            },
+            required: ["rule", "event"],
+        },
+        handler: async (args, api) => {
+            const rule = JSON.parse(requireString(args, "rule"));
+            const event = JSON.parse(requireString(args, "event"));
+            const data = await api.testTrigger({ rule, event });
+            return JSON.stringify(data, null, 2);
+        },
+    },
+    // ─── Cohorts ─────────────────────────────────────────────────────────
+    {
+        name: "list_cohorts",
+        description: "List available address cohorts (predefined groups like top traders, market makers, plus custom cohorts)",
+        inputSchema: { type: "object", properties: {}, required: [] },
+        handler: async (_args, api) => {
+            const data = await api.listCohorts();
+            return JSON.stringify(data, null, 2);
+        },
+    },
+    {
+        name: "get_cohort_addresses",
+        description: "Get the wallet addresses in a specific cohort",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "Cohort name (e.g. top_traders, market_makers, or a custom cohort name)" },
+            },
+            required: ["name"],
+        },
+        handler: async (args, api) => {
+            const name = requireString(args, "name");
+            const data = await api.getCohortAddresses(name);
+            return JSON.stringify(data, null, 2);
+        },
+    },
+];
+//# sourceMappingURL=tools.js.map

package/build/tools.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@ironflowsh/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Ironflow market data — real-time and historical on-chain derivatives data for AI agents",
+  "author": "Ironflow <hello@ironflow.sh>",
+  "homepage": "https://docs.ironflow.sh/guides/ai-agents",
+  "bugs": {
+    "email": "support@ironflow.sh",
+    "url": "https://docs.ironflow.sh"
+  },
+  "type": "module",
+  "bin": {
+    "ironflow-mcp": "./build/index.js"
+  },
+  "scripts": {
+    "build": "tsc && chmod 755 build/index.js",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "prepublishOnly": "rm -rf build && npm run build"
+  },
+  "files": [
+    "build",
+    "!build/**/*.test.js",
+    "!build/**/*.test.d.ts",
+    "!build/**/*.test.js.map",
+    "!build/**/*.test.d.ts.map",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ironflow",
+    "market-data",
+    "crypto",
+    "defi",
+    "perpetuals",
+    "hyperliquid",
+    "ai-agents"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "typescript": "^5.8",
+    "vitest": "^4.1.0"
+  }
+}