wickedapi-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WickedAPI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,67 @@
+# WickedAPI MCP Server
+
+MCP server for [WickedAPI](https://api.wickedapi.com) — an agent-ready trading & market-data API covering crypto/stock prices, OHLCV, technical indicators (ATR, Fair Value Gaps, ICT liquidity levels), perp funding/OI, order books, Kalshi prediction markets, DeFi TVL, volatility, a verified macro calendar, an earnings calendar, and an AI momentum score.
+
+Tools are generated automatically from the live [`openapi.json`](https://api.wickedapi.com/openapi.json), so the tool list always matches what's actually deployed.
+
+## No signup required
+
+Every tool call hits a real `/v1/*` endpoint that's gated by [x402](https://x402.org) (HTTP-native pay-per-call, USDC on Base) with an API-key fallback:
+
+- **Zero config** — calls without credentials still work; you'll get back the real `402` payment challenge (price, network, `payTo`) as the tool result.
+- **Autonomous pay-per-call** — set `WICKEDAPI_PAYER_PRIVATE_KEY` to a funded Base-mainnet wallet's private key, and every call auto-pays ~$0.001 in USDC and returns real data. No account, no subscription.
+- **Partner API key** — set `WICKEDAPI_API_KEY` for free, rate-limited access if you have one.
+
+## Install
+
+```json
+{
+  "mcpServers": {
+    "wickedapi": {
+      "command": "npx",
+      "args": ["-y", "wickedapi-mcp"],
+      "env": {
+        "WICKEDAPI_API_KEY": "your-key-here"
+      }
+    }
+  }
+}
+```
+
+Or for autonomous pay-per-call instead of a key:
+
+```json
+{
+  "mcpServers": {
+    "wickedapi": {
+      "command": "npx",
+      "args": ["-y", "wickedapi-mcp"],
+      "env": {
+        "WICKEDAPI_PAYER_PRIVATE_KEY": "0xyour-base-wallet-private-key"
+      }
+    }
+  }
+}
+```
+
+## Environment variables
+
+| Var | Required | Notes |
+| --- | --- | --- |
+| `WICKEDAPI_API_KEY` | no | Free, rate-limited access if you have a partner key. |
+| `WICKEDAPI_PAYER_PRIVATE_KEY` | no | Base-mainnet wallet private key. If set, every call auto-pays the x402 challenge in USDC — no key needed. |
+| `WICKEDAPI_BASE_URL` | no | Override the API base (default `https://api.wickedapi.com`). |
+
+If neither `WICKEDAPI_API_KEY` nor `WICKEDAPI_PAYER_PRIVATE_KEY` is set, calls still succeed at the protocol level — you'll get the real `402` challenge back as the tool result instead of data.
+
+## Local development
+
+```bash
+npm install
+npm run build
+node dist/index.js
+```
+
+## What this is not
+
+This server doesn't reimplement any data logic — it's a thin, auto-generated bridge from MCP tool calls to the live WickedAPI HTTP endpoints. All the actual market data, indicators, and scoring live in the API itself.

package/dist/index.js

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+const BASE_URL = (process.env.WICKEDAPI_BASE_URL || "https://api.wickedapi.com").replace(/\/$/, "");
+const API_KEY = process.env.WICKEDAPI_API_KEY;
+const PAYER_KEY = process.env.WICKEDAPI_PAYER_PRIVATE_KEY;
+// If a funded Base-mainnet wallet key is provided, every call auto-pays the
+// x402 402 challenge in USDC — no API key or signup needed at all. Loaded
+// lazily so a plain API-key setup never has to pull in viem/x402-fetch.
+async function buildFetcher() {
+    if (!PAYER_KEY)
+        return fetch;
+    const [{ createWalletClient, http }, { privateKeyToAccount }, { base }, { wrapFetchWithPayment }] = await Promise.all([
+        import("viem"),
+        import("viem/accounts"),
+        import("viem/chains"),
+        import("x402-fetch"),
+    ]);
+    const account = privateKeyToAccount(PAYER_KEY);
+    const wallet = createWalletClient({ account, chain: base, transport: http() });
+    console.error(`[wickedapi-mcp] x402 auto-pay enabled — wallet ${account.address}`);
+    // x402-fetch's Signer type expects a client extended with viem's public
+    // actions; the proven pattern in scripts/x402-bot-test.mjs passes a plain
+    // wallet client the same way — cast rather than pull in publicActions.
+    return wrapFetchWithPayment(fetch, wallet);
+}
+function toolNameFromPath(path) {
+    return path.replace(/^\/v1\//, "").replace(/-/g, "_");
+}
+function zodForParam(p) {
+    const type = p.schema?.type;
+    const base = type === "number" ? z.coerce.number() : type === "boolean" ? z.coerce.boolean() : z.string();
+    const described = p.description ? base.describe(p.description) : base;
+    return p.required ? described : described.optional();
+}
+async function main() {
+    const specRes = await fetch(`${BASE_URL}/openapi.json`);
+    if (!specRes.ok) {
+        throw new Error(`Failed to load ${BASE_URL}/openapi.json: HTTP ${specRes.status}`);
+    }
+    const doc = (await specRes.json());
+    const doFetch = await buildFetcher();
+    const server = new McpServer({ name: "wickedapi", version: "0.1.0" });
+    let registered = 0;
+    for (const [path, methods] of Object.entries(doc.paths)) {
+        const op = methods.get;
+        if (!op || !path.startsWith("/v1/") || path === "/v1/status")
+            continue;
+        const shape = {};
+        for (const p of op.parameters ?? []) {
+            if (p.in !== "query")
+                continue;
+            shape[p.name] = zodForParam(p);
+        }
+        server.registerTool(toolNameFromPath(path), {
+            description: [op.summary, op.description].filter(Boolean).join(" — ").slice(0, 1000),
+            inputSchema: shape,
+        }, async (args) => {
+            const url = new URL(BASE_URL + path);
+            for (const [k, v] of Object.entries(args ?? {})) {
+                if (v !== undefined && v !== null)
+                    url.searchParams.set(k, String(v));
+            }
+            const headers = {};
+            if (API_KEY)
+                headers["x-api-key"] = API_KEY;
+            const r = await doFetch(url.toString(), { headers });
+            const text = await r.text();
+            let body;
+            try {
+                body = JSON.parse(text);
+            }
+            catch {
+                body = text;
+            }
+            return {
+                isError: !r.ok,
+                content: [{ type: "text", text: JSON.stringify(body, null, 2) }],
+            };
+        });
+        registered++;
+    }
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`[wickedapi-mcp] ready — ${registered} tools loaded from ${BASE_URL}/openapi.json`);
+}
+main().catch((err) => {
+    console.error("[wickedapi-mcp] fatal:", err);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "wickedapi-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for WickedAPI — agent-ready trading & market-data API (crypto/stock prices, indicators, prediction markets, DeFi, macro, AI momentum score). No signup required: pay per call in USDC via x402, or use a partner API key.",
+  "type": "module",
+  "bin": {
+    "wickedapi-mcp": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "homepage": "https://api.wickedapi.com",
+  "bugs": {
+    "url": "https://api.wickedapi.com"
+  },
+  "author": "WickedAPI",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "trading",
+    "crypto",
+    "stocks",
+    "market-data",
+    "x402",
+    "agent"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "viem": "^2.55.2",
+    "x402-fetch": "^1.2.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.1",
+    "typescript": "^5.9.3"
+  }
+}