io.github.thunderbit-com/thunderbit-mcp-server

Official

by thunderbit-com · JavaScript

AI-powered web scraping MCP. Distill pages to Markdown or extract structured data via JSON Schema.

The Thunderbit MCP server is an AI-powered web scraping implementation for the Model Context Protocol (MCP). It can distill web pages into Markdown or extract structured data using JSON Schema, and it is part of a monorepo that also includes a CLI and a Claude Code plugin.

🛠️ Key Features

AI-powered web scraping
Output options: Markdown distillation
Structured extraction via JSON Schema

🚀 Use Cases

Converting web page content into Markdown for downstream processing
Extracting fields from web content into structured JSON according to a schema

⚡ Developer Benefits

MCP integration for agent workflows
Schema-driven structured data extraction (JSON Schema)
Monorepo includes CLI and a Claude Code plugin (in addition to the MCP server)

⚠️ Limitations

Capabilities described are limited to web scraping, Markdown distillation, and JSON Schema-based structured data extraction.

Topics

ai-agentsclaudedata-extractionllmmarkdownmcpmcp-servermodel-context-protocolstructured-dataweb-scraping

README.md3 KBView on GitHub

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 app.thunderbit.com/console/api-keys.

Quick Start

CLI

bash

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:

json

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

Claude Code Plugin

bash

claude plugin marketplace add thunderbit-com/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 — free. Batch jobs scale per URL. Status polling is free.

Top up at app.thunderbit.com/console/billing.

Development

bash

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

API Reference

The full HTTP contract is documented in openapi.yaml (OpenAPI 3.1) — base URL https://openapi.thunderbit.com, Bearer auth with your THUNDERBIT_API_KEY.

License

Install

Configuration

Environment variables

THUNDERBIT_API_KEYrequiredsecret

Your Thunderbit API key (tb_...). Get one at https://app.thunderbit.com/console

Add to VS Code Add to Cursor

claude_desktop_config.json

json

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

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

Thunderbit MCP Server

Quick Start

CLI

MCP Server (Claude Desktop / Cursor / Cline)

Claude Code Plugin

What you can do

Pricing

Development

API Reference

License

Install

Configuration

Related servers