pulsefeed-x402-mcp 1.0.0

package/README.md

@@ -0,0 +1,37 @@
+# pulsefeed-x402-mcp
+
+MCP server for the **x402 agent-payment ecosystem**. Gives AI agents (Claude Desktop, Cursor, Cline, Windsurf, VS Code) tools to navigate x402:
+
+- **`x402_working_services`** — list x402 services that are actually alive (≈85% are dead/invalid).
+- **`check_x402_endpoint`** — verify an endpoint returns a valid x402 challenge before paying it.
+- **`pulsefeed_products`** — PulseFeed's paid on-chain intelligence products (Base token pulse, whale alerts, smart-money flow, momentum, trust oracle).
+
+Backed by [PulseFeed](https://pulsefeed.dev/status).
+
+## Use in Claude Desktop / Cursor / Cline
+
+```json
+{
+  "mcpServers": {
+    "pulsefeed-x402": {
+      "command": "npx",
+      "args": ["-y", "pulsefeed-x402-mcp"]
+    }
+  }
+}
+```
+
+## Local run
+```bash
+npm install
+npm run start      # tsx dev run
+# or build + run:
+npm run build && node dist/index.js
+```
+
+Config: `PULSEFEED_URL` env overrides the backend base URL.
+
+## Publish (maintainer)
+```bash
+npm run build && npm publish --access public
+```

package/dist/index.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+// PulseFeed MCP server — самодостаточный, зовёт публичные эндпоинты PulseFeed.
+// Даёт агентам в Claude Desktop / Cursor / Cline инструменты для навигации по x402-экосистеме.
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+const BASE = process.env.PULSEFEED_URL || "https://pulsefeed.dev";
+const server = new McpServer({ name: "pulsefeed-x402", version: "1.0.0" });
+server.registerTool("x402_working_services", {
+    description: "List x402 agent-payment services that are currently ALIVE and return a valid x402 challenge, ranked by trust score. About 85% of x402 endpoints are dead or invalid — use this to avoid paying broken or scam endpoints. Free.",
+    inputSchema: {},
+}, async () => {
+    const r = await fetch(`${BASE}/status.json`);
+    const j = await r.json();
+    return { content: [{ type: "text", text: JSON.stringify(j, null, 2) }] };
+});
+server.registerTool("check_x402_endpoint", {
+    description: "Before paying an unknown x402 endpoint, check whether it is live and returns a valid x402 payment challenge. Returns liveness, price, network and a pay/avoid verdict. For full uptime + reputation, use PulseFeed's paid /trust API.",
+    inputSchema: { url: z.string().describe("The x402 endpoint URL to verify") },
+}, async ({ url }) => {
+    const out = { url, reachable: false, valid: false };
+    try {
+        const ctrl = new AbortController();
+        const t = setTimeout(() => ctrl.abort(), 12000);
+        const res = await fetch(url, { signal: ctrl.signal, headers: { accept: "application/json" } });
+        clearTimeout(t);
+        out.reachable = true;
+        out.status = res.status;
+        if (res.status === 402) {
+            const b = await res.json().catch(() => null);
+            const a = b?.accepts?.[0];
+            out.valid = !!a;
+            if (a) {
+                out.price = a.maxAmountRequired;
+                out.network = a.network;
+                out.asset = a.asset;
+                out.payTo = a.payTo;
+            }
+        }
+    }
+    catch (e) {
+        out.error = e?.name === "AbortError" ? "timeout" : e?.message;
+    }
+    out.verdict = out.valid ? "live — valid x402, safe to consider paying" : "avoid — no valid x402 challenge";
+    out.fullReputation = `${BASE}/trust?endpoint=${encodeURIComponent(url)} (paid: adds uptime + reputation history)`;
+    return { content: [{ type: "text", text: JSON.stringify(out, null, 2) }] };
+});
+server.registerTool("pulsefeed_products", {
+    description: "List PulseFeed's paid x402 products — real-time Base on-chain intelligence for AI agents: token pulse, whale alerts, smart-money accumulation/distribution, momentum, and the x402 trust oracle — and how to pay via x402.",
+    inputSchema: {},
+}, async () => {
+    const r = await fetch(`${BASE}/`);
+    const j = await r.json();
+    return { content: [{ type: "text", text: JSON.stringify(j, null, 2) }] };
+});
+await server.connect(new StdioServerTransport());
+console.error("pulsefeed-x402 MCP server running on stdio");

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "pulsefeed-x402-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for the x402 agent-payment ecosystem: find working x402 services, verify endpoints before paying, and access PulseFeed real-time Base on-chain intelligence.",
+  "type": "module",
+  "bin": { "pulsefeed-x402-mcp": "dist/index.js" },
+  "files": ["dist"],
+  "keywords": ["mcp", "x402", "agents", "onchain", "base", "crypto", "trust", "model-context-protocol"],
+  "scripts": {
+    "build": "tsc",
+    "prepare": "tsc",
+    "start": "node --import tsx index.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3"
+  }
+}