@mrfentmen/nasdaq-mcp 0.0.0-stage → 1.0.1

package/README.md

@@ -1,3 +1,33 @@
-# Temporary Holding Version
+# Nasdaq Quotes
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Nasdaq stock data: live quotes, recent trade history and the most active listed stocks - keyless.
+
+Keyless — no signup, no API key, no environment variables.
+
+## Install
+
+```bash
+npx -y @mrfentmen/nasdaq-mcp
+```
+
+Or add it to your MCP client:
+
+```json
+{
+  "mcpServers": {
+    "nasdaq-mcp": { "command": "npx", "args": ["-y", "@mrfentmen/nasdaq-mcp"] }
+  }
+}
+```
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `stock_quote` | Quote for one listed symbol: price, change, volume and market status. |
+| `stock_history` | Recent daily bars for a symbol: close, open, high, low and volume. |
+| `top_stocks` | The Nasdaq screener list: symbol, name, last sale, change, market cap and sector. |
+
+## Data source
+
+Nasdaq public market site endpoints (api.nasdaq.com), no key required

package/dist/api.d.ts

@@ -0,0 +1,17 @@
+export declare class SourceError extends Error {
+}
+export declare function getJson(path: string, accept?: string, timeoutMs?: number): Promise<any>;
+export declare function clampLimit(n: number | undefined, fallback: number, max: number): number;
+export declare function clean(s: unknown): string;
+export declare function bullet(label: string, value: unknown): string;
+export declare function stockQuote(a: {
+    symbol: string;
+}): Promise<string>;
+export declare function stockHistory(a: {
+    symbol: string;
+    limit?: number;
+}): Promise<string>;
+export declare function topStocks(a: {
+    limit?: number;
+    offset?: number;
+}): Promise<string>;

package/dist/api.js

