crypto-market-data-mcp 0.1.2 → 0.1.3

package/README.md

@@ -15,6 +15,9 @@ subscription, and a call that fails is never charged.
 | `sentiment` | Fear and Greed, trending coins, breadth, mood | $0.003 |
 | `coin_snapshot` | All of the above for one coin | $0.005 |
 | `hyperliquid_wallet` | Positions, liquidation distance, risk label, PnL, volume for any address | $0.01 |
+| `create_watch` | Up to 10 conditions (price, % change, funding, open interest, liquidations, order book, Fear and Greed, whale orders, news impact) checked every minute for 24 hours; a signed webhook when one happens | $0.02 |
+| `watch_status` | A watch's status and its last 20 fires | free |
+| `stop_watch` | Stop a watch | free |
 | `service_info` | What is offered and what this session has spent | free |
 
 Data refreshes every minute from 24/7 monitoring of Binance spot and futures, Hyperliquid and 31 news sources.
@@ -58,7 +61,7 @@ gasless. Use a dedicated wallet with a small balance.
 
 ## Spending limits
 
-- `X402_MAX_PER_CALL_USD` (default `0.01`): no single payment above this.
+- `X402_MAX_PER_CALL_USD` (default `0.02`, the price of a watch): no single payment above this.
 - `X402_MAX_TOTAL_USD` (default `1.00`): no more payments after this much in a session.
 
 Without a key, `prices` and `sentiment` work free, with data refreshed every 15 minutes. `service_info` works too,

package/index.js

@@ -4,7 +4,7 @@
 // wallet in X402_PRIVATE_KEY, within hard spending caps. No account or API key is needed.
 //
 //   X402_PRIVATE_KEY      0x... key of a wallet holding a little USDC on Base (required for paid tools)
-//   X402_MAX_PER_CALL_USD refuse any single payment above this (default 0.01)
+//   X402_MAX_PER_CALL_USD refuse any single payment above this (default 0.02, the price of a watch)
 //   X402_MAX_TOTAL_USD    stop paying after this much per session (default 1.00)
 //   CMD_API_URL           API base (default https://crypto-market-data.zafermemon87.workers.dev)
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -21,7 +21,7 @@ function cap(name, dflt) {
   const v = Number((process.env[name] || "").trim() || dflt);
   return Number.isFinite(v) && v >= 0 ? Math.round(v * USDC_UNITS) : 0; // an unreadable cap pays nothing, never "no limit"
 }
-const maxPerCall = cap("X402_MAX_PER_CALL_USD", "0.01");
+const maxPerCall = cap("X402_MAX_PER_CALL_USD", "0.02");
 const maxTotal = cap("X402_MAX_TOTAL_USD", "1.00");
 let spent = 0;
 
