crypto-com-mcp 1.0.1 → 1.0.3

package/README.md

@@ -18,3 +18,5 @@ node dist/index.js
 ```
 
 Data comes from the public Crypto.com API.
+
+

package/dist/api.js

@@ -20,3 +20,57 @@ export async function ticker(args) {
         `High: ${t.h ?? '?'} | Low: ${t.l ?? '?'} | Volume: ${t.v ?? '?'}`,
     ].filter(Boolean).join('\n');
 }
+export async function orderBook(args) {
+    const symbol = (args.symbol ?? '').trim().toUpperCase();
+    if (!symbol)
+        return 'Provide a symbol like BTC_USDT.';
+    const depth = Math.max(1, Math.min(Math.trunc(args.depth ?? 10), 50));
+    const res = await fetch(`https://api.crypto.com/v2/public/get-book?instrument_name=${encodeURIComponent(symbol)}&depth=${depth}`, {
+        headers: { 'User-Agent': UA, Accept: 'application/json' },
+        signal: AbortSignal.timeout(20000),
+    });
+    if (!res.ok)
+        throw new Error(`Crypto.com returned ${res.status}`);
+    const d = (await res.json());
+    if (d.code !== 0)
+        throw new Error(`Crypto.com: ${d.msg ?? `code ${d.code}`}`);
+    const book = (d.result?.data ?? [])[0];
+    if (!book)
+        throw new Error(`Crypto.com: no order book for ${symbol}`);
+    const level = ([price, qty], i) => `  ${i + 1}. ${price ?? 'not reported'} x ${qty ?? 'not reported'}`;
+    const bids = (book.bids ?? []).slice(0, depth).map(level);
+    const asks = (book.asks ?? []).slice(0, depth).map(level);
+    return [
+        `Crypto.com ${symbol} order book, ${depth} level(s) per side:`,
+        'Bids (highest first):',
+        ...(bids.length ? bids : ['  none reported']),
+        'Asks (lowest first):',
+        ...(asks.length ? asks : ['  none reported']),
+    ].join('\n');
+}
+// ---- up1 tools:
+const V1 = 'https://api.crypto.com/exchange/v1/public';
+export async function instruments(args) {
+    const limit = Math.max(1, Math.min(Math.trunc(args.limit ?? 25), 100));
+    const query = (args.query ?? '').trim().toUpperCase();
+    const res = await fetch(`${V1}/get-instruments`, {
+        headers: { 'User-Agent': UA, Accept: 'application/json' },
+        signal: AbortSignal.timeout(25000),
+    });
+    if (!res.ok)
+        throw new Error(`Crypto.com returned ${res.status}`);
+    const d = (await res.json());
+    if (d.code !== 0)
+        throw new Error(`Crypto.com: ${d.message ?? `code ${d.code}`}`);
+    const all = d.result?.data ?? [];
+    if (!all.length)
+        throw new Error('Crypto.com returned no instruments');
+    const matches = query
+        ? all.filter((r) => (r.symbol ?? '').toUpperCase().includes(query) || (r.base_ccy ?? '').toUpperCase() === query)
+        : all;
+    if (!matches.length)
+        return `No Crypto.com instrument matches "${args.query ?? ''}" (${all.length} instruments returned).`;
+    const rows = matches.slice(0, limit);
+    const lines = rows.map((r, i) => `  ${i + 1}. ${r.symbol ?? '?'} - ${r.inst_type ?? 'not reported'} - ${r.base_ccy ?? '?'}/${r.quote_ccy ?? '?'} - tradable ${r.tradable === undefined ? 'not reported' : r.tradable}`);
+    return [`Crypto.com instruments (${rows.length} shown of ${matches.length} matching ${all.length} total):`, ...lines].join('\n');
+}

package/dist/server.js

@@ -1,6 +1,6 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
-import { ticker } from "./api.js";
+import { ticker, orderBook, instruments } from "./api.js";
 const text = (value) => ({ content: [{ type: "text", text: value }] });
 const textError = (t) => ({ content: [{ type: "text", text: t }], isError: true });
 const READ_ONLY = { readOnlyHint: true, openWorldHint: true };
@@ -17,7 +17,61 @@ export function createServer() {
             return text(await ticker(args));
         }
         catch (e) {
-            return textError(error(e));
+            return textError(String(e));
+        }
+    });
+    server.registerTool("order_book", {
+        title: "Order book",
+        description: "Live Crypto.com order book for an instrument: top bid and ask levels with price and quantity.",
+        inputSchema: z.object({ symbol: z.string().describe("Symbol like BTC_USDT."), depth: z.number().describe("Levels per side, 1-50.").optional() }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        try {
+            return text(await orderBook(args));
+        }
+        catch (e) {
+            return textError(String(e));
+        }
+    });
+    server.registerTool("candles", {
+        title: "Candles",
+        description: "OHLCV candles for a Crypto.com instrument: open, high, low, close and volume per interval.",
+        inputSchema: z.object({ symbol: z.string().describe("Symbol like BTC_USDT."), timeframe: z.string().describe("1m, 5m, 15m, 30m, 1h, 4h, 6h, 12h, 1d, 7d, 14d or 1M.").optional(), count: z.number().describe("How many candles, 1-200.").optional() }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        // TODO: implement candles locally (paywall removed)
+        try {
+            return textError("Not yet implemented: candles");
+        }
+        catch (e) {
+            return textError(String(e));
+        }
+    });
+    server.registerTool("trades", {
+        title: "Recent trades",
+        description: "Most recent trades on a Crypto.com instrument: time, side, price and quantity.",
+        inputSchema: z.object({ symbol: z.string().describe("Symbol like BTC_USDT."), limit: z.number().describe("How many trades, 1-50.").optional() }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        // TODO: implement trades locally (paywall removed)
+        try {
+            return textError("Not yet implemented: trades");
+        }
+        catch (e) {
+            return textError(String(e));
+        }
+    });
+    server.registerTool("instruments", {
+        title: "Instruments",
+        description: "Search the Crypto.com instrument list by symbol or base currency, with instrument type and tradability.",
+        inputSchema: z.object({ query: z.string().describe("Symbol or base currency, e.g. 'BTC'.").optional(), limit: z.number().describe("How many to show, 1-100.").optional() }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        try {
+            return text(await instruments(args));
+        }
+        catch (e) {
+            return textError(String(e));
         }
     });
     return server;

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.1",
+  "version": "1.0.3",
   "type": "module",
   "repository": {
     "type": "git",
@@ -41,4 +41,4 @@
     "node": ">=20"
   },
   "mcpName": "io.github.mrfentmen/crypto-com-mcp"
-}
+}