@@ -0,0 +1,138 @@
+/**
+ * Nasdaq Quotes — keyless public API client.
+ */
+const BASE = "https://api.nasdaq.com/api";
+const SOURCE = "Nasdaq Quotes";
+export class SourceError extends Error {
+}
+async function request(path, accept = "application/json", timeoutMs = 25000) {
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), timeoutMs);
+    try {
+        const res = await fetch(path.startsWith("http") ? path : BASE + path, {
+            signal: ctrl.signal,
+            headers: { "user-agent": "nasdaq-mcp", accept },
+        });
+        if (!res.ok)
+            throw new SourceError(`${SOURCE} responded ${res.status}`);
+        return res;
+    }
+    catch (e) {
+        if (e instanceof SourceError)
+            throw e;
+        if (e.name === "AbortError")
+            throw new SourceError(`${SOURCE} request timed out`);
+        throw new SourceError(`${SOURCE} request failed: ${e.message}`);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export async function getJson(path, accept = "application/json", timeoutMs = 25000) {
+    const res = await request(path, accept, timeoutMs);
+    const body = await res.text();
+    try {
+        return JSON.parse(body);
+    }
+    catch {
+        throw new SourceError(`${SOURCE} returned malformed JSON`);
+    }
+}
+export function clampLimit(n, fallback, max) {
+    const v = n ?? fallback;
+    if (!Number.isInteger(v) || v < 1 || v > max)
+        throw new SourceError(`limit must be between 1 and ${max}`);
+    return v;
+}
+export function clean(s) {
+    return String(s ?? "").replace(/\s+/g, " ").trim();
+}
+export function bullet(label, value) {
+    const v = value === undefined || value === null || value === "" ? "" : String(value);
+    return v ? `${label}: ${v}` : "";
+}
+function checkSymbol(value) {
+    const v = clean(value).toUpperCase();
+    if (!/^[A-Z0-9.\-]{1,10}$/.test(v))
+        throw new SourceError(`"${value}" is not a valid ticker symbol`);
+    return v;
+}
+export async function stockQuote(a) {
+    const symbol = checkSymbol(a.symbol);
+    const data = await getJson(`/quote/${encodeURIComponent(symbol)}/info?assetclass=stocks`, "application/json", 30000);
+    const d = data?.data;
+    if (!d || !d.symbol)
+        throw new SourceError(`Nasdaq has no quote for "${symbol}"`);
+    const primary = d.primaryData ?? {};
+    const secondary = d.secondaryData ?? {};
+    // Outside the regular session the primary block carries empty change fields
+    // and the last close lives in the secondary block, so fall back per field.
+    const changeRaw = clean(primary.netChange) || clean(secondary.netChange);
+    const pctRaw = clean(primary.percentageChange) || clean(secondary.percentageChange);
+    const delta = clean(clean(primary.netChange) ? primary.deltaIndicator : secondary.deltaIndicator);
+    const sign = !changeRaw ? "" : /^[+-]/.test(changeRaw) ? "" : delta === "up" ? "+" : delta === "down" ? "-" : "";
+    const changeText = changeRaw ? `  ${sign}${changeRaw}${pctRaw ? ` (${pctRaw})` : ""}` : "";
+    const lastPrice = clean(primary.lastSalePrice) || clean(secondary.lastSalePrice) || "n/a";
+    return [
+        `${clean(d.companyName)} (${clean(d.symbol)})${d.exchange ? ` · ${clean(d.exchange)}` : ""}`,
+        "",
+        `Price: ${lastPrice}${changeText}`,
+        bullet("market status", d.marketStatus),
+        bullet("as of", clean(primary.lastTradeTimestamp) || secondary.lastTradeTimestamp),
+        bullet("volume", secondary.volume),
+        bullet("today's range", secondary.todaysHigh && secondary.todaysLow ? `${clean(secondary.todaysHigh)} - ${clean(secondary.todaysLow)}` : ""),
+        bullet("52 week range", secondary.fiftTwoWeekHighLow?.high && secondary.fiftTwoWeekHighLow?.low ? `${clean(secondary.fiftTwoWeekHighLow.high)} - ${clean(secondary.fiftTwoWeekHighLow.low)}` : ""),
+        bullet("previous close", secondary.previousClose),
+    ].filter(Boolean).join("\n");
+}
+function isoDay(offsetDays) {
+    const d = new Date(Date.now() + offsetDays * 86400000);
+    return d.toISOString().slice(0, 10);
+}
+export async function stockHistory(a) {
+    const limit = clampLimit(a.limit, 10, 30);
+    const symbol = checkSymbol(a.symbol);
+    const todate = isoDay(0);
+    // Calendar days back, wide enough to cover `limit` trading days.
+    const fromdate = isoDay(-(limit * 2 + 10));
+    const data = await getJson(`/quote/${encodeURIComponent(symbol)}/historical?assetclass=stocks&fromdate=${fromdate}&todate=${todate}&limit=${limit}`, "application/json", 30000);
+    const rows = data?.data?.tradesTable?.rows;
+    if (!Array.isArray(rows) || !rows.length)
+        throw new SourceError(`Nasdaq has no history for "${symbol}"`);
+    const info = data?.data ?? {};
+    return [
+        `${symbol} recent bars${info.fromDate || info.toDate ? ` (${clean(info.fromDate)} to ${clean(info.toDate)})` : ""}:`,
+        "",
+        "date        close       open        high        low         volume",
+        ...rows.slice(0, limit).map((r) => [
+            clean(r?.date).padEnd(11),
+            clean(r?.close).padStart(10),
+            clean(r?.open).padStart(11),
+            clean(r?.high).padStart(11),
+            clean(r?.low).padStart(11),
+            clean(r?.volume).padStart(14),
+        ].join(" ")),
+    ].join("\n");
+}
+export async function topStocks(a) {
+    const limit = clampLimit(a.limit, 15, 50);
+    const offset = Math.floor(a.offset ?? 0);
+    if (!Number.isInteger(offset) || offset < 0 || offset > 5000)
+        throw new SourceError("offset must be between 0 and 5000");
+    const data = await getJson(`/screener/stocks?limit=${limit}&offset=${offset}`, "application/json", 30000);
+    const table = data?.data?.table;
+    const rows = table?.rows;
+    if (!Array.isArray(rows) || !rows.length)
+        throw new SourceError("Nasdaq returned no screener rows");
+    const total = Number(table?.totalrecords ?? data?.data?.totalrecords ?? rows.length);
+    return [
+        `Nasdaq screener (${total} symbols on record, showing ${rows.length} from offset ${offset}):`,
+        "",
+        ...rows.map((r, i) => {
+            const cap = clean(r?.marketCap);
+            const sector = clean(r?.sector);
+            const bits = [clean(r?.lastsale), clean(r?.pctchange), cap ? `cap ${cap}` : "", sector].filter(Boolean);
+            return `${String(offset + i + 1).padStart(4)}. ${clean(r?.symbol).padEnd(7)} ${clean(r?.name).slice(0, 40).padEnd(41)} ${bits.join(" · ")}`;
+        }),
+    ].join("\n");
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("nasdaq-mcp running on stdio");
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;

package/dist/server.js

@@ -0,0 +1,45 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { stockHistory, stockQuote, topStocks, SourceError } from "./api.js";
+const text = (t) => ({ content: [{ type: "text", text: t }] });
+function errorMessage(e) {
+    if (e instanceof SourceError || e instanceof Error)
+        return `Error: ${e.message}`;
+    return `Error: ${String(e)}`;
+}
+export function createServer() {
+    const server = new McpServer({ name: "nasdaq-mcp", version: "1.0.0" });
+    server.tool("stock_quote", "Quote for one listed symbol: price, change, volume and market status.", {
+        symbol: z.string().min(1).max(10).describe("Ticker symbol, e.g. AAPL")
+    }, async (a) => {
+        try {
+            return text(await stockQuote(a));
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: errorMessage(e) }], isError: true };
+        }
+    });
+    server.tool("stock_history", "Recent daily bars for a symbol: close, open, high, low and volume.", {
+        symbol: z.string().min(1).max(10).describe("Ticker symbol, e.g. MSFT"),
+        limit: z.number().int().min(1).max(30).default(10).describe("Bars to show")
+    }, async (a) => {
+        try {
+            return text(await stockHistory(a));
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: errorMessage(e) }], isError: true };
+        }
+    });
+    server.tool("top_stocks", "The Nasdaq screener list: symbol, name, last sale, change, market cap and sector.", {
+        limit: z.number().int().min(1).max(50).default(15).describe("Rows to show"),
+        offset: z.number().int().min(0).max(5000).default(0).describe("Rows to skip (paging)")
+    }, async (a) => {
+        try {
+            return text(await topStocks(a));
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: errorMessage(e) }], isError: true };
+        }
+    });
+    return server;
+}

package/package.json

@@ -1,6 +1,43 @@
 {
   "name": "@mrfentmen/nasdaq-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.1",
+  "description": "Nasdaq stock data: live quotes, recent trade history and the most active listed stocks - keyless.",
+  "type": "module",
+  "mcpName": "io.github.mrfentmen/nasdaq-mcp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mrfentmen/awesome-servers.git"
+  },
+  "bin": {
+    "nasdaq-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "stocks",
+    "nasdaq",
+    "quotes",
+    "markets",
+    "finance",
+    "keyless"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}