@onchainpulse/mcp-server 1.0.0

package/README.md

@@ -0,0 +1,52 @@
+# OnChain Pulse MCP Server
+
+Official Model Context Protocol (MCP) server for OnChain Pulse Intelligence. This server provides a secure bridge between AI agents and real-time institutional blockchain data.
+
+## 🔐 Hybrid-Auth V3 Architecture
+
+This server supports two methods of authentication and monetization:
+
+1. **SaaS Mode (API Key):** Users with an active OnChain Pulse account can use their `PULSE_API_KEY`. Credits are deducted from their Cerebro balance ($0.05 per query).
+2. **Agentic Mode (x402 / Solana Pay):** Autonomous agents can bypass API keys by providing a valid Solana transaction hash (`x-solana-pay-tx`) for 0.05 SOL.
+
+## 🛠️ Tools Available
+
+- `get_latest_alpha`: Intercept high-conviction institutional whale movements.
+- `check_wallet_reputation`: Verify insider status and wallet intent.
+- `get_terminal_stats`: Access global performance metrics (Win Rate, Avg ROI).
+
+## 🚀 Installation
+
+### 1. Via NPX (Recommended for Agents)
+```bash
+export PULSE_API_KEY=your_key_here
+npx @onchainpulse/mcp-server
+```
+
+### 2. Manual Config (Claude Desktop)
+Add this to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "onchain-pulse": {
+      "command": "npx",
+      "args": ["-y", "@onchainpulse/mcp-server"],
+      "env": {
+        "PULSE_API_KEY": "YOUR_ACTUAL_API_KEY"
+      }
+    }
+  }
+}
+```
+
+## 🛡️ Security Mandate
+
+- **Stateless:** The server does not store any keys locally. All authentication is injected via environment variables.
+- **Sanitized:** All error messages are sanitized to prevent API key leaks in logs.
+- **Anti-Replay:** The x402 system includes a 10-minute window and a global registry of processed transaction hashes to prevent double-spending.
+
+## 📄 Support
+
+Technical specs: [https://onchainpulse.online/pulse-mcp](https://onchainpulse.online/pulse-mcp)
+Developer support: `robinaffiliateclaw@gmail.com`

package/index.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+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 fetch from "node-fetch";
+
+const API_KEY = process.env.PULSE_API_KEY;
+const API_URL = "http://178.156.252.122:3001/api/v1/mcp";
+
+if (!API_KEY) {
+  console.error("Error: PULSE_API_KEY environment variable is required.");
+  process.exit(1);
+}
+
+const server = new Server({
+  name: "onchain-pulse",
+  version: "1.0.0",
+}, {
+  capabilities: { tools: {} }
+});
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: "get_latest_alpha",
+      description: "Obtain the most recent institutional whale signals from OnChain Pulse.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          limit: { type: "number", default: 5, description: "Number of signals to retrieve." }
+        }
+      }
+    },
+    {
+      name: "check_wallet_reputation",
+      description: "Verify if a wallet address is a known 'Insider' or 'Smart Wallet'.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          address: { type: "string", description: "The Solana or Base address to check." }
+        },
+        required: ["address"]
+      }
+    },
+    {
+      name: "get_terminal_stats",
+      description: "Get global performance metrics (Win Rate, Avg ROI) from the OnChain Pulse ecosystem.",
+      inputSchema: { type: "object", properties: {} }
+    }
+  ]
+}));
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  let action;
+  if (name === "get_latest_alpha") action = "get_signals";
+  else if (name === "check_wallet_reputation") action = "check_reputation";
+  else if (name === "get_terminal_stats") action = "get_stats";
+
+  try {
+    const res = await fetch(API_URL, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "x-pulse-key": API_KEY },
+      body: JSON.stringify({ 
+        action,
+        payload: args
+      })
+    });
+
+    const data = await res.json();
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  } catch (error) {
+    return { content: [{ type: "text", text: `Error connecting to Pulse: ${error.message}` }], isError: true };
+  }
+});
+
+async function run() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("OnChain Pulse MCP Server running");
+}
+
+run().catch(console.error);

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@onchainpulse/mcp-server",
+  "version": "1.0.0",
+  "description": "Official OnChain Pulse MCP Server. Real-time institutional liquidity surveillance for AI agents.",
+  "main": "index.js",
+  "type": "module",
+  "bin": {
+    "onchainpulse-mcp": "./index.js"
+  },
+  "scripts": {
+    "start": "node index.js"
+  },
+  "keywords": [
+    "mcp",
+    "onchain-pulse",
+    "ai-agents",
+    "blockchain",
+    "solana",
+    "alpha"
+  ],
+  "author": "OnChain Pulse",
+  "license": "ISC",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.1",
+    "node-fetch": "^3.3.2"
+  }
+}