skim-mcp 0.2.2 → 0.2.4

package/README.md

@@ -6,7 +6,7 @@
 [![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue)](https://registry.modelcontextprotocol.io/v0/servers?search=skim402)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
 
-`skim-mcp` is the official Model Context Protocol server for [Skim](https://skim402.com) — the clean reader API for AI agents. It exposes `read_url`, `read_urls` (batch), `extract_url` (structured / table), `crawl_url`, `read_pdf`, `watch_urls`, and `check_watch`. The default path is a card-plan API key (`SKIM_API_KEY`); x402 wallet pay stays optional.
+`skim-mcp` is the official Model Context Protocol server for [Skim](https://skim402.com) — the clean reader API for AI agents. It exposes `read_url`, `read_urls` (batch), `extract_url` (structured / table), `crawl_url`, `read_pdf`, `watch_urls`, `check_watch`, and `poll_signal`. The default path is a card-plan API key (`SKIM_API_KEY`); x402 wallet pay stays optional.
 
 > **See it before you wire it:** [try Skim free in your browser](https://freeskims.skim402.com) — 10 free skims a day, no signup. Paste a URL, see exactly what your agent gets back.
 
@@ -177,6 +177,27 @@ Register 1–20 URLs, then poll for content diffs. `watch_id` is a secret.
 
 Card-lane `/api/t/watch*` is live (POST without a key returns `401`). Optional HTTPS `webhookUrl` is supported by the API; this MCP tool still sends `{ urls, note? }`.
 
+### `poll_signal`
+
+Poll a [Skim Signal](https://skim402.com/signals) and return the latest structured items (title, summary, source, timestamp, link, and entities). **2 credits** per successful poll; failed polls are refunded.
+
+**Requires `SKIM_API_KEY`.** Wallet-only configs get a clear error: the live `GET /api/v2/...` wallet twin uses a v2 402 with an empty body, which the current `x402-fetch` wrapper does not handle.
+
+**Input:** `{ "slug": "ai-news", "limit": 20 }`
+
+Optional documented filters: `forms` (SEC filings and campaign finance), `categories` (deals), `fields` (research), `states` (film incentives), and `committees` (campaign finance).
+
+**Routes (API key):** `GET /api/t/signal/{slug}/latest?limit=` · `GET /api/t/feeds/x402/latest?limit=` (x402 is not `/signal/x402`)
+
+```bash
+curl -H 'Authorization: Bearer sk402_your_key_here' \
+  'https://skim402.com/api/t/signal/ai-news/latest?limit=20'
+```
+
+```
+Poll the ai-news Signal for the latest 20 items.
+```
+
 ### Example agent prompts
 
 ```
@@ -190,6 +211,8 @@ Crawl https://example.com (max 10 pages) and list the page titles.
 
 Read the PDF at https://example.com/paper.pdf and summarize it.
 
+Poll the ai-news Signal for the latest 20 items.
+
 Watch https://competitor.com/pricing and https://competitor.com/changelog, then check the watch for changes.
 ```
 

package/dist/index.js

@@ -4,7 +4,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { privateKeyToAccount } from "viem/accounts";
 import { wrapFetchWithPayment } from "x402-fetch";
 import { z } from "zod";
-const VERSION = "0.2.1";
+const VERSION = "0.2.4";
 const BASE_URL = (process.env.SKIM_API_URL ?? "https://skim402.com").replace(/\/+$/, "");
 const API_KEY = process.env.SKIM_API_KEY ?? "";
 const PRIVATE_KEY = process.env.SKIM_WALLET_PRIVATE_KEY ?? "";
@@ -154,6 +154,14 @@ function authMissing() {
 function cardLaneOnly(tool, path) {
     return fail(`${tool} is card-lane only (${path}) — there is no x402 /v1 twin. Set SKIM_API_KEY (sk402_..., free tier at skim402.com/pricing). Wallet pay still works for read_url, read_urls, extract_url, and watch.`);
 }
+const SIGNAL_SLUGS = [
+    "ai-news", "sec-filings", "crypto-news", "macro", "security", "regulations",
+    "courts", "recalls", "deals", "launches", "trending", "research", "energy",
+    "entertainment", "studio-jobs", "campaign-finance", "film-incentives", "x402",
+];
+function signalPollPath(slug) {
+    return slug === "x402" ? "/api/t/feeds/x402/latest" : `/api/t/signal/${slug}/latest`;
+}
 function buildUrl(path, query) {
     const url = new URL(path, `${BASE_URL}/`);
     if (query) {
@@ -485,6 +493,41 @@ server.tool("check_watch", "Poll a Skim Watch for content changes (or fetch regi
         return fail(requestFailedMessage(err));
     }
 });
+server.tool("poll_signal", "Poll a Skim Signal feed and return the latest structured items (title, summary, source, timestamp, link, entities). 2 credits per successful poll; failed polls are refunded. Card lane: GET /api/t/signal/{slug}/latest?limit= (filters: forms, categories, fields, states, committees). The x402 ecosystem feed is GET /api/t/feeds/x402/latest — never /signal/x402. Requires SKIM_API_KEY. No x402-fetch-compatible wallet twin (GET /api/v2/... returns a v2 402 with an empty body).", {
+    slug: z.enum(SIGNAL_SLUGS).describe("Signal slug from skim402.com/signals. Use x402 for the ecosystem feed, not /signal/x402."),
+    limit: z.number().int().min(1).max(100).optional().describe("Max items, newest-first. Default 50, capped at 100."),
+    forms: z.string().optional().describe("Comma-separated form filter. sec-filings: 8-K, S-1, 10-K, 10-Q, SC 13D, SC 13G, 4. campaign-finance: F1, F2, F3, F3P, F3X, F3L, F24, F5, F6, F9, F13, F99."),
+    categories: z.string().optional().describe("deals only. Comma-separated category terms (1–8, each 2–40 chars), e.g. laptop,gpu."),
+    fields: z.string().optional().describe("research only. Comma-separated arXiv fields: ai, ml, nlp, vision, robotics, agents, security, quantum."),
+    states: z.string().optional().describe("film-incentives only. Comma-separated two-letter states: CA, NY, GA, NM, TX."),
+    committees: z.string().optional().describe("campaign-finance only. Comma-separated committee-name substrings (1–8, each 2–60 chars), e.g. turning point,dnc."),
+}, async ({ slug, limit, forms, categories, fields, states, committees }) => {
+    if (!hasAuth)
+        return authMissing();
+    if (!cardLane) {
+        return fail("poll_signal is card-lane only (GET /api/t/signal/{slug}/latest or GET /api/t/feeds/x402/latest) — set SKIM_API_KEY (sk402_..., free tier at skim402.com/pricing). The wallet twin returns a v2 402 with an empty body, which the existing x402-fetch wrapper does not handle.");
+    }
+    try {
+        const query = {};
+        if (limit !== undefined)
+            query.limit = String(limit);
+        if (forms)
+            query.forms = forms;
+        if (categories)
+            query.categories = categories;
+        if (fields)
+            query.fields = fields;
+        if (states)
+            query.states = states;
+        if (committees)
+            query.committees = committees;
+        const res = await skimFetch("GET", signalPollPath(slug), { query });
+        return ok(JSON.stringify(await readJson(res), null, 2));
+    }
+    catch (err) {
+        return fail(requestFailedMessage(err));
+    }
+});
 const transport = new StdioServerTransport();
 await server.connect(transport);
 if (cardLane) {

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "skim-mcp",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "mcpName": "io.github.JessieJanie/skim402",
-  "description": "MCP server for Skim — clean web reader for AI agents. Card API key or x402 wallet. Batch, extract, crawl, PDF, watch.",
+  "description": "MCP server for Skim — clean web reader for AI agents. Card API key or x402 wallet. Batch, extract, crawl, PDF, watch, signals.",
   "type": "module",
   "bin": {
     "skim-mcp": "dist/index.js"
@@ -13,13 +13,6 @@
     "README.md",
     "LICENSE"
   ],
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json && node -e \"require('fs').chmodSync('dist/index.js', 0o755)\"",
-    "typecheck": "tsc --noEmit",
-    "dev": "tsx src/index.ts",
-    "prepublishOnly": "pnpm build",
-    "postinstall": "npm install -g tsx@4.21.0"
-  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
     "viem": "^2.21.0",
@@ -56,5 +49,11 @@
   "license": "MIT",
   "engines": {
     "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node -e \"require('fs').chmodSync('dist/index.js', 0o755)\"",
+    "typecheck": "tsc --noEmit",
+    "dev": "tsx src/index.ts",
+    "postinstall": "npm install -g tsx@4.21.0"
   }
-}
+}