coinopai-mcp 1.0.0

package/README.md

@@ -0,0 +1,54 @@
+# coinopai-mcp
+
+MCP server for [CoinOpAI](https://x402.coinopai.com) — agent automation prompts and crypto signals, paid per-call with USDC on Base via the x402 protocol.
+
+## What you get
+
+| Tool | What it does | Cost |
+|------|-------------|------|
+| `search_agent_automations` | Search 819 agent automation prompts | $0.01 |
+| `get_agent_automation` | Full prompt + workflow steps by slug | $0.01 |
+| `list_automation_categories` | All 35 categories with counts | $0.005 |
+| `get_crypto_signals` | Latest hourly BTC/ETH/SOL/XRP/ADA signals | $0.05 |
+| `get_crypto_risk` | Current risk state + regime detection | $0.02 |
+| `get_crypto_signal_history` | Up to 168h of signal history | $0.05 |
+
+No API keys. No subscriptions. Pay only for what you use.
+
+## Requirements
+
+- A Base wallet with USDC funded (any amount — $1 goes a long way at these prices)
+- Node.js 18+
+
+## Install in Claude Code
+
+Add to your `~/.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "coinopai": {
+      "command": "npx",
+      "args": ["coinopai-mcp"],
+      "env": {
+        "WALLET_PRIVATE_KEY": "0x<your-base-wallet-private-key>"
+      }
+    }
+  }
+}
+```
+
+Then restart Claude Code. The tools appear automatically.
+
+## Get a wallet
+
+1. Install [Coinbase Wallet](https://wallet.coinbase.com) or use any EVM wallet
+2. Switch to Base network
+3. Buy or bridge a small amount of USDC
+4. Export your private key and add it to the config above
+
+## How payment works
+
+Each tool call makes a real HTTP request to `x402.coinopai.com`. The server returns a `402 Payment Required` response with the price. The MCP server automatically signs a USDC micropayment using your wallet and resends the request. You get the data. The fee lands on Base mainnet.
+
+No human approval needed per call — configure once, pay automatically.

package/index.js

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+"use strict";
+
+const { Server } = require("@modelcontextprotocol/sdk/server/index.js");
+const { StdioServerTransport } = require("@modelcontextprotocol/sdk/server/stdio.js");
+const { CallToolRequestSchema, ListToolsRequestSchema } = require("@modelcontextprotocol/sdk/types.js");
+const { x402Client, x402HTTPClient } = require("@x402/core/client");
+const { ExactEvmScheme, registerExactEvmScheme } = require("@x402/evm/exact/client");
+const { toClientEvmSigner } = require("@x402/evm");
+const { x402Facilitator } = require("@x402/core/facilitator");
+const { createWalletClient, http, publicActions } = require("viem");
+const { base } = require("viem/chains");
+const { privateKeyToAccount } = require("viem/accounts");
+const { facilitator: coinbaseFacilitator } = require("@coinbase/x402");
+
+const BASE_URL = "https://x402.coinopai.com";
+
+const TOOLS = [
+  {
+    name: "search_agent_automations",
+    description: "Search 819 agent automation prompts by keyword. Returns matching automations with title, description, complexity and services. Costs $0.01 USDC.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: { type: "string", description: "Search keyword (e.g. 'slack', 'notion', 'github')" },
+        limit: { type: "number", description: "Max results to return (default 20, max 50)" }
+      },
+      required: ["query"]
+    }
+  },
+  {
+    name: "get_agent_automation",
+    description: "Get the full agent automation prompt and workflow steps by slug. Costs $0.01 USDC.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        slug: { type: "string", description: "Automation slug (e.g. 'slack-to-notion')" }
+      },
+      required: ["slug"]
+    }
+  },
+  {
+    name: "list_automation_categories",
+    description: "List all 35 automation categories with counts. Costs $0.005 USDC.",
+    inputSchema: { type: "object", properties: {} }
+  },
+  {
+    name: "get_crypto_signals",
+    description: "Latest hourly directional signals for BTC, ETH, SOL, XRP, ADA from the Kronos model. Positive = bullish, negative = bearish. Costs $0.05 USDC.",
+    inputSchema: { type: "object", properties: {} }
+  },
+  {
+    name: "get_crypto_risk",
+    description: "Current crypto market risk state (NORMAL/ELEVATED/HIGH), regime detection, equity tracking, signal streaks. Costs $0.02 USDC.",
+    inputSchema: { type: "object", properties: {} }
+  },
+  {
+    name: "get_crypto_signal_history",
+    description: "Historical hourly crypto signals from Kronos — up to 168 hours of BTC/ETH/SOL/XRP/ADA data. Costs $0.05 USDC.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        hours: { type: "number", description: "Hours of history to fetch (default 24, max 168)" }
+      }
+    }
+  }
+];
+
+function buildHttpClient() {
+  const key = process.env.WALLET_PRIVATE_KEY;
+  if (!key) throw new Error("WALLET_PRIVATE_KEY required — set a Base wallet private key with USDC funded");
+
+  const pk = key.startsWith("0x") ? key : "0x" + key;
+  const account = privateKeyToAccount(pk);
+  const walletClient = createWalletClient({ account, chain: base, transport: http() }).extend(publicActions);
+  const signer = toClientEvmSigner(account, walletClient);
+  const facilitator = new x402Facilitator(coinbaseFacilitator);
+  const client = x402Client.from({ schemes: [registerExactEvmScheme(new ExactEvmScheme(), signer)] });
+
+  return new x402HTTPClient(client);
+}
+
+async function call(httpClient, path) {
+  const resp = await httpClient.fetch(BASE_URL + path);
+  if (!resp.ok) {
+    const body = await resp.text().catch(() => resp.statusText);
+    throw new Error(`HTTP ${resp.status}: ${body.slice(0, 200)}`);
+  }
+  return resp.json();
+}
+
+async function main() {
+  let httpClient;
+  try {
+    httpClient = buildHttpClient();
+  } catch (e) {
+    process.stderr.write("[coinopai-mcp] " + e.message + "\n");
+    process.exit(1);
+  }
+
+  const server = new Server(
+    { name: "coinopai-mcp", version: "1.0.0" },
+    { capabilities: { tools: {} } }
+  );
+
+  server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+
+  server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const { name, arguments: args } = req.params;
+    try {
+      let data;
+      switch (name) {
+        case "search_agent_automations":
+          data = await call(httpClient, `/api/search?q=${encodeURIComponent(args.query || "")}&limit=${args.limit || 20}`);
+          break;
+        case "get_agent_automation":
+          data = await call(httpClient, `/api/automation/${encodeURIComponent(args.slug)}`);
+          break;
+        case "list_automation_categories":
+          data = await call(httpClient, "/api/categories");
+          break;
+        case "get_crypto_signals":
+          data = await call(httpClient, "/api/kronos/signals");
+          break;
+        case "get_crypto_risk":
+          data = await call(httpClient, "/api/kronos/risk");
+          break;
+        case "get_crypto_signal_history":
+          data = await call(httpClient, `/api/kronos/history?hours=${args.hours || 24}`);
+          break;
+        default:
+          throw new Error("Unknown tool: " + name);
+      }
+      return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: "Error: " + e.message }], isError: true };
+    }
+  });
+
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+main();

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "coinopai-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for CoinOpAI — agent automation prompts and crypto signals via x402 micropayments on Base",
+  "main": "index.js",
+  "bin": {
+    "coinopai-mcp": "index.js"
+  },
+  "files": [
+    "index.js",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "node index.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "x402",
+    "agent",
+    "automation",
+    "crypto",
+    "signals",
+    "coinbase",
+    "base",
+    "usdc",
+    "micropayments",
+    "claude"
+  ],
+  "author": "CoinOpAI",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/coinopai/coinopai-mcp"
+  },
+  "homepage": "https://x402.coinopai.com",
+  "dependencies": {
+    "@coinbase/x402": "^2.1.0",
+    "@modelcontextprotocol/sdk": "^1.10.1",
+    "@x402/core": "^2.11.0",
+    "@x402/evm": "^2.11.0",
+    "viem": "^2.0.0"
+  }
+}