@@ -37,13 +37,14 @@ function client() {
 const text = (obj) => ({ content: [{ type: "text", text: typeof obj === "string" ? obj : JSON.stringify(obj, null, 1) }] });
 const fail = (msg) => ({ ...text(msg), isError: true });
 
-async function call(path, query) {
+async function call(path, query, { method = "GET", data, headers = {} } = {}) {
   const url = new URL(API + path);
   for (const [k, v] of Object.entries(query || {})) if (v !== undefined && v !== null && v !== "") url.searchParams.set(k, String(v));
-  const first = await fetch(url);
+  const init = data === undefined ? { method, headers } : { method, headers: { ...headers, "Content-Type": "application/json" }, body: JSON.stringify(data) };
+  const first = await fetch(url, init);
   if (first.status !== 402) return first.ok ? text(await first.json()) : fail(`API answered ${first.status}: ${await first.text()}`);
   const pay = client();
-  if (!pay && FREE[path]) {
+  if (!pay && method === "GET" && FREE[path]) {
     // no wallet: the free copy of this data, refreshed every 15 minutes
     const free = await fetch(API + FREE[path] + url.search);
     const body = await free.json().catch(() => ({}));
@@ -51,21 +52,21 @@ async function call(path, query) {
     return text({ ...body, note: "Free data refreshed every 15 minutes. Set X402_PRIVATE_KEY (a wallet with a little USDC on Base) " +
       "for live data every minute." });
   }
-  if (!pay) return fail("This tool costs a fraction of a cent per call, paid in USDC on Base. Set X402_PRIVATE_KEY to a wallet " +
+  if (!pay) return fail("This tool is paid per call (USD 0.003 to 0.02) in USDC on Base. Set X402_PRIVATE_KEY to a wallet " +
     "holding a little USDC on Base (no ETH needed), or use the same data on Apify: https://apify.com/zaffy_93/crypto-market-data");
   const required = pay.getPaymentRequiredResponse((n) => first.headers.get(n), await first.json().catch(() => undefined));
   const amount = Number(required.accepts[0].amount);
   if (!(amount > 0) || amount > maxPerCall) return fail(`Price ${amount / USDC_UNITS} USDC is above X402_MAX_PER_CALL_USD (${maxPerCall / USDC_UNITS}); not paid.`);
   if (spent + amount > maxTotal) return fail(`Session budget X402_MAX_TOTAL_USD (${maxTotal / USDC_UNITS}) reached (${spent / USDC_UNITS} USDC spent); not paid.`);
   const payload = await pay.createPaymentPayload(required);
-  const paid = await fetch(url, { headers: pay.encodePaymentSignatureHeader(payload) });
+  const paid = await fetch(url, { ...init, headers: { ...init.headers, ...pay.encodePaymentSignatureHeader(payload) } });
   const body = await paid.json().catch(() => ({}));
   if (paid.status === 200 && paid.headers.get("PAYMENT-RESPONSE")) spent += amount;
   // 400/503 answers are not settled by the API, so they cost nothing
   return paid.ok ? text(body) : fail(`Not answered (${paid.status}), not charged: ${body.error || JSON.stringify(body)}`);
 }
 
-const server = new McpServer({ name: "crypto-market-data", version: "0.1.2" });
+const server = new McpServer({ name: "crypto-market-data", version: "0.1.3" });
 const tokens = z.string().optional().describe("Comma-separated tickers such as BTC,ETH,SOL (up to 50). Empty means the top 50 coins.");
 const token = z.string().optional().describe("One ticker such as BTC");
 const limit = z.number().int().min(1).max(200).optional().describe("How many rows");
@@ -92,6 +93,42 @@ for (const [name, path, description, shape] of tools) {
     }
   });
 }
+// Watches: conditions checked every minute for 24 hours, with a signed webhook (or status polling) when one happens.
+const METRICS = ["price", "change_5m_pct", "change_1h_pct", "change_4h_pct", "change_24h_pct", "funding_8h_pct", "futures_premium_pct",
+  "open_interest_change_1h_pct", "open_interest_change_24h_pct", "long_short_account_ratio", "spread_bps", "orderbook_imbalance",
+  "buyer_share_15m", "volume_15m_vs_normal", "liquidations_1h_usd", "liquidations_long_1h_usd", "liquidations_short_1h_usd", "fear_greed",
+  "whale_order_usd", "news_impact"];
+const condition = z.object({
+  token: z.string().optional().describe("Ticker such as BTC; \"*\" (any coin) for whale_order_usd and news_impact; omit for fear_greed"),
+  metric: z.enum(METRICS),
+  op: z.enum(["above", "below"]).describe("above: >= value; below: <= value (events use above)"),
+  value: z.number().describe("Threshold in the metric's unit: percent for *_pct, USD for *_usd"),
+});
+server.registerTool("create_watch", {
+  description: "Watch the crypto market for 24 hours: up to 10 conditions (price, % change, funding, open interest, liquidations, " +
+    "order book, Fear and Greed, whale orders, news impact) checked every minute; when one happens, a signed webhook goes to " +
+    "callback_url and it shows in watch_status. Level conditions fire when they turn true. Keep the returned secret (USD 0.02).",
+  inputSchema: { conditions: z.array(condition).min(1).max(10), callback_url: z.string().optional().describe("https URL for the webhook (optional)"),
+    label: z.string().max(80).optional() },
+}, async (args) => {
+  try {
+    return await call("/v1/watch", null, { method: "POST", data: args });
+  } catch (e) {
+    return fail(`Request failed: ${e.message}`);
+  }
+});
+const watchRef = { watch_id: z.string().describe("watch_id from create_watch"), secret: z.string().describe("secret from create_watch") };
+for (const [name, method, description] of [["watch_status", "GET", "Free: a watch's status, conditions and its last 20 fires."],
+  ["stop_watch", "DELETE", "Free: stop a watch before it expires."]]) {
+  server.registerTool(name, { description, inputSchema: watchRef }, async ({ watch_id, secret }) => {
+    try {
+      return await call(`/watch/${encodeURIComponent(watch_id)}`, null, { method, headers: { "X-Watch-Secret": secret } });
+    } catch (e) {
+      return fail(`Request failed: ${e.message}`);
+    }
+  });
+}
+
 server.registerTool("service_info", { description: "Free: what the service offers, prices, and session spending so far.", inputSchema: {} },
   async () => {
     const info = await (await fetch(API + "/")).json();

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":  "crypto-market-data-mcp",
-    "version":  "0.1.2",
+    "version":  "0.1.3",
     "type":  "module",
     "dependencies":  {
                          "@modelcontextprotocol/sdk":  "1.32.1",

package/server.json

@@ -7,7 +7,7 @@
     "url": "https://github.com/zaffy18/crypto-market-data-mcp",
     "source": "github"
   },
-  "version": "0.1.2",
+  "version": "0.1.3",
   "remotes": [
     {
       "type": "streamable-http",
@@ -18,7 +18,7 @@
     {
       "registryType": "npm",
       "identifier": "crypto-market-data-mcp",
-      "version": "0.1.2",
+      "version": "0.1.3",
       "transport": {
         "type": "stdio"
       },
@@ -31,7 +31,7 @@
         },
         {
           "name": "X402_MAX_PER_CALL_USD",
-          "description": "No single payment above this (default 0.01)",
+          "description": "No single payment above this (default 0.02, the price of a watch)",
           "isRequired": false,
           "isSecret": false
         },