@pipeworx/mcp-pulse-verity 0.1.0 → 0.2.0

package/tools.json

@@ -0,0 +1,156 @@
+[
+  {
+    "name": "pulse_signed_price",
+    "description": "The current CRYPTOGRAPHICALLY SIGNED index price for one crypto asset, from the Pulse Verity Index across thousands of assets and dozens of venues — this result carries a signature you can verify: pass it unchanged to pulse_verify_print to check it OFFLINE, with no network call, against Pulse's public key. Each print carries signature, kid, grade, the number of independent venues (sources), dispersion in basis points and a confidence interval. Grades: consensus (3+ venues) and blended (2) are settleable; indicative (1 venue) is NOT. Use it when a price has to be defensible — settlement, an audit trail, a dispute — not merely current. Requires a Pulse API key via _apiKey. Example: pulse_signed_price({ symbol: \"BTC\" }).",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "symbol": {
+          "type": "string",
+          "description": "Asset ticker as Pulse spells it, e.g. BTC, ETH, SOL. pulse_asset_catalog lists coverage."
+        },
+        "_apiKey": {
+          "type": "string",
+          "description": "Pulse Verity API key. Free and self-serve at https://thepulse.markets/developers (60 req/min, 25,000/month, no card)."
+        }
+      },
+      "required": [
+        "symbol"
+      ]
+    }
+  },
+  {
+    "name": "pulse_signed_batch",
+    "description": "Signed index prices for up to 100 crypto assets in ONE call — each row carries its own signature you can verify individually with pulse_verify_print, offline, with no network call, not just the batch as a whole. Use this instead of looping pulse_signed_price: it is one request against the rate limit and every observation still carries its own signature, grade, venue count and interval. Symbols Pulse does not serve come back named in not_served rather than silently missing. Requires a Pulse API key via _apiKey. Example: pulse_signed_batch({ symbols: [\"BTC\", \"ETH\", \"SOL\"] }).",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "symbols": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Up to 100 tickers. A comma-separated string is also accepted."
+        },
+        "_apiKey": {
+          "type": "string",
+          "description": "Pulse Verity API key. Free and self-serve at https://thepulse.markets/developers (60 req/min, 25,000/month, no card)."
+        }
+      },
+      "required": [
+        "symbols"
+      ]
+    }
+  },
+  {
+    "name": "pulse_settlement_print",
+    "description": "The signed index print Pulse RECORDED nearest a past moment — the tool for settling a contract, pricing an option at expiry, or reconstructing what an asset was worth at a specific timestamp. Returns the observation with its original signature intact — verify it offline with pulse_verify_print, no network call — plus delta_ms, the distance between the time you asked for and the print actually returned; it is the nearest recorded print, never a price synthesised at your exact instant. Accepts ISO-8601 or epoch milliseconds. Requires a Pulse API key via _apiKey. Example: pulse_settlement_print({ symbol: \"BTC\", at: \"2026-09-16T21:41:46.000Z\" }).",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "symbol": {
+          "type": "string",
+          "description": "Asset ticker, e.g. BTC."
+        },
+        "at": {
+          "type": "string",
+          "description": "The moment to price, as ISO-8601 (2026-09-16T21:41:46.000Z) or epoch milliseconds."
+        },
+        "_apiKey": {
+          "type": "string",
+          "description": "Pulse Verity API key. Free and self-serve at https://thepulse.markets/developers (60 req/min, 25,000/month, no card)."
+        }
+      },
+      "required": [
+        "symbol",
+        "at"
+      ]
+    }
+  },
+  {
+    "name": "pulse_verify_print",
+    "description": "Check whether a Pulse signed price print is authentic and unaltered — pass a print back exactly as a Pulse tool returned it and this recomputes the ECDSA P-256 / SHA-256 signature over the canonical string, entirely OFFLINE with no network call to Pulse. WHAT A valid:true RESULT PROVES: that Pulse asserted this exact price, for this symbol, at this timestamp, at this grade, and that nobody altered any of those fields in transit — it detects a single changed digit of price or a one-millisecond shift in the timestamp. WHAT IT DOES NOT PROVE: that the price is CORRECT or reflects the true market — this checks Pulse's signature, not the world, so a print can verify perfectly and still be a price Pulse itself got wrong. The verification is computed here, not asked of Pulse, so Pulse cannot vouch for a print it never signed and an offline or compromised source cannot turn an invalid print into a valid one. Needs NO API key. Example: pulse_verify_print({ symbol: \"BTC\", priceText: \"76051.0676303142\", price: 76051.0676303142, at: \"2026-09-16T23:39:30.524Z\", grade: \"consensus\", signature: \"wiD005d9...\", kid: \"pvi-Sl40p5Gj2t_-JyKUhxyg\" }).",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "symbol": {
+          "type": "string",
+          "description": "From the print, unchanged."
+        },
+        "price": {
+          "type": "number",
+          "description": "From the print. Used only if priceText is absent."
+        },
+        "priceText": {
+          "type": "string",
+          "description": "The price EXACTLY as Pulse served it. This is what was signed — prefer it always."
+        },
+        "at": {
+          "type": "string",
+          "description": "From the print, unchanged. A 1ms difference invalidates the signature."
+        },
+        "grade": {
+          "type": "string",
+          "description": "From the print: consensus, blended or indicative."
+        },
+        "signature": {
+          "type": "string",
+          "description": "Base64 signature from the print."
+        },
+        "kid": {
+          "type": "string",
+          "description": "Key id from the print; selects which public key to check against."
+        },
+        "sig": {
+          "type": "string",
+          "description": "Scheme tag from the print (pulse-index-v1)."
+        }
+      },
+      "required": [
+        "symbol",
+        "at",
+        "grade",
+        "signature"
+      ]
+    }
+  },
+  {
+    "name": "pulse_asset_catalog",
+    "description": "Which crypto assets the Pulse Verity Index covers, at what grade, across how many venues, and how fast each one actually updates — cadence measured per asset from its own update intervals rather than from a poll schedule. Filter by coverage band (real-time, five-second, ten-second, slow, unavailable) or status (consensus, blended, indicative). Call this to find out whether a symbol is covered, and how thin it is, before quoting it. NOTE: these rows are UNSIGNED, including their prices — read a verifiable number through pulse_signed_price. Requires a Pulse API key via _apiKey. Example: pulse_asset_catalog({ limit: 5 }).",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "limit": {
+          "type": "number",
+          "description": "Rows to return, max 500 (default 50)."
+        },
+        "offset": {
+          "type": "number",
+          "description": "Row offset for paging."
+        },
+        "band": {
+          "type": "string",
+          "description": "Cadence band: real-time, five-second, ten-second, slow, unavailable."
+        },
+        "status": {
+          "type": "string",
+          "description": "Coverage grade: consensus, blended, indicative."
+        },
+        "_apiKey": {
+          "type": "string",
+          "description": "Pulse Verity API key. Free and self-serve at https://thepulse.markets/developers (60 req/min, 25,000/month, no card)."
+        }
+      },
+      "required": []
+    }
+  },
+  {
+    "name": "pulse_key_ring",
+    "description": "The public keys Pulse signs its price prints with, as PEM and JWK, plus the signing algorithm and the exact canonical string format — everything needed to verify a signed print yourself, OFFLINE, with no network call to Pulse. Use it to write your own verifier, or to audit what pulse_verify_print (this pack's ready-made offline checker) is checking against. Needs NO API key. Example: pulse_key_ring({}).",
+    "inputSchema": {
+      "type": "object",
+      "properties": {},
+      "required": []
+    }
+  }
+]