README

Thunderbit MCP Server

Open-source toolkit for the Thunderbit Open API — CLI, MCP server, and Claude Code plugin.

This monorepo ships three packages, all backed by the Thunderbit Open API:

Package	Purpose	Audience
`@thunderbit/thunderbit-cli`	Command-line tool for distill / extract / batch	Developers, scripts, CI
`@thunderbit/mcp-server`	Model Context Protocol server (7 tools)	AI assistants — Claude Desktop, Cursor, Cline, Claude Code
`thunderbit` Claude Code plugin	Bundled MCP + 4 skills	Claude Code users

Get a free API key at thunderbit.com/open-api.

Quick Start

CLI

npm i -g @thunderbit/thunderbit-cli
export THUNDERBIT_API_KEY=tb_your_api_key_here
thunderbit distill https://example.com -f markdown

MCP Server (Claude Desktop / Cursor / Cline)

Edit your MCP client config:

{
  "mcpServers": {
    "thunderbit": {
      "command": "npx",
      "args": ["-y", "@thunderbit/mcp-server"],
      "env": { "THUNDERBIT_API_KEY": "tb_your_api_key_here" }
    }
  }
}

Claude Code Plugin

claude plugin marketplace add thunderbit-open/thunderbit-mcp-server
claude plugin add thunderbit
export THUNDERBIT_API_KEY=tb_your_api_key_here

What you can do

Convert any web page into clean, LLM-ready Markdown
Extract structured data from pages using JSON Schema
Get AI-suggested fields when you don't know what's on a page
Run batch jobs on up to 100 URLs at a time

Pricing

Distill — 1 credit. Extract — 20 credits. Suggest fields — 1 credit. Batch jobs scale per URL. Status polling is free.

Top up at thunderbit.com/billing.

Development

git clone https://github.com/thunderbit-open/thunderbit-mcp-server.git
cd thunderbit-mcp-server
# each package is independent
cd packages/mcp-server && npm install
cd packages/cli && npm install

thunderbit-web-scraping-mcp