[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_123":124},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":21,"_24":25,"_26":27,"_28":29,"_30":31,"_32":33,"_34":25,"_35":36,"_37":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":-5,"_56":48,"_57":58,"_59":60,"_61":62,"_63":64,"_65":66,"_67":48,"_68":69,"_70":71,"_72":73,"_74":75,"_76":77,"_78":-5,"_79":-5,"_80":81,"_82":48,"_83":-5,"_84":85,"_86":87,"_88":89,"_90":91,"_92":93,"_94":95,"_96":97},"apiUrl","https://odel.app/api","creator","jessiejanie","moduleId","skim402","@jessiejanie/skim402","displayName","tagline","Clean markdown and structured web data. Free card API key; wallet/x402 pay-per-call optional.","iconKey","https://avatars.githubusercontent.com/u/258515360?v=4","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://skim402.com/api/mcp\",\"transport\":\"streamable-http\",\"authType\":\"headers\",\"requiredSecrets\":[{\"name\":\"X-Skim-Wallet-Key\",\"scope\":\"per-user\",\"header\":\"X-Skim-Wallet-Key\"}]}","pricingModel","free","creatorUserId","system:external-import","createdAt",1783335271000,"updatedAt",1788775556000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.JessieJanie%2Fskim402","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",2,"upstreamUpdatedAt",1788158148000,"detectedTransport","streamable-http","detectedAuthType","none","probeStatus","ok","lastProbedAt","githubRepoUrl","https://github.com/JessieJanie/skim402","githubRepoFullName","JessieJanie/skim402","releaseId","ext-jessiejanie-skim402","version","0.2.5","descriptionMarkdown","# skim-mcp\n\n**Skim is the complete web toolkit for AI agents—not just a simple page reader. Get a free card key at [skim402.com/pricing](https://skim402.com/pricing); wallet/x402 is optional.**\n\n[![npm version](https://img.shields.io/npm/v/skim-mcp.svg)](https://www.npmjs.com/package/skim-mcp)\n[![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue)](https://registry.modelcontextprotocol.io/v0/servers?search=skim402)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n\n`skim-mcp` is the official Model Context Protocol server for [Skim](https://skim402.com). It turns public pages into clean, agent-ready Markdown—typically ~4x smaller than raw HTML in Skim's measured comparisons—and exposes the full toolkit: clean reads, batch reads, JavaScript/browser rendering, structured extraction, crawling, PDFs, page-change watches, and curated Signals.\n\n**Default path: a card-plan API key.** Get a free `sk402_` key at [skim402.com](https://skim402.com) ([pricing](https://skim402.com/pricing)). Paste it as `SKIM_API_KEY`. A crypto wallet is **not** required.\n\n**Optional path: x402 wallet pay.** If you prefer pay-per-call in USDC on Base, you can set `SKIM_WALLET_PRIVATE_KEY` instead. Ignore this unless you want it.\n\n**Tools in this package:** `read_url`, `read_urls`, `extract_url`, `crawl_url`, `read_pdf`, `watch_urls`, `check_watch`, `poll_signal`.\n\n> **Try before you integrate:** use the [Playground](https://skim402.com/playground) for a quick read or the [Workbench](https://skim402.com/workbench) to test batches, extraction, crawl, PDFs, watches, and Signals.\n\n![Skim in action — one URL in, clean Markdown out](https://raw.githubusercontent.com/JessieJanie/skim402/main/demo.gif)\n\n---\n\n## Quickstart (60 seconds)\n\n### Card API key (recommended)\n\n**1.** Get a free key at **[skim402.com](https://skim402.com)** — it starts with `sk402_`. Card required at signup; 1,000 reads/month on the free plan. Details: [skim402.com/pricing](https://skim402.com/pricing).\n\n**2.** Add this to your MCP client. **Claude Desktop** — `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows). **Cursor** — `~/.cursor/mcp.json` (or **Settings → MCP**). Same JSON works in Cline, Continue, Zed, and other MCP clients:\n\n```json\n{\n \"mcpServers\": {\n \"skim\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"skim-mcp\"],\n \"env\": {\n \"SKIM_API_KEY\": \"sk402_your_key_here\"\n }\n }\n }\n}\n```\n\n**3.** Restart the client and ask it to read a URL:\n\n```\nRead https://en.wikipedia.org/wiki/HTTP_402 and summarize it.\n```\n\n---\n\n### Wallet / x402 (optional)\n\nOnly if you prefer pay-per-call ($0.002 USDC on Base) instead of a card key. You can skip this entire block.\n\n```json\n{\n \"mcpServers\": {\n \"skim\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"skim-mcp\"],\n \"env\": {\n \"SKIM_WALLET_PRIVATE_KEY\": \"0xYOUR_BASE_WALLET_PRIVATE_KEY\"\n }\n }\n }\n}\n```\n\nFund a **dedicated** Base wallet with a small USDC balance ($1 ≈ 500 reads). Setup guide: ****.\n\n> **Use a fresh wallet, not your personal one.** This private key lives in a plaintext config file on your machine — treat it like a hot wallet for $0.002 tolls, not a savings account.\n\n---\n\n## FAQ\n\n**Do I need an API key?** \nYes for the default path. Get a free `sk402_` key at [https://skim402.com](https://skim402.com). A wallet is optional.\n\n**Is this wallet-only? Do I need crypto?** \nNo. Card API key is the default. x402 wallet pay is optional.\n\n**What tools can my agent call?** \n`read_url`, `read_urls` (batch), `extract_url`, `crawl_url`, `read_pdf`, `watch_urls`, `check_watch`, and `poll_signal`.\n\n---\n\n## Try it without an agent\n\nWith a card key:\n\n```bash\ncurl -H 'Authorization: Bearer sk402_your_key_here' \\\n 'https://skim402.com/api/t/read?url=https://en.wikipedia.org/wiki/HTTP_402'\n```\n\nWallet / x402 challenge (optional — returns HTTP 402 if you send no payment):\n\n```bash\ncurl -i -X POST https://skim402.com/api/v1/read \\\n -H 'content-type: application/json' \\\n -d '{\"url\":\"https://en.wikipedia.org/wiki/HTTP_402\"}'\n```\n\n---\n\n## The tools\n\n### `read_url`\n\nReads any URL and returns clean Markdown with a YAML frontmatter block.\n\n**Input:** `{ \"url\": \"https://example.com/article\" }`\n\n**Routes:** `GET /api/t/read?url=` (API key) · `POST /api/v1/read` (wallet)\n\n**Output:**\n\n```\n---\ntitle: Example article\nbyline: Jane Doe\npublished: 2025-01-15\nlang: en\nexcerpt: A short summary...\n---\n\n# Example article\n\nThe cleaned article body in Markdown...\n```\n\n### `read_urls`\n\nBatch-read 1–10 URLs in one call. Optional `stripLinks` / `stripImages`.\n\n**Input:** `{ \"urls\": [\"https://a.example\", \"https://b.example\"] }`\n\n**Routes:** `POST /api/t/read/batch` · `POST /api/v1/read/batch`\n\n### `extract_url`\n\nStructured JSON from a page. Pass a JSON Schema, or a preset: `article`, `product`, `job`, `review`, `event`, `table`.\n\n**Input:** `{ \"url\": \"https://example.com/product\", \"preset\": \"product\" }`\n\n**Routes:** `POST /api/t/extract` · `POST /api/v1/extract`\n\nPresets are sent as schemas on those extract routes.\n\n### `crawl_url`\n\nCrawl a site (origin or start URL) and return clean Markdown per page. Discovers `sitemap.xml` / `robots.txt` sitemaps plus same-origin links. Cap 25 pages. **1 credit per successful page**; failed pages are not charged.\n\n**Input:** `{ \"url\": \"https://example.com\", \"maxPages\": 10 }`\n\nOptional: `stripLinks`, `stripImages`. Bare hosts like `example.com` are treated as `https://example.com`.\n\n**Route:** `POST /api/t/crawl` (API key). No x402 `/v1` twin — set `SKIM_API_KEY`.\n\n```\nCrawl https://example.com (max 10 pages) and list the page titles.\n```\n\n### `read_pdf`\n\nFetch a public PDF URL and return clean Markdown plus an optional bookmark outline. Text comes only from the file. Image-only scans return **422** (no OCR). Files larger than **8 MB** return **413**. **3 credits**; failed conversions are not charged.\n\n**Input:** `{ \"url\": \"https://example.com/paper.pdf\" }`\n\nOptional: `outline` (default `true`).\n\n**Route:** `POST /api/t/read-pdf` (API key). No x402 `/v1` twin — set `SKIM_API_KEY`.\n\n```\nRead the PDF at https://example.com/paper.pdf and summarize the outline.\n```\n\n### `poll_signal`\n\nPoll a [Skim Signal](https://skim402.com/signals) and return the latest structured items (title, summary, source, timestamp, link, entities). **2 credits** per successful poll; failed polls are refunded.\n\n**Requires `SKIM_API_KEY`.** Wallet-only configs get a clear error.\n\n**Input:** `{ \"slug\": \"ai-news\", \"limit\": 20 }`\n\nOptional filters (pass only those the feed documents): `forms` (sec-filings, campaign-finance), `categories` (deals), `fields` (research), `states` (film-incentives), `committees` (campaign-finance).\n\n**Slugs:** `ai-news`, `sec-filings`, `crypto-news`, `macro`, `security`, `regulations`, `courts`, `recalls`, `deals`, `launches`, `trending`, `research`, `energy`, `entertainment`, `studio-jobs`, `campaign-finance`, `film-incentives`. Use `x402` for the ecosystem feed.\n\n**Routes (API key):** `GET /api/t/signal/{slug}/latest?limit=` · `GET /api/t/feeds/x402/latest?limit=` (x402 is not `/signal/x402`)\n\n```bash\ncurl -H 'Authorization: Bearer sk402_your_key_here' \\\n 'https://skim402.com/api/t/signal/ai-news/latest?limit=20'\n```\n\n```\nPoll the ai-news signal for the latest 20 items.\n```\n\n### `watch_urls` / `check_watch`\n\nRegister 1–20 URLs, then poll for content diffs. `watch_id` is a secret.\n\n**Input:** `{ \"urls\": [\"https://competitor.com/pricing\"], \"note\": \"pricing\" }` then `{ \"watch_id\": \"w_…\" }` (optional `status_only: true`)\n\n**Routes (API key):** `POST /api/t/watch` · `GET /api/t/watch/diff?id=` · `GET /api/t/watch/status?id=`\n\n**Routes (wallet):** `POST /api/v2/watch` · `GET /api/v2/watch/diff?id=` · `GET /api/v2/watch/status?id=`\n\n### Example agent prompts\n\n```\nRead https://en.wikipedia.org/wiki/HTTP_402 and summarize it.\n\nRead these three pages and compare their pricing: https://a.example/pricing https://b.example/pricing https://c.example/pricing\n\nExtract the product name, price, and availability from https://example.com/products/notebook as JSON.\n\nCrawl https://example.com (max 10 pages) and list the page titles.\n\nRead the PDF at https://example.com/paper.pdf and summarize it.\n\nPoll the ai-news signal for the latest 20 items.\n\nWatch https://competitor.com/pricing and https://competitor.com/changelog, then check the watch for changes.\n```\n\n---\n\n## Configuration\n\n| Variable | Required | Default | Notes |\n| ------------------------- | --------------------- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `SKIM_API_KEY` | **yes** (or wallet) | — | Card-plan API key (`sk402_...`). Get one free at [skim402.com](https://skim402.com) / [pricing](https://skim402.com/pricing). Takes priority over `SKIM_WALLET_PRIVATE_KEY`. |\n| `SKIM_WALLET_PRIVATE_KEY` | optional | — | Only if you are not using a card key. Hex private key for a dedicated Base wallet that pays x402 reads ($0.002 USDC/call). Ignored when `SKIM_API_KEY` is set. Never use a personal wallet. |\n| `SKIM_MAX_PRICE_USD` | no | `0.01` | Wallet lane only. Hard cap on per-call price in USD. Single reads are `$0.002`. Batch / extract / watch cost more — raise this (e.g. `0.05`) if the wallet lane rejects those calls. |\n| `SKIM_API_URL` | no | `https://skim402.com` | Override the API base URL. For self-hosting or local development. |\n| `SKIM_TIMEOUT_MS` | no | `90000` | Hard deadline per call in milliseconds. Aborts stalled requests so a single bad call can never hang your agent. Unsettled calls are never charged, so retry is safe. |\n\n---\n\n## How it actually works\n\n**Card lane (default):**\n\n```\nyour agent ──► skim-mcp ──► GET https://skim402.com/api/t/read?url=…\n Authorization: Bearer sk402_...\n │\n ▼\n 200 OK + clean Markdown\n```\n\n**Wallet lane (x402, optional):**\n\n```\nyour agent ──► skim-mcp ──► POST https://skim402.com/api/v1/read\n ▲ │\n │ ▼\n │ 402 Payment Required\n │ (x402 challenge)\n │ │\n ▼ │\n x402-fetch signs EIP-3009 ◄────────────┘\n USDC transfer authorization\n │\n ▼\n retry POST with X-PAYMENT header\n │\n ▼\n Skim verifies + settles via Coinbase CDP\n │\n ▼\n 200 OK + clean Markdown\n```\n\nEnd-to-end latency is typically **1.5–2 seconds** including settlement. Wallet-lane private keys never leave your machine — they only sign authorizations locally.\n\n---\n\n## Security\n\n- **Card key:** stored in your MCP client's JSON config. Anyone with read access to that file can use your key. Keep your key on the free plan or a small-balance plan.\n- **Wallet key (only if you use the optional wallet path):** lives in the same JSON config in plaintext. Anyone with access to your home directory can drain the wallet. Keep it funded with only as much USDC as you're willing to spend in a runaway loop.\n- **No outbound telemetry from this package.** `skim-mcp` only talks to `skim402.com` (or whatever you set as `SKIM_API_URL`). No analytics, no error reporting, no phone-home.\n\n---\n\n## Troubleshooting\n\n**\"No tool named `read_url` shows up in Claude/Cursor.\"**\nRestart the client fully (quit, don't just reload the window). MCP servers are spawned at client startup. If still missing, run `npx skim-mcp` directly in a terminal — if you get a stack trace, it's likely Node < 18.\n\n**\"401 Unauthorized\" with card key.**\nYour `SKIM_API_KEY` is invalid or expired. Get a fresh one at [skim402.com/pricing](https://skim402.com/pricing).\n\n**\"402 Payment Required loops forever\" (wallet lane).**\nYour wallet is out of USDC on Base mainnet. Check the balance on [BaseScan](https://basescan.org/), top up if needed.\n\n**\"USDC is on Ethereum, not Base.\"**\nThis is the most common funding mistake. USDC on Ethereum mainnet does not work — Skim only accepts USDC on Base. See for the bridging walkthrough.\n\n---\n\n## Links\n\n- **Skim website** — \n- **Pricing & free key** — \n- **Wallet setup guide** — \n- **API docs** — \n- **x402 protocol** — \n- **Model Context Protocol** — \n- **GitHub** — \n\n---\n\n## License\n\nMIT\n","changelogMarkdown","videoKey","requiredSecretsJson","[{\"name\":\"X-Skim-Wallet-Key\",\"scope\":\"per-user\",\"header\":\"X-Skim-Wallet-Key\"}]","publishedAt","priceCents","trialDays",0,"iconType","image","upstream",{"_106":107,"_108":109,"_110":111,"_112":113,"_114":115,"_116":117},"requiredSecrets",[100],"tags",[],"assets",[],"stats",{"_98":85,"_99":85},"ratingAvg","reviewCount",{"_101":102,"_103":104,"_105":102},"name","X-Skim-Wallet-Key","scope","per-user","header","topics",[],"license","MIT","language","TypeScript","registryName","io.github.JessieJanie/skim402","homepage","https://skim402.com","packages",[118],{"_119":120,"_121":122,"_74":75},"registryType","npm","identifier","skim-mcp","ENV",{"_125":126,"_127":128,"_129":130},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]